PHP8 PHP-FPM：如何在www-error.log中排除函数参数

PHP核心配置里确实没有直接关闭错误日志中函数参数显示的选项，以下是几种可行的解决办法：

方法1：自定义致命错误处理器（推荐） #

利用register_shutdown_function捕获致命错误，手动生成不含参数的回溯日志并写入文件。这种方式可控性强，无需依赖外部工具。

实现步骤： #

1. 创建全局加载的PHP文件（比如/usr/local/php/error-handler.php），写入以下代码：

register_shutdown_function(function() {
    $fatalErrors = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR];
    $lastError = error_get_last();

    if ($lastError && in_array($lastError['type'], $fatalErrors)) {
        // 生成不含参数的回溯栈
        $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
        $logContent = sprintf(
            "[%s] PHP Fatal error: %s in %s on line %d\nStack trace:\n",
            date('Y-m-d H:i:s'),
            $lastError['message'],
            $lastError['file'],
            $lastError['line']
        );

        foreach ($trace as $index => $frame) {
            $logContent .= sprintf(
                "#%d %s() in %s on line %d\n",
                $index,
                $frame['function'],
                $frame['file'],
                $frame['line']
            );
        }

        // 写入自定义日志文件（替换为你的目标路径）
        file_put_contents('/var/log/php-fpm/www-error-clean.log', $logContent, FILE_APPEND | LOCK_EX);
    }
});

2. 在php.ini中配置自动加载这个文件：

auto_prepend_file = /usr/local/php/error-handler.php

3. 重启PHP-FPM服务：

systemctl restart php-fpm

注意：如果环境使用多PHP-FPM池，确保每个池的php.ini都配置了auto_prepend_file，或在站点.user.ini中单独配置。

方法2：实时过滤日志文件 #

如果不想修改PHP代码，可通过脚本实时处理原始日志，移除函数参数后写入新日志。

示例Bash脚本： #

#!/bin/bash
SOURCE_LOG="/var/log/php-fpm/www-error.log"
TARGET_LOG="/var/log/php-fpm/www-error-clean.log"

# 实时跟踪日志并过滤参数
tail -n0 -F "$SOURCE_LOG" | while read -r line; do
    # 正则匹配函数名后的参数部分，替换为空括号
    cleaned_line=$(echo "$line" | sed -E 's/([a-zA-Z0-9_]+)\([^)]*\)/\1()/g')
    echo "$cleaned_line" >> "$TARGET_LOG"
done

部署方式： #

1. 将脚本保存为/usr/local/bin/clean-php-logs.sh，添加执行权限：

chmod +x /usr/local/bin/clean-php-logs.sh

2. 创建systemd服务文件（/etc/systemd/system/php-log-cleaner.service）实现开机自启：

[Unit]
Description=Clean PHP-FPM error logs by removing function arguments
After=php-fpm.service

[Service]
ExecStart=/usr/local/bin/clean-php-logs.sh
Restart=always
User=root

[Install]
WantedBy=multi-user.target

3. 启动并启用服务：

systemctl daemon-reload
systemctl start php-log-cleaner
systemctl enable php-log-cleaner

方法3：修改PHP源码（不推荐） #

如果具备编译PHP的能力，可以修改PHP源码中错误回溯的输出逻辑，移除参数显示。但此方法会导致后续PHP升级时需重新修改，维护成本高，仅适合特殊场景。

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