PHP开启错误显示方法与配置调整

PHP默认在生产环境中静默屏蔽错误，导致代码出错却毫无提示，而真正解决问题的关键在于理解并协同配置php.ini全局设置、运行时动态调整（如ini_set）以及脚本级控制三个层面——既要正确设置error_reporting和display_errors，又要警惕.htaccess、框架初始化、自定义错误处理器等常见覆盖行为，排查时务必以phpinfo()显示的“Local Value”为准，而非仅依赖配置文件内容，这样才能彻底让隐藏的错误浮出水面，大幅提升开发调试效率。

PHP 默认在生产环境中关闭错误提示，所以你写错了代码却看不到任何报错——不是没出错，是被静默吞掉了。要让错误显示出来，关键不在“开启”一个开关，而是在 php.ini、运行时或脚本级三个层面协同控制，且必须确保没有被后续配置覆盖。

修改 php.ini 中的 error_reporting 和 display_errors

这是最根本的配置位置，影响所有通过该 PHP 实例执行的脚本。需要同时调整两个指令：

• error_reporting 决定报告哪些错误级别，开发时建议设为 E_ALL（或 E_ALL & ~E_NOTICE & ~E_DEPRECATED 过滤掉非致命提醒）
• display_errors 必须设为 On 才能在浏览器/终端直接看到错误信息；设为 Off 时错误只记录到日志（error_log）
• 改完后必须重启 Web 服务器（如 Apache 或 PHP-FPM），否则不生效

error_reporting = E_ALL
display_errors = On
log_errors = On
error_log = /var/log/php_errors.log

在脚本开头用 ini_set() 临时启用（适合无权改 php.ini 的场景）

当只能上传 PHP 文件、无法接触服务器配置时，可在脚本最顶部插入以下代码。但它仅对当前脚本生效，且受 php.ini 中 disable_functions 限制（如果 ini_set 被禁用则无效）：

<?php ini_set('display_errors', '1');
ini_set('error_reporting', E_ALL);
?>

注意：ini_set('display_errors', '1') 中的值必须是字符串 '1' 或 'On'，传布尔值 true 在某些 PHP 版本下会被转成 ''（空字符串），导致失效。

CLI 模式下不显示错误？检查 cli php.ini 是否独立

Web 用的 php.ini 和命令行（php -v）可能加载不同配置文件。运行 php --ini 查看 CLI 加载的是哪个 php.ini，再按前两步修改对应文件。常见错误是只改了 Apache 的配置，结果 php script.php 还是不报错。

• CLI 下默认 display_errors 常为 stderr，但若被重定向或终端不支持颜色，也可能“看不见”
• 可加 php -d display_errors=1 -d error_reporting=E_ALL script.php 临时强制启用

为什么设置了还是不显示错误？优先排查这几点

多数“开了没用”问题出在覆盖逻辑上：

• display_errors 被 .htaccess（Apache）或 nginx 配置强行设为 Off
• 框架（如 Laravel、ThinkPHP）在启动时调用 error_reporting(0) 关闭了所有错误
• 自定义错误处理器（set_error_handler()）捕获但未输出，或 @ 符号抑制了错误
• PHP 版本 ≥ 8.0 后，E_STRICT 已合并进 E_ALL，但旧写法 E_ALL | E_STRICT 会触发警告，反而干扰调试

真正可靠的调试起点永远是：先确认 phpinfo() 页面里 display_errors 和 error_reporting 的“Local Value”是否符合预期，而不是只看 php.ini 文件写了什么。

今天关于《PHP开启错误显示方法与配置调整》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！