使用RabbitMQ搭配PHPMailer时，如何运用PHP error_log记录错误？

问题根源 #

RabbitMQ的PHP消费者是命令行（CLI）模式运行的，和Nginx托管的Web PHP环境用的是两套php.ini配置，默认情况下error_log不会写到/var/log/nginx/error.log里。

具体解决办法 #

1. 调用error_log时直接指定日志路径 #

不用依赖默认配置，在消费者脚本里写日志时明确指定文件路径，比如：

// 捕获PHPMailer发送失败的错误
if (!$mail->send()) {
    $logContent = date('[Y-m-d H:i:s] ') . '邮件发送失败: ' . $mail->ErrorInfo . PHP_EOL;
    // 参数3表示追加写入，最后一个参数是日志文件路径
    error_log($logContent, 3, '/var/log/php_mail_error.log');
}

注意要给这个日志文件设置PHP进程可写的权限，比如执行chown www-data:www-data /var/log/php_mail_error.log。

2. 单独配置CLI模式的php.ini #

找到CLI版本的php.ini（通常在/etc/php/你的PHP版本/cli/php.ini，比如/etc/php/8.1/cli/php.ini），修改error_log配置项：

error_log = /var/log/php_cli_error.log

改完重启你的RabbitMQ消费者进程，之后CLI脚本里的error_log就会默认写到这个文件里。

3. 用PHPMailer的异常机制捕获并写日志 #

开启PHPMailer的异常模式，能更精准捕获错误细节：

// 开启异常模式
$mail->SMTPDebug = 0; // 关闭调试输出，避免冗余信息
$mail->Debugoutput = 'error_log'; // 把调试信息定向到error_log
try {
    $mail->send();
} catch (Exception $e) {
    $logContent = date('[Y-m-d H:i:s] ') . 'PHPMailer异常: ' . $e->getMessage() . PHP_EOL;
    error_log($logContent, 3, '/var/log/php_mail_error.log');
}

4. 查看消费者进程的运行日志 #

如果是用systemd管理消费者进程，进程的输出会被systemd记录，用这个命令查看：

journalctl -u 你的消费者服务名.service

要是直接在终端启动消费者，把输出重定向到日志文件就行：

php 你的消费者脚本.php >> /var/log/mail_consumer.log 2>&1 &

2>&1是把错误输出也一起写到日志里，避免只记录正常输出。

内容的提问来源于stack exchange，提问作者bapak71