一言语录API怎么用？新手也能快速搭建吗

前几天跟朋友聊起给博客加点随机温暖的文字，恰好提到“一言语录 API”。听起来像是黑科技，其实只是一段可以返回短句的接口。新手想动手，最怕的不是代码本身，而是找不到入口和一步到位的示例。

一言语录 API 的核心概念

它的本质就是把一行行语录存进文本文件，服务器每收到一次请求，就随机挑一行返回。返回格式可以是纯文本、JSON，甚至是 JavaScript 包装的函数，随调用方需求而变。

最小化搭建流程

把语录文件放在项目根目录的 yiyan.txt，新建一个 yiyan.php，把下面的代码粘进去，服务器有 PHP 环境就能直接跑。

<?php
$path = __DIR__ . '/yiyan.txt';
$lines = file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
$rand = $lines[array_rand($lines)];
header('Content-Type: text/plain; charset=utf-8');
echo $rand;
?>

想要 JSON，只需要把 header('Content-Type: application/json; charset=utf-8'); 换成对应的，然后 echo json_encode(['msg'=>$rand]); 就行。这样一行代码，就把“随机语录”变成了可供前端 AJAX 调用的接口。

调试小技巧

本地测试时，直接在浏览器敲 http://localhost/yiyan.php，看到的就是一条随机句子。若想快速验证 JSON，打开开发者工具的网络面板，刷新页面，看看返回体的结构。遇到乱码？检查文件本身是 UTF‑8 编码，或者在 PHP 里加一行 mb_convert_encoding 把 UTF‑8 转成 GBK。

“生活像一杯咖啡，苦涩里藏着甜。”——随手一抓的句子，也许正是今天的灵感。

把这套小模块嵌进自己的站点，哪怕只是一行代码，也能让页面瞬间多了点人情味。要不要尝试把它做成公共服务，让更多人来喝这杯“语录咖啡”？