在 Ubuntu 系统中配置 PHP 日志,核心步骤其实就是找到并正确修改 php.ini 文件中的几个参数。很多新手容易卡在第一步——不清楚配置文件的具体位置,或者修改完成后忘记重启服务。下面将整个流程详细拆解,跟着操作基本不会出错。

首先打开终端(快捷键 Ctrl + Alt + T)。接着,使用以下命令来定位 php.ini 的所在路径:
php --ini
输出结果会显示类似下面的信息:
Configuration File (php.ini) Path: /etc/php/7.4/cli
Loaded Configuration File: /etc/php/7.4/cli/php.ini
请特别留意 Loaded Configuration File 这一行,它后面就是实际加载的配置文件完整路径。记录下这个路径,接下来需要编辑的就是这个文件。
使用文本编辑器打开它。这里以 nano 为例,如果你习惯用 vim 或其他编辑器,替换相应命令即可:
sudo nano /etc/php/7.4/cli/php.ini
在文件中找到以下两行(通常它们的位置相隔不远):
;error_log = /var/log/php_errors.log
;log_errors = Off
行首的分号表示注释,代表这些配置尚未生效。我们需要去掉分号,使它们生效。同时可以指定一个自己期望的日志存储路径,例如:
error_log = /var/log/php_errors.log
log_errors = On
如果担心日志文件增长过快,还可以设置 log_errors_max_len 来限制单条日志的最大长度,比如:
log_errors_max_len = 1024
保存并退出编辑器。在 nano 中按 Ctrl + X,然后按 Y,最后回车确认。
最后一步,重启 PHP 相关服务使新配置生效。具体命令取决于你安装的 PHP 版本,例如 PHP 7.4 版本:
sudo service php7.4-fpm restart
如果使用的是其他版本(比如 7.2、8.0 等),请将服务名中的版本号替换为对应的数值。至此,PHP 日志就配置完成了。所有错误和警告信息都会被写入你指定的日志文件(本例中为 /var/log/php_errors.log),以后排查问题直接查看这个文件即可。
