Ubuntu PHP如何解决错误 - 问答

Ubuntu 上排查与修复 PHP 错误的实用流程

一、快速定位错误的通用流程

确认 PHP 是否已安装与版本：php -v。
找到并查看错误日志：
- Apache：/var/log/apache2/error.log
- Nginx：/var/log/nginx/error.log
- PHP-FPM：/var/log/php-fpm.log 或 /var/log/php7.x-fpm.log（将 7.x 替换为你的版本）
- 实时查看：例如 sudo tail -f /var/log/apache2/error.log。
检查 PHP 配置与加载的 ini 文件：php --ini。
修改配置后务必重启服务：
- Apache：sudo systemctl restart apache2
- Nginx：sudo systemctl restart nginx
- PHP-FPM：sudo systemctl restart php7.x-fpm
检查文件权限与属主，确保 Web 服务用户可访问代码目录（如使用 chown/chmod 调整）。

二、开发环境开启错误显示与调试

修改对应 SAPI 的 php.ini：
- CLI：/etc/php/7.x/cli/php.ini
- Apache：/etc/php/7.x/apache2/php.ini
关键配置（仅开发环境）：
- display_errors = On
- error_reporting = E_ALL
安装并配置 Xdebug（可选，性能分析/断点调试）：
- 安装：sudo apt-get install php-xdebug
- 追加到 php.ini：
```
[Xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_port=9003
```
重启服务后验证：sudo systemctl restart apache2 或 sudo systemctl restart php7.x-fpm。
注意：调试模式会影响性能，生产环境请关闭 display_errors 并避免启用 Xdebug。

三、常见错误与对应修复

502 Bad Gateway（Nginx + PHP-FPM）：
- 检查服务状态：sudo systemctl status php7.x-fpm；未运行则 sudo systemctl start php7.x-fpm 并设置开机自启 sudo systemctl enable php7.x-fpm。
- 核对 fastcgi_pass 地址是否匹配 PHP-FPM 监听，例如：
  - Unix 套接字：fastcgi_pass unix:/run/php/php7.x-fpm.sock;
  - TCP 端口：fastcgi_pass 127.0.0.1:9000;
- 重启 Nginx：sudo systemctl restart nginx。
PHP-FPM 或 .sock 权限不足：
- 检查套接字权限（示例）：sudo chmod 0666 /run/php/php7.x-fpm.sock；同时确保 www-data（或你的 Web 服务用户）对 /run/php/ 及项目目录具备访问权限。
缺少扩展导致功能不可用：
- 安装所需扩展（按需）：sudo apt install php-mysql php-gd php-curl …；安装后重启 Apache 或 PHP-FPM。
配置或重写规则错误：
- 核对 Nginx root 路径是否正确；
- 确保存在正确的重写规则，例如：
```
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
```
配置文件语法/路径错误：
- 使用 php --ini 确认加载的 php.ini；
- 修改后重启服务，若仍异常，回滚最近变更并逐项排查。

四、高效排查的小技巧

0 赞

0 踩