WordPress集成一言（Hitokoto）API经典语句功能

很早前就在很多博客网站看到了这个每日一句、随机语录等经典语句功能，其实我是非常想要加上这个功能的（功能控~~），但出于以下的考虑，就一直没开启集成工作：

增加这个功能，就意味着要一直请求一言，这个就可能会影响网站的加载速度及性能了；另外，大家也都能感觉到很多网站都由于各种原因，要么不稳定，要么就干脆弃站了...
在我这主题，找不到满意的位置放置这这句话~（毕竟拙于设计...）

现在发现，第一点完全是想多了，这个耗不了多少性能，一言 API 的速度还是非常棒的，对加载速度的影响基本可以忽略；另外，一言应该不会这么轻易放弃吧；再退一步讲，就算她放弃了，也还是有很多其他备用 API 的，或者启用张戈给的本地解决方案，实在不行，就去掉这个功能咯，也没啥大不了~

对于第二点，我也是比较纠结的，放在滚动公告栏里或者放在文章末尾，我都觉得不是很得力。直到前阵子偶然在 devoted2 那看到了一个我非常喜欢的方式：评论框里。

点击展开一言介绍

一、LWL12 的一言纯净版

在这里，先介绍一下 LWL12 的这个非常纯净的第三方 API 版本，仅显示一句话内容...，速度给力，使用方法也真的是简单粗暴~直接将下面的代码放在自己主题想加载的位置就可以完事了...

<script type="text/javascript" src="https://api.lwl12.com/hitokoto/main/get?encode=js&charset=utf-8"></script>
<div id="lwlhitokoto"><script>lwlhitokoto()</script></div>

二、自建 API 版本

自建版的好处就是，api 及经典语句内容完全由自己管控；当然，缺点也很明显了，木有一言的语句多~~

1、创建 API

好了，直接开动了，首先，新建一个 index.php 文件，文件内容如下：

<?php
/**
* Wordpress集成一言（Hitokoto）API经典语句功能 - 龙笑天下
* https://www.ilxtx.com/integrating-yiyan-hitokoto-to-wordpress.html
*/
// 获取句子文件的绝对路径
// 如果你介意别人可能会拖走这个文本，可以把文件名自定义一下，或者通过Nginx禁止拉取也行。
$path = dirname(__FILE__);
$file = file($path."/hitokoto.txt");
# 随机读取一行
$arr = mt_rand( 0, count( $file ) - 1 );
$content = trim($file[$arr]);
# 编码判断，用于输出相应的响应头部编码
if (isset($_GET['charset']) && !emptyempty($_GET['charset'])) {
$charset = $_GET['charset'];
if (strcasecmp($charset,"gbk") == 0 ) {
$content = mb_convert_encoding($content,'gbk', 'utf-8');
}
} else {
$charset = 'utf-8';
}
header("Content-Type: text/html; charset=$charset");
# 格式化判断，输出js或纯文本
if ($_GET['format'] === 'js') {
echo "function hitokoto(){document.write('" . $content ."');}";
} else {
echo $content;
}

然后新建一个名为 hitokoto.txt 的文本文档（在里面每行存入一句经典语句哦~），将 hitokoto.txt 文本文档与上面的 index.php 文件同时放入网站根目录下名为 hitokoto 的文件夹中，当然这里文本文档及文件夹的名称可以更改为其他任意名字，但是要将代码中对应调用部分也做更改。

现在，浏览器访问 http://你的域名/hitokoto/ 就可以看到输出内容了。

2、使用 API

部署方法和上面那个基本一样：在主题代码中你需要显示语录文字的地方添加上如下代码既可以实现对 hitokoto.txt 中文字语录的调用。

<script type="text/javascript" src="https://你的域名/hitokoto/?format=js&charset=utf-8"></script>
<div id="hitokoto"><script>hitokoto()</script></div>

不过，输出的样式也和上面版本一样可能会比较丑，如果你懂 CSS的话可以自己再美化美化。

三、一言官方 AP I版

首先，在主题 functions.php 中加入以下代码：

/**
* Wordpress集成一言（Hitokoto）API经典语句功能 - 龙笑天下
* https://www.ilxtx.com/integrating-yiyan-hitokoto-to-wordpress.html
* 2017-12-25 23:14:02
*/
function LxtxgetHitokoto(){
$url = 'https://sslapi.hitokoto.cn/'; // http://api.hitokoto.cn/
$data = array(
// 'c'=>'d', // 限定内容类型
'encode'=>'json'
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 6);
$response = curl_exec($ch);
if($error=curl_error($ch)){
return '欢迎来到龙笑天下~'; // 如果6s内，一言API调用失败则输出这个默认句子~
}
curl_close($ch);
$array_data = json_decode($response,true);
$lxtx_content = $array_data['hitokoto'].'----《'.$array_data['from'].'》'; // 输出格式：经典语句----《语句出处》
return $lxtx_content;
}

使用方法也非常简单粗暴，在主题文件中想输出语录的地方加入以下输出代码即可，当然，你也可以跟龙笑天下一样放在文章的评论框哦~：

<?php echo LxtxgetHitokoto(); ?>

另外，再附上一言API的返回参数：

id：本条一言的id，可以链接到 https://hitokoto.cn?id=[id] 查看这个一言的完整信息。
hitokoto：一言正文，编码方式 usc2，使用 utf-8。
type：类型，跟请求参数相同。a: Anime - 动画；b: Comic – 漫画；c: Game – 游戏；d: Novel – 小说；e: Myself – 原创；f: Internet – 来自网络；g: Other – 其他
from：一言的出处。
creator：添加者。
cearted_at：添加时间。

友情提示：大家可以根据返回参数自行修改上面的 LxtxgetHitokoto()函数中的第26行，随意修改为自己想要的格式哦；另外，本文教程不局限于 WordPress ~~