php.ini是PHP运行时的核心配置文件，定义全局参数、功能开关、资源限制与安全规则；不同SAPI（CLI/FPM/Apache）加载路径独立，需用php --ini或phpinfo()准确定位，改错文件或未重启服务将导致配置不生效。
直接在入口文件顶部加三行，比改 php.ini 更快、更安全、更可复现。
为什么不要优先改 php.ini
改全局配置容易和团队不一致，上线时忘记关 display_errors 会导致敏感路径/变量名泄露；不同项目可能依赖不同 PHP 版本或 SAPI（如 CLI vs FPM），php.ini 生效路径也不同；有些托管环境（如部分 Docker 镜像或共享主机）根本不允许你改它。
常见误判点：
- 改了 php.ini 却没重启 PHP-FPM 或 Apache，配置压根没加载
- 用
phpinfo()查到的Loaded Configuration File路径，和你实际编辑的不是同一个文件 - 某些云平台（如 Laravel Vapor、Heroku）会忽略
display_errors = On，只认运行时设置
入口文件里怎么写才真正生效
必须放在所有 require、include、autoload 之前，否则致命错误（比如 Parse error 或 undefined function）根本执行不到这里就挂了。
立即学习“PHP免费学习笔记（深入）”；
这三行是底线：
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
说明：
-
display_startup_errors必须显式开启，否则require不存在的文件、调用未定义函数这类启动期错误不会显示 - 如果项目用了 Composer，
vendor/autoload.php必须在这三行之后引入 - PHP 8.0+ 下
E_ALL已包含E_DEPRECATED和E_STRICT；但老项目跑在 PHP 7.x 时，E_ALL不含E_DEPRECATED，如有需要可补成E_ALL | E_DEPRECATED
为什么还是看不到未定义数组键警告
常见原因不是 error_reporting 没开，而是被其他机制屏蔽了：
- 代码里用了
@抑制符，例如$val = @$arr['missing']—— 它会吞掉E_NOTICE，且无法被任何运行时设置恢复 - 框架（如 Laravel、Symfony）在引导过程中调用了
error_reporting(0)，覆盖了你的设置；得在框架初始化完成后再调一次error_reporting(E_ALL) -
variables_order被篡改（如设成"GP"），导致$_POST、$_GET为空，读取$_POST['key']时的“未定义索引”可能不触发通知
CGI/SAPI 限制下怎么办
某些部署方式（如 Nginx + PHP-CGI、IIS FastCGI）下，display_errors 运行时无法开启，浏览器只会返回 500。这时唯一可靠的方式是：
- 确保
log_errors = On（可在入口文件用ini_set('log_errors', '1')） - 指定日志路径：
ini_set('error_log', '/tmp/php-errors.log')（注意目录有写权限） - 用
tail -f /tmp/php-errors.log实时盯日志，比刷页面更准
别指望 display_errors 在所有环境下都起作用；能写进日志，就已经拿到了错误的完整上下文——这才是调试真正的起点。
