基础必需扩展
pdo_mysql：连接 MySQL/MariaDBmbstring：中文与多字节文本处理json：配置与接口数据编码session：后台登录与 CSRF 状态fileinfo：上传文件内容识别
SYSTEM REQUIREMENTS
在部署之前，先校准你的服务器坐标。
博客联盟导航采用传统 PHP + MySQL/MariaDB 架构。满足以下基础环境即可部署；授权版还需满足 OpenSSL、cURL、HTTPS 出站访问，以及用于 Logo、Favicon、分享图标和首页快照的指定目录写权限。
BASELINE / 01
基础运行环境
建议在正式部署前使用 PHP 信息页或主机面板逐项确认。最低可用环境不等同于推荐生产环境。
| 检查项目 | 推荐配置 | 说明 |
|---|---|---|
| PHP | PHP 8.1+ | 推荐 PHP 8.1 或更高版本。系统使用 PDO、Session、JSON、文件上传与常规字符串处理能力；较新 PHP 版本具备更好的兼容性与安全更新支持。 |
| 数据库 | MySQL 5.7.44+ 或 MariaDB 10.4+ | 使用 utf8mb4 字符集。授权版初始化 SQL 已兼容 MySQL 5.7.44+；新部署建议使用独立数据库与最小权限账号。 |
| Web 服务 | Nginx / Apache / 宝塔 / PHP-FPM | 需要将伪静态规则应用到站点；Apache 可使用包内 .htaccess，Nginx/宝塔可参考随包提供的规则文件。 |
| HTTPS | 生产环境必须启用 | 授权版需连接授权中心进行实时状态复核。生产环境应使用稳定的 HTTPS，并保证服务器可以访问授权中心域名。 |
| 目录权限 | 仅指定目录可写 | PHP 运行用户需可写 images/、uploads/、uploads/watermarks/、snapshots/、avatar/、logs/ 与 license-data/；请保留目录内保护规则，不要开放整个根目录写权限。 |
PHP INFORMATION / 02
PHP 扩展与函数清单
以下项目按照功能分组列出。没有明确标为“可选”的项目，建议在部署前逐项确认已启用。
授权版必需扩展
openssl：RSA 签名验签与授权令牌校验curl：连接授权中心 API 并实时复核hash：核心文件完整性指纹openssl_random_pseudo_bytes或安全随机源：令牌与加密过程
图片与快照能力
gd：常规图片尺寸与处理能力exif：可选，用于旋转信息处理dom：SVG 清理与结构解析imagick：可选；缺失时仅影响 SVG 水印栅格化能力
建议可用函数
curl_init、curl_exec：授权 API 与部分网络请求password_hash、password_verify：管理员密码安全存储random_bytes：CSRF、会话与安全随机值finfo_file：不信任原始文件后缀
出站网络能力
- 允许 PHP cURL 通过 HTTPS 访问授权中心
- DNS 可正常解析授权中心域名
- 服务器时间应准确，避免 TLS 握手与日志时间混乱
- 若主机限制外连，请提前向服务商确认
写入目录建议
images/：Logo 与 Favicon 上传uploads/、snapshots/：内容图片与快照avatar/：管理员与默认头像logs/、缓存目录：仅运行账号可写
关于 Memcached：当前系统的核心功能不依赖 Memcached 才能运行。若服务器环境已提供 Memcached，可将其作为后续缓存优化选项，用于降低热点查询或页面片段的重复计算；但首次部署、后台管理和授权校验不应依赖“有缓存才正确”的设计。
PRE-FLIGHT CHECK / 03
上线前的五分钟检查，能省下大量排错时间。
- 确认服务器 PHP 版本、
pdo_mysql、mbstring、fileinfo已启用；授权版额外确认openssl与curl。 - 确认数据库账号只拥有目标数据库权限，并可以创建与写入系统表。
- 确认伪静态规则生效，访问
/manual.html、/requirements.html、/install.html等页面可以正确打开。 - 确认 PHP 运行用户对需要写入的子目录有权限；保留
images/.htaccess与license-data/的访问保护，不要给站点根目录和核心源码无差别开放写入。
环境就绪后即可开始部署