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接口，並通過定時任務調度器自動化獲取句子。通過這種方式，你可以輕鬆地定期更新網站或應用中的勵志語句，增強用戶體驗。