温馨提示×

centos php故障怎么排查

小樊
39
2025-11-21 19:14:07
栏目: 编程语言

CentOS 上 PHP 故障排查步骤

一 快速定位与日志优先

  • 确认运行形态:是 PHP-FPM + Nginx/Apache,还是 mod_php + Apache
  • 实时查看错误日志:
    • PHP-FPM:tail -f /var/log/php-fpm/error.log
    • Apache:tail -f /var/log/httpd/error_log
    • Nginx:tail -f /var/log/nginx/error.log
  • 查看服务状态与启动失败原因:
    • systemctl status php-fpm 或 journalctl -u php-fpm
    • systemctl status httpd 或 journalctl -u httpd
  • 若页面空白或仅显示 5xx,优先检查上述日志中的 Fatal/Parse/Permission/Connection 等关键字。

二 常见故障与处理对照表

症状 优先检查 快速修复
502/504、页面空白 php-fpm 是否存活、监听地址与 Web 一致、进程/连接数是否耗尽 systemctl restart php-fpm;检查 pm.max_children、listen 与 upstream 配置
500 内部错误 PHP 错误日志、语法/依赖/权限 修复语法、安装缺失扩展(如 yum install php-mysqli)、修正目录权限
数据库连接失败 DB 主机/端口/账号/密码、网络连通、SELinux/防火墙 校验配置、测试 mysql -h host -P port -u user -p、开放防火墙、必要时 setsebool 放开 httpd 访问 DB
文件上传/写入失败 目录属主与权限、open_basedir、磁盘空间 chown/chmod 正确属主与权限、检查 open_basedir、df -h
类/函数未定义 扩展未安装或版本不匹配 yum install 对应扩展(如 php-gd、php-mbstring、php-curl 等)
页面只显示代码或下载 PHP 未被解析 确认 Nginx fastcgi_pass 指向 php-fpm;Apache 确认已加载 libphp 模块与 .php 处理规则

三 配置与权限检查要点

  • 开启并记录错误:在 php.ini 中设置
    • error_reporting = E_ALL
    • display_errors = Off(生产环境建议关闭,避免信息泄露)
    • log_errors = On
    • error_log = /var/log/php-fpm/error.log(路径需与 php-fpm 池配置一致)
  • 目录与文件权限:确保运行 php-fpm 的用户(常见为 apachenginx)对代码目录、日志目录、会话/缓存目录具备读写权限。
  • SELinux:若访问数据库或文件被拒,先临时排查可 setenforce 0;定位后使用 setsebool/httpd_can_network_connect_db 等策略精确放行,避免长期关闭 SELinux。
  • 修改配置后重启生效:systemctl restart php-fpm 或 systemctl restart httpd

四 最小复现与验证

  • 命令行快速验证:
    • php -v(确认解释器可用)
    • php -l /path/file.php(语法检查)
    • php -m(确认扩展已加载)
  • Web 侧最小脚本验证(info.php):
    • 访问该文件应返回 PHP 信息页;若仍异常,回到日志定位。
  • 连接类问题验证:
    • 在服务器上执行 mysql -h 数据库地址 -P 端口 -u 用户 -p 测试连通与凭据。

五 高频场景速解

  • 缺少扩展(如提示未定义 mysqli):执行 yum install php-mysqli 并重启 php-fpm。
  • 内存不足(Fatal error: Allowed memory size):在 php.ini 调大 memory_limit(如 128M/256M),重启服务。
  • 修改配置/代码后仍未生效:确认修改的是正确的 php.ini(可通过 phpinfo() 查看 Loaded Configuration File),并重启 php-fpmhttpd
  • 日志轮转与清理:使用 logrotate 管理 /var/log/php-fpm/ 等日志,避免磁盘被占满导致写入失败。

0