ThinkPHP 在 CentOS 上的错误排查方法
一 快速定位路径与日志
- 查看 PHP 与扩展是否就绪：
- 检查版本：php -v
- 检查扩展：php -m | grep -E ‘pdo_mysql|mbstring|gd|xml|zip’
- 定位 PHP-FPM 日志（FPM 模式常用）：
- 路径通常为：/var/log/php-fpm/（常见文件：error.log、www.log）
- 实时查看：tail -f /var/log/php-fpm/www.log 或 tail -f /var/log/php-fpm/error.log
- 定位 Web 服务器错误日志：
- Nginx：/var/log/nginx/error.log
- Apache：/var/log/httpd/error_log
- 定位系统级日志（服务启动、权限类问题）：
- journalctl -u php-fpm、journalctl -u nginx、journalctl -u mysqld
- 关键文件：/var/log/messages、/var/log/secure
- 定位 ThinkPHP 应用日志：
- 默认：runtime/log/（按日期/模块分文件）
- 若采用 PHP-FPM，确认 php.ini 的错误日志配置已开启并指向有效路径（如：error_log = /var/log/php-fpm/error.log），修改后重启 php-fpm 生效。
二 常见症状与对应排查
- 500 或空白页且无输出
- 打开错误显示便于定位（仅限内网/调试）：在入口或公共引导处临时设置 ini_set(‘display_errors’, ‘On’); error_reporting(E_ALL);
- 查看 PHP-FPM 日志与 Web 服务器错误日志的首条报错；检查 runtime 目录可写（含子目录）。
- 数据库连接失败
- 检查数据库服务：systemctl status mysqld/mariadb；必要时 systemctl start mysqld/mariadb
- 校验配置：application/database.php 中的 host、port、database、username、password
- 测试连通：命令行 mysql -h 主机 -P 端口 -u 用户 -p
- 远程访问与防火墙：授权远程用户并开放 3306 端口（如 firewalld/iptables）
- 类/函数未找到或扩展缺失
- 典型如：Class ‘PDO’ not found、Call to undefined function mb_strlen()
- 安装扩展（示例）：yum install php-pdo php-mysql php-mbstring php-gd php-xml php-zip
- 确认扩展已启用并重启 php-fpm
- open_basedir 限制导致文件包含失败
- 现象：Warning: require(): open_basedir restriction in effect
- 处理：在 php-fpm 配置或 Nginx fastcgi_params 中为项目根目录加入 open_basedir（或注释该限制）
- 被禁用函数导致功能异常
- 现象：如 scandir() has been disabled for security reasons
- 处理：编辑 php.ini 的 disable_functions，移除不必要的禁用项并重启 php-fpm
- URL 重写/路由 404
- 确认入口为 public/index.php，在 Nginx 配置中添加 try_files 或 rewrite 规则将请求转发到入口文件。
三 最小闭环验证步骤
- 环境自检
- php -v 与 php -m 确认版本与扩展；必要时安装缺失扩展并重启 php-fpm
- 服务状态
- systemctl status php-fpm nginx mysqld/mariadb；未运行则启动并设为开机自启
- 连通性验证
- 数据库：命令行 mysql -h 主机 -P 端口 -u 用户 -p 可登录
- 端口与防火墙：确认 80/443/3306 已开放（云服务器安全组与系统防火墙均需放行）
- 日志核验
- 实时跟踪：tail -f /var/log/php-fpm/www.log /var/log/nginx/error.log /var/log/messages
- 最小页面测试
- 临时输出 phpinfo(); 或简单路由返回，确认框架与 Web/PHP 链路正常。
四 配置与权限要点
- PHP-FPM 与运行用户
- 建议 listen = 127.0.0.1:9000，设置 user/group = nginx（与 Nginx 一致），调整 pm 参数以匹配负载
- Nginx 站点配置
- 确保 root 指向项目 public，SCRIPT_FILENAME $document_root$fastcgi_script_name
- 路由兼容：使用 try_files $uri $uri/ /index.php?s=$uri&$args; 或等价 rewrite 规则
- 目录权限
- runtime、public/uploads 等需对 PHP-FPM 运行用户可写
- 错误日志集中
- 在 php.ini 中开启 log_errors 并指定 error_log；Web 服务器错误日志保持开启，便于交叉定位。
