上一篇
PHP错误日志配置选项有哪些？error_log设置详解
在PHP配置中，错误日志相关的核心选项集中在 php.ini 文件中，以下是关键配置项及其作用、推荐值和示例：
核心配置选项
| 配置项 | 作用 | 推荐值 | 示例 |
|---|---|---|---|
| error_reporting | 设置PHP错误报告级别（控制哪些错误会被记录/显示） | 生产环境：E_ALL & ~E_DEPRECATED & ~E_STRICT 开发环境：E_ALL | error_reporting = E_ALL |
| display_errors | 是否在页面上显示错误信息 （生产环境强烈建议关闭！） | Off（生产） On（开发） | display_errors = Off |
| log_errors | 是否将错误记录到日志文件 | On | log_errors = On |
| error_log | 指定错误日志文件路径（绝对路径）或使用系统日志 （必须确保目录可写！） | 自定义路径或syslog | error_log = /var/log/php_errors.log error_log = syslog |
| ignore_repeated_errors | 忽略重复出现的相同错误（同一行、同一文件） | Off（默认） | ignore_repeated_errors = On |
| ignore_repeated_source | 忽略同一文件中所有重复错误（不限行号） | Off（默认） | ignore_repeated_source = On |
| log_errors_max_len | 单条错误日志的最大长度（字节） 0表示无限制 | 1024 或 0 | log_errors_max_len = 1024 |
详细说明
-
error_reporting
- 使用常量组合定义错误级别，
- E_ALL：所有错误和警告
- E_ERROR：致命运行时错误
- E_WARNING：运行时警告
- E_PARSE：语法解析错误
- 示例（屏蔽通知类错误）： error_reporting = E_ALL & ~E_NOTICE
- 使用常量组合定义错误级别，
-
error_log
- 自定义文件路径：确保Web服务器用户（如www-data、nginx）有写入权限： error_log = /var/log/php/php_errors.log
- 系统日志：错误发送到系统日志（Linux的syslog/Windows事件查看器）： error_log = syslog
-
display_errors
- 安全警告：生产环境开启此选项会暴露敏感信息（路径、数据库细节），务必关闭： display_errors = Off
生产环境推荐配置
; php.ini 配置示例 error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT ; 报告所有错误（忽略弃用和严格标准） display_errors = Off ; 不显示错误到页面 log_errors = On ; 启用错误日志 error_log = /var/log/php_errors.log ; 自定义日志路径 ignore_repeated_errors = Off ; 记录重复错误 log_errors_max_len = 0 ; 日志长度无限制
其他相关配置
-
track_errors（不常用）：
将最后一个错误信息存入变量 $php_errormsg（需开启）。
track_errors = On ; 默认Off
-
html_errors：
在HTML页面中格式化错误信息（开发调试用）。
动态代码中设置
可在PHP脚本中覆盖 php.ini 设置：
<?php // 设置错误报告级别 error_reporting(E_ALL); // 关闭页面错误显示 ini_set('display_errors', 0); // 指定日志文件 ini_set('error_log', '/path/to/custom_errors.log'); // 自定义错误处理器（高级用法） set_error_handler(function($errno, $errstr, $errfile, $errline) { error_log("[$errno] $errstr in $errfile on line $errline"); return true; // 阻止默认错误处理 }); ?>
日志权限问题
-
确保日志目录可写：
-
系统日志位置：
- Linux：/var/log/syslog 或 journalctl -u php-fpm
- Windows：事件查看器 → Windows日志 → 应用程序
通过合理配置这些选项，可有效捕获PHP错误，同时避免敏感信息泄露,是服务器安全运维的关键步骤。
-
