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. 结果输出：成功输出内容，失败显示 “获取引用失败：[错误信息]”。
适用场景与使用说明
适用场景
* 网站动态副标题；
* 博客/资讯随机引用；
* 产品特性/服务优势动态展示。
使用要求
1. 文件格式：description.txt每行 1 条有效内容（空行自动过滤）；
2. 路径配置：$quoteFile路径需与文件实际位置匹配；
3. 权限配置：PHP 进程需description.txt读取权限（建议644）。
调用方式
displayRandomQuote();
下载地址：
本文链接地址：https://chencong.blog/Display-Random-Quote-Typecho-sui-ji-xian-shi-wang-zhan-fu-biao-ti-han-shu.html版权声明：除非另有明确标注，本文章《Display Random Quote - Typecho 随机显示网站副标题函数》系 蔥籽 独立创作之成果。任何对该文章的转载行为，均需以链接形式准确标明本文原始地址，以确保原创权益得到充分尊重与维护。本文章遵循《署名-非商业性使用-相同方式共享4.0国际(CC BY-NC-ND 4.0)》许可协议进行授权，望各相关方严格遵守该协议条款，共同营造规范、有序的知识传播与共享环境。