centos下php错误怎么排查

CentOS 下 PHP 错误排查步骤

一定位日志位置

先确认 PHP 运行方式（PHP-FPM 或 mod_php/Apache），再到对应位置查看日志。常见路径如下：
- PHP-FPM：查看 /var/log/php-fpm/error.log（FPM 进程自身错误、脚本异常等）。
- Apache：查看 /var/log/httpd/error_log（Apache 启动/连接错误、PHP 解析错误等）。
- Nginx：查看 /var/log/nginx/error.log（FastCGI 转发、权限/上游错误等）。
不确定日志路径时，用命令定位配置文件并查看 error_log 项：
- 查找配置文件：php --ini
- 在 php.ini 或 /etc/php.d/*.ini 中搜索：error_log
也可通过 systemd 查看服务日志：
- PHP-FPM：journalctl -u php-fpm -f
- Apache：journalctl -u httpd -f
- Nginx：journalctl -u nginx -f
线上环境建议开启文件日志并关闭浏览器显示：log_errors = On、display_errors = Off，将错误写入到明确的 error_log 文件。

二开启与验证错误报告

临时在入口脚本或 Web 环境开启（便于立即看到错误）：
- ini_set(‘display_errors’, 1);
- ini_set(‘display_startup_errors’, 1);
- error_reporting(E_ALL);
持久化到配置文件（推荐）：编辑 php.ini 或相应子配置（如 /etc/php.d/zz-debug.ini）
- 开发环境示例：
  - error_reporting = E_ALL
  - display_errors = On
  - display_startup_errors = On
  - log_errors = On
  - error_log = /var/log/php_errors.log
- 生产环境建议：display_errors = Off，仅保留 log_errors = On 与明确的 error_log。
修改后重启服务使配置生效：
- PHP-FPM：systemctl restart php-fpm
- Apache：systemctl restart httpd
- Nginx：systemctl restart nginx
验证是否生效：
- 执行 php -v 或访问一个肯定会触发错误的脚本，确认日志有新条目。

三常见错误与快速处理

语法错误：PHP 启动或访问即报错，日志会给出文件名与行号。处理：修正语法、检查短标签与编码。
扩展缺失：如提示 Class ‘mysqli’ not found，安装对应扩展（示例）：sudo yum install php-mysqli，然后重启服务。
权限问题：日志含 Permission denied。处理：确认 PHP 进程用户对文件/目录有读/写/执行权限，必要时调整 owner/group 与 mode。
数据库连接失败：检查 主机/端口/用户/密码 与数据库服务状态，确认防火墙与 SELinux 策略允许访问。
内存不足：日志含 Allowed memory size exhausted。处理：在 php.ini 提升 memory_limit（如 128M/256M），再重启服务。
配置错误：修改 php.ini 或 FPM/Web 配置后未生效，多为未重启或包含路径错误；重启并检查包含目录 /etc/php.d/ 是否被主配置加载。

四进阶调试与工具

五排查清单与命令速查

快速命令清单：
- 查看日志：tail -f /var/log/php-fpm/error.log
- 查找关键字：grep -i “error” /var/log/php-fpm/error.log
- 定位配置：php --ini
- 服务日志：journalctl -u php-fpm -f
- 重启服务：systemctl restart php-fpm / httpd / nginx
配置核对清单：
- error_reporting=E_ALL
- display_errors（开发：On；生产：Off）
- log_errors=On 且 error_log 指向可写路径
- 修改后务必重启相关服务
安全提示：
- 生产环境不要开启 display_errors，避免泄露敏感信息；确保 error_log 文件权限最小化且定期轮转。

最新问答