Ubuntu PHP错误怎么快速解决

Ubuntu PHP错误快速排查与修复清单

一、最快定位路径

• 先看错误日志，定位是 PHP 语法/扩展、Web 服务器配置 还是 代码 问题：
  • 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
  • 实时跟踪：执行 sudo tail -f /var/log/apache2/error.log 或 sudo tail -f /var/log/nginx/error.log
• 确认 PHP 版本与 SAPI：php -v，以及配置文件位置：php --ini
• 修改配置或安装扩展后，务必重启服务使生效：
  • Apache：sudo systemctl restart apache2
  • Nginx：sudo systemctl restart nginx
  • PHP-FPM：sudo systemctl restart php7.x-fpm（将 7.x 替换为你的实际版本）

二、常见错误与一键修复

• 502 Bad Gateway（Nginx + PHP-FPM）
  • 检查并启动 FPM：sudo systemctl status php7.x-fpm；未运行则 sudo systemctl start php7.x-fpm && sudo systemctl enable php7.x-fpm
  • 核对 Nginx 的 fastcgi_pass 与 FPM 监听一致，例如：fastcgi_pass unix:/run/php/php7.0-fpm.sock;（或对应的端口）
  • 重启 Nginx：sudo systemctl restart nginx
• 权限被拒绝或访问异常
  • Web 目录属主与权限：sudo chown -R www-data:www-data /path/to/php/files，sudo chmod -R 755 /path/to/php/files
• 缺少扩展（如 mbstring、gd、mysql）
  • 安装所需扩展：sudo apt-get install php-mbstring php-gd php-mysql
  • 重启对应服务（Apache/Nginx/PHP-FPM）
• 配置文件错误
  • 使用 php --ini 找到加载的 php.ini，修正语法或冲突项后重启服务
• 开发环境需要看到详细错误
  • 在对应 SAPI 的 php.ini 中开启：display_errors = On、error_reporting = E_ALL
  • 注意：生产环境请关闭 display_errors，避免泄露敏感信息

三、开发环境开启调试

• 安装调试器：sudo apt-get install php-xdebug
• 在 php.ini 增加（路径按你的 PHP 版本调整，如 /etc/php/7.4/apache2/php.ini 或 CLI 对应目录）：

  [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.4-fpm
• 提示：Xdebug 会显著降低性能，仅在开发环境启用

四、一键排错命令清单

• 查看版本与配置：php -v、php --ini
• 实时看日志：sudo tail -f /var/log/apache2/error.log 或 sudo tail -f /var/log/nginx/error.log
• 服务状态与启停：
  • sudo systemctl status apache2（或 nginx、php7.x-fpm）
  • sudo systemctl restart apache2（或 nginx、php7.x-fpm）
  • sudo systemctl enable php7.x-fpm
• 安装扩展：sudo apt-get install php-{extension-name}（如 php-mbstring、php-gd、php-mysql）
• 权限修复：sudo chown -R www-data:www-data /var/www/html，sudo chmod -R 755 /var/www/html