php error_log配置不生效需分cli/web模式排查：cli默认输出终端，web才写文件；确认php.ini路径、目录权限、error_reporting级别，并用自定义handler补充上下文与敏感字段过滤，配合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 是纯追加写，没有任何大小限制或按天切分逻辑。一个高流量站点几天就能写满磁盘。
立即学习“PHP免费学习笔记（深入）”；
- 别依赖
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 冲垮日志。这些边界，配置文件里从不写明。
