ThinkPHP 在 CentOS 的排查思路总览
- 先定位错误发生在哪一层：Web 服务器层（Nginx/Apache）、PHP-FPM 层、ThinkPHP 应用层还是数据库层。
- 优先查看各组件的错误日志，必要时临时开启更详细的应用报错，再复现问题，最后回滚安全配置。
- 以下按“定位—查看—修复”的顺序给出要点与命令。
一、快速定位与日志查看
- 查看 PHP-FPM 日志（最常见）：
- 路径通常为：/var/log/php-fpm/error.log（若未配置，可在 php.ini 的 error_log 指定）。
- 实时跟踪：tail -f /var/log/php-fpm/error.log
- 也可用 systemd：journalctl -u php-fpm -f
- 查看 Nginx 日志：
- 访问日志：/var/log/nginx/access.log；错误日志：/var/log/nginx/error.log
- 实时跟踪：tail -f /var/log/nginx/error.log
- 查看 系统层日志：
- 系统消息：/var/log/messages；安全认证：/var/log/secure
- 统一查看：journalctl -xe
- 查看 数据库（MySQL/MariaDB） 错误：
- 常见路径：/var/log/mysqld.log 或 /var/lib/mysql/*.err
- 若使用 Apache：
- 错误日志：/var/log/httpd/error_log；访问日志：/var/log/httpd/access_log
- 小技巧：用 grep 过滤关键字（如“PHP Fatal error”“Permission denied”“SQLSTATE”）能快速缩小范围。
二、常见错误与修复要点
- 500 或白屏，页面无提示
- 临时在入口或公共引导处开启 ThinkPHP 的调试模式（仅内网/测试环境），观察具体报错堆栈。
- 同步打开 PHP 错误日志 与 display_errors（生产环境建议仅记录日志，不显示到浏览器）。
- open_basedir 限制导致文件不可访问
- 现象：Warning: require(): open_basedir restriction in effect…
- 处理：在 Nginx fastcgi_params/fastcgi.conf 的 PHP_ADMIN_VALUE 中加入项目根目录，例如：
fastcgi_param PHP_ADMIN_VALUE “open_basedir=/mnt/wwwroot:/tmp:/proc/”;
或注释掉该限制；重启 php-fpm 与 Nginx。
- 函数被禁用（如 scandir、exec 等）
- 现象：Fatal error: Call to undefined function scandir() …
- 处理：编辑 php.ini 的 disable_functions，移除不必要的禁用项（如 scandir），重启 php-fpm。
- URL 重写/路由不生效（访问变成 404）
- 处理：在 Nginx 配置中添加对 .php 的 FastCGI 转发，并加入 PATH_INFO/重写规则，例如：
location ~ .php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location / { try_files $uri $uri/ /index.php?$query_string; }
重启 Nginx。
- 数据库连接失败
- 核对 application/database.php 中的 hostname、database、username、password、hostport；
- 确认 MySQL 服务运行、用户权限与远程访问已放行；
- 若走 3306，在 firewalld/iptables 中放行端口或临时关闭防火墙验证。
- 扩展缺失（如 pdo_mysql、mbstring、gd、zip 等）
- 现象：Class ‘PDO’ not found / Call to undefined function mb_strlen() …
- 处理：安装对应扩展（如 yum install php-pdo_mysql php-mbstring php-gd php-zip），并在 php.ini 中确保 extension= 已启用；重启 php-fpm。
- Composer/依赖或版本不兼容
- 现象：Class ‘think.… not found’、方法不存在等；
- 处理：核对 ThinkPHP 与扩展库/组件的版本兼容矩阵，必要时升级框架或组件版本（如 ThinkPHP 6/8 与 ThinkLibrary 的对应关系）。
三、最小可用的 Nginx + PHP-FPM 配置示例
- PHP-FPM（/etc/php-fpm.d/www.conf 片段）
- listen = 127.0.0.1:9000
- user = nginx；group = nginx
- pm = dynamic；pm.max_children = 50；pm.start_servers = 5；pm.min_spare_servers = 5；pm.max_spare_servers = 35
- Nginx（server 片段）
- root /var/www/html/public；index index.php index.html
- location ~ .php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
- location / { try_files $uri $uri/ /index.php?$query_string; }
- 重载服务：systemctl restart php-fpm nginx
四、高效排查的实用命令清单
- 服务状态与重载
- systemctl status php-fpm nginx mariadb
- systemctl restart php-fpm nginx
- 实时看日志
- tail -f /var/log/php-fpm/error.log
- tail -f /var/log/nginx/error.log
- journalctl -u php-fpm -f
- 网络与端口
- ss -lntp | grep ‘:9000|:3306’
- firewall-cmd --list-ports
- PHP 环境自检
- php -v；php -m | grep -E ‘pdo_mysql|mbstring|gd|zip’
- php --ini（确认加载的 php.ini 与扩展配置）
- 数据库连通性
- mysql -h127.0.0.1 -uroot -p -e “select 1”
五、安全与回滚建议
- 生产环境建议：
- 关闭 display_errors，仅开启 log_errors 并写入到受限目录；
- 谨慎调整 open_basedir，遵循最小权限原则；
- 不要长期保留 disable_functions 的宽泛禁用，按需最小化；
- 变更前备份配置与数据库，变更后及时恢复为安全基线。