在 Ubuntu 系统中处理 PHP 错误日志,是 PHP 开发、服务器运维和网站排错过程中非常关键的一步。很多刚开始接触 Ubuntu 配置 PHP 环境的用户,常常会被多个配置文件和日志路径搞混。其实理清思路后,核心流程并不复杂,主要就是三步:先确认 PHP 错误日志位置,再正确配置 PHP 错误日志记录规则,最后重载或重启 Web 服务器使配置生效。下面就按步骤详细说明。

第一步:先弄清楚 PHP 错误日志写入到哪里
通常来说,PHP 错误日志文件的位置与所使用的 Web 服务器有关。如果你使用的是 Apache,那么错误日志通常位于 /var/log/apache2/error.log;如果使用的是 Nginx,一般则在 /var/log/nginx/error.log。不过需要注意,这些只是 Ubuntu 下常见的默认日志路径,实际路径仍然要以当前服务器配置为准。
如果你想准确查看当前 PHP 的日志配置路径,可以直接执行下面这条命令:
php --ini
执行完成后,在输出结果中查找“ErrorLog”相关配置项,它后面显示的路径,就是当前 PHP 环境实际使用的错误日志位置。
第二步:配置 PHP 错误日志记录规则(核心步骤)
配置 PHP 错误日志的关键,就是编辑 php.ini 配置文件。第一步仍然是先确认这个文件的位置:
php --ini
在命令输出内容中找到“Loaded Configuration File”这一项,它指向的就是当前 PHP 正在加载的配置文件。确定路径后,使用你习惯的文本编辑器打开,例如:
sudo nano /path/to/php.ini
打开 php.ini 之后,重点检查并配置以下三个参数:
display_errors:建议设置为Off。在生产环境中,不应将 PHP 报错信息直接输出到浏览器页面,否则可能暴露路径、代码结构或敏感信息,存在安全风险。log_errors:设置为On,这样 PHP 才会把运行错误、警告等信息写入日志,方便后续排查问题。error_log:用于指定 PHP 错误日志文件的保存路径,例如/var/log/php_errors.log。如果这里没有单独设置,PHP 通常会使用前面提到的 Web 服务器默认错误日志。
一个常见且实用的配置示例如下:
display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log
修改完成后保存并退出,PHP 错误日志的核心配置就基本完成了。
第三步:重启 Web 服务器,让 PHP 日志配置立即生效
这一步一定不要忽略。即使 php.ini 已经修改正确,如果没有重新加载或重启服务,新配置通常也不会立即生效。你可以根据当前使用的 Web 服务器,执行对应命令:
Apache 用户:
sudo systemctl restart apache2
Nginx 用户:
sudo systemctl restart nginx
完成后,PHP 错误信息通常就不会再直接显示在浏览器中,而是按照配置写入指定的日志文件。若你想实时查看 Ubuntu 中的 PHP 错误日志,可以使用 tail -f 命令:
sudo tail -f /var/log/php_errors.log
通过这种方式,你可以在终端中实时监控 PHP 报错信息,更高效地进行网站调试、故障定位和服务器问题排查。
