PHP 8.5.5默认关闭错误显示，必须同时配置php.ini中display_errors=On、error_reporting=E_ALL、log_errors=On，并重启服务；ThinkPHP 8需通过.env设APP_DEBUG=true（define已失效），PHPCMS则仅认base.php中DEBUG常量，且须确保Nginx fastcgi_intercept_errors=off。
直接改 php.ini 里的 display_errors 和 error_reporting 就能快速看到错误，但仅靠这个不够——PHP 8.5.5 默认禁用错误显示，且框架（如 ThinkPHP、PHPCMS）的调试行为还依赖各自配置，不配齐会白屏、无堆栈、Trace 面板不出现。
改 php.ini 是最基础也最容易漏掉的一步
PHP 8.5.5 启动时默认关闭错误输出，哪怕代码里写了 trigger_error() 或有语法错误，浏览器也只返回 500 或空白页。必须显式开启底层错误机制：
-
display_errors = On—— 不设这个，任何框架的调试页面都出不来 -
error_reporting = E_ALL—— PHP 8.5.5 对未定义数组键、类型警告更严格，E_ALL才能捕获全部 -
log_errors = On+error_log = /var/log/php_errors.log—— 错误不一定刷到浏览器，日志才是最终依据 - 改完后必须重启 PHP-FPM 或 Apache，
php --ini确认生效路径，php -m | grep xdebug检查扩展是否加载（非必需，但深度调试要用）
ThinkPHP 8 必须配 .env，define('APP_DEBUG', true) 已失效
TP8 的环境加载逻辑变了：define('APP_DEBUG', true) 放在 public/index.php 顶部会绕过环境初始化，导致 App::isDebug() 返回 false，Trace 面板消失、SQL 日志不记录。
- 项目根目录确保有
.env文件（没有就复制.example.env） - 用纯文本编辑器写入两行，**等号两侧绝对不能有空格**：
APP_DEBUG=true和APP_TRACE=true - 删掉整个
runtime/目录（含子目录），否则旧缓存会掩盖新配置 - 如果右下角 Trace 图标仍不出现，检查
config/log.php是否启用了'sql'和'trace'日志通道
PHPCMS 调试开关只在 base.php，别去 config 里翻
PHPCMS 的调试模式由单一常量控制，和 ThinkPHP 完全不同：它不读 .env，也不看 config/ 下任何文件，只认 phpcms/base.php 里的 DEBUG 常量。
立即学习“PHP免费学习笔记（深入）”；
- 打开
phpcms/base.php，找到define('DEBUG', false);这行，改成define('DEBUG', true); - 改完立刻生效，无需清缓存（但若之前开过，
phpcms/logs/下会有历史日志可查） - 上线前必须改回
false，否则数据库结构、SQL 语句、变量 dump 全部暴露在错误页上 -
$this->sqls在模型中可用，但仅限调试模式开启后执行过的查询，不是实时镜像
常见“开了却没反应”的真实原因
不是配置没写对，而是多个层级互相压制：PHP 层关了错误显示，框架层开了调试，结果还是静默失败。
- Nginx + PHP-FPM 场景下，
fastcgi_intercept_errors on;会吞掉所有 PHP 错误页，必须设为off - 某些共享主机禁用
display_errors，此时只能靠ini_set('display_errors', '1')+error_reporting(E_ALL)在入口文件顶部硬顶 - PHP 8.5.5 对
__toString()返回非字符串、动态调用 null 方法等新增了 Fatal Error，这些不会被set_error_handler捕获，必须靠日志或 Xdebug 断点定位 - 框架自定义了异常处理器（比如重写了
think\exception\Handle），但没调用parent::render($e)，调试视图就永远不会渲染
真正起效的调试不是单点开关，而是 PHP 底层错误机制、框架配置、Web 服务器行为三者对齐；任何一个环节断开，你看到的就只是“页面打不开”，而不是“哪一行报错”。
