Ubuntu PHP错误日志如何查看

Ubuntu 查看 PHP 错误日志

PHP运行出了问题，第一反应肯定是去翻日志。但很多时候，你打开终端却不知道该往哪个路径找——这事儿说难不难，但确实容易让人卡壳。下面直接讲清楚不同场景下的日志位置、怎么快速定位、以及最常用的查看姿势。

一、常见日志路径与适用场景

不同的运行环境，PHP错误被记录的位置也不一样。下面这张表把最常见的场景和对应的路径列出来，方便你快速定位：

需要注意的是，路径中的 7.x 要替换成你实际安装的 PHP 版本号（比如 7.4、8.1、8.3）。

二、快速定位日志文件位置

如果不知道当前环境用的是哪个日志文件，最直接的方法就是顺着 php.ini 往下找。

先查看已加载的配置文件：php -i | grep 'Loaded Configuration File'

然后在对应 SAPI 的配置文件里搜索 error_log（Apache 和 FPM 的配置可能不同）：

• grep -i error_log /etc/php/版本号/apache2/php.ini
• grep -i error_log /etc/php/版本号/fpm/php.ini

如果项目里配置了自定义路径，那就直接以 php.ini 里的 error_log 为准，不绕弯子。

三、查看与分析日志的常用命令

这部分应该是大家最常用的。几个核心命令记住就行：

实时查看日志尾部（这是排查故障时最顺手的方式）

• Apache：sudo tail -f /var/log/apache2/error.log
• Nginx：sudo tail -f /var/log/nginx/error.log
• PHP-FPM：sudo tail -f /var/log/php7.x-fpm.log

检索关键字（比如只关心“error”或“fatal”级别的日志）

• grep -i "error" /var/log/php7.x-fpm.log

用编辑器查看——偶尔需要翻开整段日志的时候，直接用 nano 或 vim 打开就行：sudo nano /var/log/apache2/error.log 或 sudo vim /var/log/php7.x-fpm.log

日志格式其实很清晰：时间戳、错误级别、错误消息、堆栈跟踪——按照这些信息就能直接定位到具体的文件与行号，效率很高。

四、确保错误日志生效的配置与排错

有时候配置了日志但发现不生效，别急，先检查下面几个点。

在 php.ini 中开启并指定记录文件：

• log_errors = On
• error_log = /var/log/php_errors.log
• 生产环境建议把 display_errors = Off 打开，避免敏感信息外露。

让配置生效：

• Apache：sudo systemctl restart apache2
• PHP-FPM：sudo systemctl restart php7.x-fpm

如果依然没有日志产生：

• 确认 error_log 路径是否可写。必要时手动创建文件并设置权限：sudo touch /var/log/php_errors.log && sudo chown www-data:www-data /var/log/php_errors.log
• 检查 PHP-FPM 的池配置（比如 www.conf），确认没有单独设置不同的 error_log 覆盖了全局配置。
• 最后再用 php -i | grep error_log 和 grep -i error_log 双重确认实际生效的配置。

说白了，日志排查的关键就两点：路径对不对，权限够不够。把这两个点盯住，大部分问题都能迅速搞定。