PHP错误日志记录方法及配置指南

PHP错误日志默认不自动记录，必须手动启用log_errors并配置具备写权限的绝对路径error_log，否则各类错误将被丢弃或仅显示在页面上，极易导致线上问题难以排查；文章深入剖析了日志不生成的三大主因——配置关闭、权限不足与FPM池级覆盖，并提供跨环境（开发/生产/CLI/Web）动态设置日志路径的可靠方案，同时厘清error_reporting与display_errors的协同逻辑，强调生产环境必须关闭display_errors但务必确保日志持续捕获，最后提醒开发者重视SAPI差异和配置验证，堪称PHP错误可观测性的实战避坑指南。

PHP 默认不记录错误日志到文件，必须显式开启并配置 error_log 和 log_errors，否则所有错误（包括 E_WARNING、E_NOTICE）只会输出到页面或被丢弃。

为什么 error_log 配置了却没生成日志文件？

常见原因是权限、路径和 PHP 运行模式三者不匹配：

• error_log 路径必须是 PHP 进程有写权限的绝对路径（如 /var/log/php_errors.log），相对路径（如 logs/error.log）在 CLI 模式下基于当前工作目录，在 FPM/Apache 下则取决于主进程启动路径，极不可靠
• Web 服务器（如 nginx + PHP-FPM）下，PHP 进程用户（如 www-data 或 nginx）必须对目标目录有 w 权限，仅靠 chmod 755 不够，需确认属主
• FPM 模式下，php.ini 中的 error_log 可能被 pool 配置覆盖（如 www.conf 中的 php_admin_value[error_log]），优先级更高
• 若 log_errors = Off（默认值），即使设了 error_log 也完全不写日志

如何让不同环境用不同日志路径（开发/生产）？

硬编码路径不利于部署，推荐用运行时判断 + 动态设置：

• CLI 脚本中直接调用 ini_set('error_log', '/path/to/cli_errors.log')，比改 php.ini 更灵活
• Web 环境中可在入口文件（如 index.php）开头加：

  if (getenv('APP_ENV') === 'prod') {
      ini_set('error_log', '/var/log/myapp/php_errors.log');
  }

• 避免用 __DIR__ 拼路径（如 __DIR__.'/../storage/logs/php.log'），因为 CLI 和 Web 的 __DIR__ 含义不同；统一用 realpath() 解析绝对路径

error_reporting 和 display_errors 怎么配才安全？

这两个选项控制“报什么”和“怎么报”，常被混淆：

• display_errors = Off（生产必须关）：防止敏感信息（如路径、变量值）暴露给用户；但不影响日志记录
• error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT 是较通用的生产配置，兼容 PHP 7/8；PHP 8.0+ 默认已不含 E_DEPRECATED，可简化为 E_ALL
• 开发环境可开 display_errors = On，但务必确保 error_log 也启用——屏幕看不到的错误（如异步任务、定时脚本）只能靠日志发现
• 注意：set_error_handler() 会接管部分错误，若 handler 内未手动写日志（如未调用 error_log()），这些错误就彻底丢失

最易忽略的是 SAPI 差异：CLI 脚本的日志配置和 Web 请求互不影响，FPM pool 之间也可独立配置。上线前务必用 php -i | grep -E '(error_log|log_errors|error_reporting)' 和 php-fpm -t && php-fpm -i 分别验证。

本篇关于《PHP错误日志记录方法及配置指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！