宝塔面板PHP显示错误设置方法

当PHP程序在宝塔面板中报错却只显示空白页面，往往是因为关键的错误提示功能被禁用；本文详细拆解三种高效启用display_errors的方法——从图形化面板一键开启、手动编辑php.ini确保底层配置生效，到通过.user.ini为单个网站快速临时覆盖，兼顾安全性与灵活性，助开发者秒级定位问题，告别“黑盒式”调试。

如果您在宝塔面板中运行PHP程序时遇到错误但页面仅显示空白，很可能是PHP的display_errors被禁用，导致错误信息未输出到浏览器。以下是启用该配置的具体操作步骤：

一、通过宝塔面板PHP设置界面修改

此方法无需手动编辑配置文件，直接在宝塔图形界面中开启display_errors，适用于所有已安装的PHP版本。

1、登录宝塔面板，点击左侧菜单栏的软件商店，在右上角搜索框输入当前网站所用的PHP版本号（如PHP 8.0）。

2、在搜索结果中找到对应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等）。

到这里，我们也就讲完了《宝塔面板PHP显示错误设置方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！