环境检查

部署子比主题前检查服务器、PHP 扩展、目录权限、日志、HTTPS、数据库和缓存组件。

先确认运行环境

子比主题运行在 WordPress 之上。部署前不要只看“能打开安装页”，还要确认 WordPress、PHP 扩展、数据库、伪静态、SSL、文件权限和缓存组件都能支撑后续登录、支付、商城、论坛、图片处理和邮件验证码。

推荐组合：

项目	建议
PHP	PHP 8.1 或 PHP 8.2
数据库	MySQL 5.7/8.0 或 MariaDB 10.6+
Web 服务	Nginx、Apache 或 OpenLiteSpeed
HTTPS	正式域名上线前配置 SSL
对象缓存	Redis 可选，但建议生产站开启；启用顺序见 Redis 与 OPcache 性能优化
站点目录	WordPress 根目录应可被 PHP 进程读写

如果使用宝塔，尽量通过面板安装同一套运行环境，不要一部分由面板管理、一部分手工散装。混用会让 PHP 版本、扩展目录、站点配置和服务重启变得难排查。

常见必查扩展：

扩展	影响
`mysqli` / `pdo_mysql`	WordPress 数据库连接
`curl`	授权、远程接口、支付接口、第三方登录
`mbstring`	中文字符串、加密校验、部分插件兼容
`fileinfo`	上传文件 MIME 识别
`gd` 或 `imagick`	缩略图、头像、图片处理
`openssl`	HTTPS 请求、SMTP 加密、支付签名
`zip`	主题/插件安装更新、压缩包处理
`intl`	字符、日期、格式化能力
`redis`	对象缓存，需要服务器同时安装 Redis，且 WordPress 需要对象缓存插件
`opcache`	PHP 性能优化，更新主题或插件后可能需要清理 OPcache

宝塔里通常在 软件商店 -> PHP -> 安装扩展 检查；无面板环境可以用：

php -m
php -i | grep extension_dir

如果页面提示缺少 mbstring，先确认当前站点实际使用的 PHP 版本。服务器可能同时安装多个 PHP，命令行 php -m 看到的扩展不一定就是站点使用的 PHP-FPM 扩展。

安装完成后先做这几件事：

这套检查能提前发现伪静态、权限、SMTP、缓存和 PHP 扩展问题。

WordPress 至少需要写入这些目录：

wp-content/uploads
wp-content/cache
wp-content/upgrade
wp-content/themes
wp-content/plugins

上线后常见权限问题：

现象	可能原因
媒体上传失败	`uploads` 不可写、`fileinfo` 缺失、Nginx 上传大小限制
主题更新失败	`themes` 或 `upgrade` 不可写
缓存写不进去	`cache` 目录不可写或 PHP 用户不一致
安装插件失败	PHP 进程没有写入 `plugins` 的权限
日志写不出来	站点目录或 `wp-content` 权限不正确

权限要以实际 PHP-FPM 运行用户为准。宝塔常见是 www，但不同系统和容器环境可能不同。

部署后先知道日志在哪里，比出问题后临时找要稳很多。

日志	用途
WordPress `wp-content/debug.log`	PHP 警告、致命错误、主题插件错误
Nginx/Apache access log	请求是否到达源站、状态码
Nginx/Apache error log	伪静态、权限、FastCGI 错误
PHP-FPM error log	PHP 崩溃、扩展错误、超时
MySQL error log	数据库连接、权限、表损坏
Redis log	对象缓存连接问题

临时开启 WordPress 调试：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

排查完成后可以关闭前台显示，避免把错误直接展示给用户。

上线前确认：

媒体上传、主题安装和大文件导入常受这些参数影响：

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
max_input_vars = 5000

Nginx 还要检查：

client_max_body_size 64m;

后台保存设置失败、表单字段很多时，重点看 max_input_vars。媒体上传直接 413 时，重点看 Web 服务上传大小限制。

建议按这个顺序验收：

不要在源站还没跑通时直接开启强缓存、JS 合并压缩、WAF 和 CDN。先让基础流程稳定，再逐层加速。

本页吸收了子比官网宝塔搭建、PHP 扩展、常见问题等公开教程，并结合 WordPress 与子比主题常见运行链路整理为上线前环境检查清单。