Display Random Quote - Typecho 随机显示网站副标题函数
Display Random Quote For Typecho 介绍
本代码段含 2 个核心 PHP 函数，实现指定文件内有效内容的随机读取与展示，适配classic-22主题调用，支持网站副标题、随机引用等场景，具备全链路文件校验与错误处理，保障功能稳定。
核心函数：getRandomQuote
负责文件读取、内容筛选及随机抽取，支持错误信息返回，便于问题定位。
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
$file_path | 字符串 | 必传，内容文件路径（如description.txt） |
&$error | 字符串引用 | 可选，接收错误信息（文件不存在 / 无权限等），默认空字符串 |
核心逻辑
5 层校验确保读取有效性：
1. 存在性校验：file_exists()验证文件存在；
2. 可读性校验：is_readable()确认 PHP 读取权限；
3. 内容读取：file()结合FILE_IGNORE_NEW_LINES（去换行）、FILE_SKIP_EMPTY_LINES（滤空行）读取；
4. 结果校验：判断file()读取成功；
5. 有效性校验：确认内容数组非空。
校验通过则array_rand()返回随机内容，失败则写入$error并返回false。
展示函数：displayRandomQuote
上层封装函数，无额外参数，实现路径指定、核心调用与结果输出。
核心逻辑
1. 路径指定：dirname(__DIR__, 2)定位classic-22主题的description.txt；
2. 函数调用：初始化$errorInfo，调用getRandomQuote()；
3. 结果输出：成功输出内容，失败显示 “获取引用失败：[错误信息]”。