进阶 yourls.org 2026-11-19 17:39:56 · 3 阅读
第27章 特殊文件
特殊文件
YOURLS 支持多种特殊用户文件,以便进一步自定义部分内部行为。这些文件均从 user/ 目录加载。
页面
页面是位于 user/pages/ 目录下的自定义文件,其显示方式与短链接类似。详情见“页面”章节。
自定义数据库错误页
当数据库无法访问或 YOURLS 配置出错时,系统会显示默认的 YOURLS 错误页。你可以用位于 user/db_error.php 的自定义文件替换该错误页。
自定义维护页
在将 YOURLS 升级到新版本(干得漂亮!)时,站点可能会短暂无法访问,此时会显示默认的落地页。你可以用位于 user/maintenance.php 的自定义版本替换该页面。
自定义 Favicon
默认情况下,YOURLS 会显示一个很小的 YOURLS Favicon。你可以轻松地通过 user/favicon.(jpg|gif|png|ico|svg) 文件显示自定义的 Favicon。
自定义“常驻插件”
如果存在 user/cache.php 文件,YOURLS 会在启动过程的早期、在加载常规激活插件之前,始终包含该文件。此特殊文件不会出现在插件列表中,也无法在管理后台中激活或停用。若要停用它,请手动删除(或重命名)该文件。 注:“Cache”是“Custom Additional Code for Hazardous Extensions”的缩写。
自定义数据库层
开箱即用的 YOURLS 使用 PDO 与 MySQL 服务器交互。如果你是有经验的开发人员并想替换核心数据库引擎,可以在 user/db.php 中实现自己的库。