php-fpm日志乱码在Linux怎么解决

PHP-FPM日志乱码这个问题，说大不大，说小不小。如果你在部署过程中遇到了乱码，大概率是字符编码没对齐导致的。下面说几个实测有效的排查思路，可以顺着走一遍。

第一步：先确认系统字符编码
最基础的排查点，就是看看当前系统的默认编码。在终端里跑一下这个命令：

echo $LANG

如果输出结果不是 UTF-8 相关的，比如显示的是 en_US 或 zh_CN.GBK，那就说明系统层面就没对齐。可以临时切换一下：

export LANG=en_US.UTF-8

当然，这只是临时生效。要永久改，还得去修改 /etc/locale.conf 或 /etc/default/locale 这类文件。不过先不管永久，先把问题复现环境调好再说。

第二步：检查 PHP-FPM 自身的配置
PHP-FPM 的配置文件一般位于 /etc/php-fpm.d/www.conf，或者 /etc/php/7.x/fpm/pool.d/www.conf，取决于你用的版本。打开后，找到这两行：

php_admin_value[error_log] = /var/log/php-fpm/error.log
php_admin_flag[log_errors] = on

确认日志路径写对了，并且 log_errors 是 on。路径错了，后面的排查全是白忙活。

第三步：修改 PHP 自身的编码与时区设置
编辑 PHP 的配置文件，通常位置是 /etc/php/7.x/cli/php.ini（注意版本号）。找到下面这两项：

date.timezone = UTC
default_charset = UTF-8

把 date.timezone 改成你所在的实际时区，比如 Asia/Shanghai；default_charset 确保是 UTF-8。这个小动作，有时候能直接解决日志输出里中文乱码的问题。

第四步：重启 PHP-FPM 让改动生效
配置文件改完了，必须重启一下服务：

sudo service php-fpm restart

或者如果你用的是 systemd 系的系统：

sudo systemctl restart php-fpm

重启完别急着走，看一眼日志文件，比如 /var/log/php-fpm/error.log，看看乱码问题还有没有出现。

第五步：代码层面兜个底
如果以上操作都做完了，日志里依然有乱码，那可能就要在代码层面给个明确指示了。在 PHP 脚本顶部加上一句话，强制设定内部字符编码：

mb_internal_encoding('UTF-8');

这个函数的作用是告诉 PHP 的多字节字符串函数，默认按 UTF-8 处理。虽然它不直接修改日志内容输出，但能避免很多隐性的编码错乱问题。

最后想说的是，编码问题往往是“差一个细节”就可以解决。只要确保系统、PHP 配置文件、PHP-FPM 这三者之间的字符编码统一，乱码基本不会有机会出现。