PHP错误日志记录方法配置详解

PHP错误日志配置远不止简单设置error_log路径——它在CLI与Web模式下行为迥异，需精准定位生效的php.ini、确保目录权限与error_reporting级别匹配；原生机制缺乏上下文、不捕获Notice和Fatal错误、无轮转能力，必须结合set_error_handler()、register_shutdown_function()、手动堆栈采集、敏感信息过滤及logrotate或自建轮转逻辑，才能构建出真正可用、安全、可持续的线上错误追踪体系。

php.ini 中 error_log 配置不生效？先确认运行模式

CLI 和 Web（如 Apache/FPM）下 error_log 的行为完全不同：CLI 默认输出到终端，Web 下才真正写入文件。如果你改了 php.ini 却没看到日志，大概率是 PHP 没在用你改的那个配置文件。

• 用 php --ini 查 CLI 加载的配置；用 phpinfo() 页面查 Web 环境实际加载的 php.ini 路径
• error_log = /var/log/php_errors.log 只对 Web 模式有效；CLI 下需配合 log_errors = On + error_log 才写文件，否则仍打屏
• 确保目标日志路径目录存在、PHP 进程有写权限（比如 www-data 可写 /var/log/php_errors.log），否则静默失败

set_error_handler() 拦截不到 Notice？因为默认级别太低

PHP 默认只把 E_ERROR、E_WARNING、E_PARSE 送进自定义错误处理器，E_NOTICE、E_DEPRECATED 被忽略——除非你显式调整 error_reporting。

• 在入口文件开头加 error_reporting(E_ALL)，再调用 set_error_handler()，否则 undefined variable 这类 Notice 根本不会触发你的函数
• 自定义 handler 里别直接用 error_log() 写文件——它可能被 log_errors = Off 关闭；推荐用 file_put_contents($file, $msg, FILE_APPEND | LOCK_EX)
• 注意：自定义 handler 不会捕获 Fatal error（如语法错误、内存耗尽），这类必须靠 register_shutdown_function() + error_get_last() 补漏

记录日志时丢失上下文？$_SERVER 和堆栈得手动抓

PHP 原生 error_log() 只打消息和行号，没有请求 URL、IP、POST 数据这些关键信息。想定位线上问题，光靠错误文本远远不够。

• 在自定义 handler 里主动拼接：$_SERVER['REQUEST_URI']、$_SERVER['REMOTE_ADDR']、debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 5)
• 避免在 handler 里调用可能出错的函数（比如访问未初始化的 $_SESSION），否则引发二次错误导致日志中断
• 敏感字段如 $_POST['password'] 必须过滤，用 array_diff_key($_POST, ['password' => '']) 或正则擦除，别图省事全量 dump

日志文件爆炸性增长？error_log 不支持轮转，得自己控

error_log 是纯追加写，没有任何大小限制或按天切分逻辑。一个高流量站点几天就能写满磁盘。

• 别依赖 error_log = /var/log/php.log 一劳永逸；生产环境务必用外部工具（如 logrotate）或自建轮转逻辑
• 轮转代码可放在 register_shutdown_function() 里：检查 filesize($log) 是否超 10MB，超则重命名成 php.log.20240515.1 并清空原文件
• 多个 PHP-FPM worker 同时写一个文件没问题（FILE_APPEND 是原子的），但轮转时必须加锁，否则可能丢日志

真正难的不是“怎么记”，而是“记什么”和“什么时候停”。比如开发期开 E_ALL，上线后关掉 E_NOTICE；比如记录用户操作前先判断是否登录，否则一堆 Undefined index: user_id 冲垮日志。这些边界，配置文件里从不写明。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP错误日志记录方法配置详解》文章吧，也可关注golang学习网公众号了解相关技术文章。