宝塔面板中PHP报错显示空白需启用display_errors:一、面板PHP设置中开启;二、手动编辑php.ini设display_errors=On且error_reporting=E_ALL;三、网站.user.ini临时覆盖并重启PHP-FPM。

如果您在宝塔面板中运行PHP程序时遇到错误但页面仅显示空白,很可能是PHP的display_errors被禁用,导致错误信息未输出到浏览器。以下是启用该配置的具体操作步骤:
一、通过宝塔面板PHP设置界面修改
此方法无需手动编辑配置文件,直接在宝塔图形界面中开启display_errors,适用于所有已安装的PHP版本。
1、登录宝塔面板,点击左侧菜单栏的软件商店,在右上角搜索框输入当前网站所用的PHP版本号(如PHP 8.0)。
2、在搜索结果中找到对应PHP版本,点击其右侧的设置按钮。
立即学习“PHP免费学习笔记(深入)”;
3、在打开的设置页面中,切换到配置修改选项卡。
4、在配置项列表中定位到display_errors这一行,将其值由Off改为On。
5、滚动至页面底部,点击保存按钮,系统将自动重载PHP服务。
二、通过php.ini文件手动编辑
当面板界面未同步最新配置或需批量调整多个环境时,可直接修改php.ini文件,确保配置生效且不受面板缓存影响。
1、在宝塔面板中进入对应PHP版本的配置文件页面(路径通常为/opt/php/{版本号}/etc/php.ini)。
2、使用内置编辑器按Ctrl+F搜索关键词display_errors。
3、将找到的行取消注释(删除开头的分号),并设为display_errors = On。
4、在同一文件中确认error_reporting值不为0,建议设为error_reporting = E_ALL以显示全部错误类型。
5、保存文件后,在PHP设置页点击重载配置按钮使更改立即生效。
三、通过网站根目录下的.user.ini临时覆盖
该方式作用于单个网站,优先级高于php.ini,适合开发阶段快速启用错误提示而不影响其他站点。
1、进入宝塔面板的网站列表,点击目标站点右侧的设置。
2、切换到配置文件选项卡,向下滚动找到用户自定义配置区域。
3、在文本框中添加以下两行内容:
display_errors = On
error_reporting = E_ALL
4、点击保存,系统会自动写入网站根目录下的.user.ini文件。
5、执行命令kill -USR2 $(cat /www/server/php/{版本号}/var/run/php-fpm.pid)重启对应PHP-FPM进程(替换{版本号}为实际版本,如74、80等)。











