开启PHP 8.4错误显示需修改php.ini、添加.user.ini、脚本内ini_set、网站配置注入、检查PHP-FPM限制，最后用test_error.php验证；任一方法生效后错误信息将直接输出。
如果您在使用宝塔面板运行PHP 8.4时发现代码出错但页面空白或仅返回500状态，很可能是PHP错误报告被禁用。以下是开启PHP 8.4错误显示、使调试信息直接输出到浏览器的多种方法：
一、修改PHP配置文件php.ini
该方法通过全局启用错误报告，适用于所有通过该PHP版本运行的站点。需重启PHP服务生效。
1、登录宝塔面板，进入【软件商店】→ 找到已安装的PHP 8.4 → 点击【设置】→ 切换到【配置修改】选项卡。
2、在打开的php.ini文件中，查找display_errors项，将其值修改为On。
立即学习“PHP免费学习笔记（深入）”；
3、查找error_reporting项，将其值修改为E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED。
4、查找log_errors项，确保其值为On（保留错误日志记录）。
5、点击右上角【保存】按钮，然后返回PHP管理页，点击【重载配置】或【重启】服务。
二、在网站根目录添加.user.ini文件
该方法无需修改全局配置，仅对当前站点生效，适合多版本共存或权限受限环境，且不依赖PHP-FPM重启。
1、通过宝塔【文件】管理器，进入目标网站的根目录（如/www/wwwroot/yourdomain.com）。
2、新建文件，命名为.user.ini。
3、在该文件中写入以下两行内容：
display_errors = On
error_reporting = E_ALL
4、保存后，在宝塔面板中进入【网站】→ 选择对应站点 → 【配置文件】→ 确认“防跨站攻击(open_basedir)”未开启（若开启，需将.user.ini所在路径加入白名单）。
三、在PHP脚本开头动态启用错误显示
该方法适用于临时调试单个文件，无需服务器配置变更，执行时即时生效，但仅作用于当前脚本生命周期。
1、打开待调试的PHP文件（如index.php），在第一行PHP标签之后立即插入以下代码：
ini_set('display_errors', '1');
ini_set('error_reporting', E_ALL);
2、确保该代码位于任何可能触发错误的语句之前（例如require、函数调用等）。
3、保存文件并刷新网页，错误信息将直接输出在页面顶部或对应位置。
四、通过宝塔网站配置文件注入PHP指令
该方法利用Nginx/Apache的站点配置能力，在请求处理阶段强制启用错误显示，对PHP-FPM模式有效且优先级高于php.ini。
1、在宝塔面板中进入【网站】→ 选择目标站点 → 点击【设置】→ 切换到【配置文件】选项卡。
2、若使用Nginx，在location ~ \.php$区块内，找到fastcgi_param PHP_VALUE行（或在其后新增）：
fastcgi_param PHP_VALUE "display_errors=on\nerror_reporting=E_ALL";
3、若使用Apache，在配置末尾的
php_flag display_errors on
php_value error_reporting 32767
4、保存配置，然后点击【重载配置】使Nginx/Apache重新加载规则。
五、检查PHP-FPM池配置中的php_admin_value限制
该方法用于排除因PHP-FPM层面强制覆盖导致的display_errors失效问题，常见于多用户隔离或安全加固环境。
1、进入宝塔【软件商店】→ 找到PHP 8.4 → 【设置】→ 【配置修改】→ 切换到【PHP-FPM设置】选项卡。
2、查找php_admin_value[display_errors]或php_admin_flag[display_errors]相关行。
3、若存在且值为off或0，请将其整行注释（在行首加分号;）或删除。
4、保存后，点击【重载配置】或【重启】PHP服务以应用变更。
六、验证错误显示是否生效
该步骤用于确认前述任一方法已正确启用错误报告机制，避免误判配置失败。
1、在网站根目录新建一个测试文件，例如test_error.php。
2、在其中写入故意引发错误的代码：。
3、通过浏览器访问http://yourdomain.com/test_error.php。
4、若页面显示Fatal error: Uncaught Error: Call to undefined function undefined_function()等详细报错信息，则说明开启成功；若仍为空白页或500错误，则需检查Web服务器错误日志（如Nginx error.log）或PHP错误日志路径是否可写。
