当前位置: 首页> 最新文章列表> PHP实现百度文心一言API接口定时任务调度与执行示例

PHP实现百度文心一言API接口定时任务调度与执行示例

gitbox 2025-06-18

1. 了解百度文心一言API接口

百度文心一言API为开发者提供了一种轻松获取随机励志、哲理或其他类型句子的方法,非常适合用于博客、网站的底部名人名言或励志语句展示。

1.1. 接口使用方法

要使用该API接口,只需向以下URL发起GET请求即可:

https://v1.alapi.cn/api/hitokoto?format=json

接口返回的数据为JSON格式,示例如下:

{
    "status": true,
    "data": {
        "id": "7742",
        "hitokoto": "我在人生这个死胡同里已经走了很远,现在只能走下坡路了。",
        "type": "a",
        "from": "凉宫春日的消失",
        "from_who": "长门有希",
        "creator": "XShow",
        "creator_uid": 2886,
        "reviewer": 0,
        "uuid": "9cd04227-aa14-4df9-b8e0-6c0a5e4c6627",
        "created_at": "1616677997"
    }
}

1.2. 接口参数说明

API接口支持以下可选参数:

  • c:分类ID,1为动漫(Anime),2为漫画(Comic),3为游戏(Game),4为小说(Novel),5为原创(Original),6为互联网(Internet),7为其他(Other),默认为随机分类。
  • encode:字符编码,支持urlencode和base64,默认为不编码。
  • apikey:API密钥(可选)。

你可以在百度文心的API申请页面获取API密钥。

2. PHP代码实现

接下来是使用PHP代码调用该API接口,获取随机句子的示例:


<?php
// 获取随机句子
function getHitokoto($c = '1', $encode = 'urlencode', $apiKey = '') {
    $url = "https://v1.alapi.cn/api/hitokoto?c={$c}&encode={$encode}&apikey={$apiKey}";
    $data = file_get_contents($url);
    return json_decode($data, true);
}
<p>$hitokoto = getHitokoto();<br>
echo $hitokoto['data']['hitokoto'];<br>
?><br>

在这段代码中,我们定义了一个名为 getHitokoto 的函数,用来向API发送请求并获取数据。然后我们从返回的数据中提取并显示句子。

3. 定时任务调度与执行

3.1. 定时任务调度方案

接下来,我们将介绍如何使用PHP的定时任务调度器设置一个每分钟执行一次的任务。可以使用CRON表达式来控制任务的调度。

在Linux环境下,你可以通过以下命令编辑定时任务:

<span class="fun">crontab -e</span>

然后,编辑一个CRON表达式以便每分钟的第0秒执行:

<span class="fun">* * * * * curl https://example.com/hitokoto.php > /dev/null 2>&1</span>

在上述示例中,https://example.com/hitokoto.php 是我们实际的PHP文件地址。

3.2. 定时任务代码实现

下面是通过PHP实现定时任务的代码示例:


// 获取随机句子
function getHitokoto($c = '1', $encode = 'urlencode', $apiKey = '') {
    $url = "https://v1.alapi.cn/api/hitokoto?c={$c}&encode={$encode}&apikey={$apiKey}";
    $data = file_get_contents($url);
    return json_decode($data, true);
}
<p>// 将句子写入文件<br>
$hitokoto = getHitokoto();<br>
file_put_contents('/var/www/html/wordpress/hitokoto.txt', $hitokoto['data']['hitokoto']);<br>
echo "Done!";<br>
?><br>

在这段代码中,我们定义了函数 getHitokoto 来获取句子,并将其保存到 /var/www/html/wordpress/hitokoto.txt 文件中。你可以根据实际需要调整文件路径。

然后,可以通过CRON表达式将该脚本设置为每分钟自动执行。

4. 总结

通过本教程,你已经了解了如何使用PHP代码实现百度文心一言API接口,并通过定时任务调度器自动化获取句子。通过这种方式,你可以轻松地定期更新网站或应用中的励志语句,增强用户体验。