宝塔面板中设置和查看PHP错误日志需配置PHP的error_log路径、log_errors=On、display_errors=Off及error_reporting=E_ALL & ~E_DEPRECATED & ~E_STRICT,并检查.user.ini覆盖项,通过宝塔日志页或tail -f实时查看,最后用测试代码验证写入是否正常。

宝塔面板中设置和查看 PHP 错误日志,关键在于两处配置:PHP 本身的错误报告级别与日志路径,以及网站或 PHP 项目的运行环境是否启用错误输出。下面分步骤说明常用、有效的设置和查看方法。
一、在宝塔面板中开启 PHP 错误日志记录
登录宝塔后台 → 左侧菜单「软件商店」→ 找到已安装的 PHP 版本(如 PHP 7.4/8.0)→ 点击「设置」→ 切换到「配置修改」选项卡:
- 找到 error_log 这一行,确保其值为一个可写的绝对路径,例如:
/www/wwwlogs/php_error.log(推荐统一存放在 wwwlogs 目录下,便于管理) - 确认 log_errors 设置为 On(必须开启,否则不写日志)
- 建议将 display_errors 设为 Off(生产环境禁用直接显示错误,避免信息泄露)
- 如需捕获所有错误(包括 Notice 和 Warning),把 error_reporting 改为:
E_ALL & ~E_DEPRECATED & ~E_STRICT
修改后点击「保存」,再点击右上角「重载配置」使 PHP 设置生效。
二、检查网站根目录下的 .user.ini 或 php.ini 覆盖配置
部分网站会通过根目录的 .user.ini 文件单独控制 PHP 行为,它优先级高于全局 php.ini。若日志没生成,需检查:
立即学习“PHP免费学习笔记(深入)”;
- 进入网站根目录(如
/www/wwwroot/your-site.com/),查看是否存在.user.ini - 打开该文件,确认其中没有覆盖
log_errors=Off或error_log指向了无效路径(如相对路径、不存在目录) - 如有问题,可临时注释掉相关行,或修正路径后执行
bt 11(宝塔命令行重启 PHP)
三、快速查看 PHP 错误日志内容
日志文件默认是纯文本,可通过以下任一方式实时查看:
- 宝塔界面查看:左侧「网站」→ 找到对应站点 → 点击「日志」→ 切换到「PHP 错误日志」标签页(前提是 error_log 路径指向的是该站点专属日志)
- 终端查看(推荐):
cd /www/wwwlogs && tail -f php_error.log
若按站点分开记录,路径可能是:/www/wwwlogs/your-site.com/php-error.log - 使用宝塔「文件」管理器,定位到日志路径,点击文件 → 右上角「在线编辑」或「下载」分析
注意:日志内容通常包含时间、错误级别(Warning/Parse error/Fatal error)、文件路径、行号和具体提示,例如:
[23-May-2024 10:22:14 Asia/Shanghai] PHP Fatal error: Uncaught Error: Call to undefined function mysql_connect() in /www/wwwroot/test.com/index.php on line 5
四、验证错误日志是否正常工作
写一段测试代码放入网站任意 PHP 文件中(如 test-error.php),访问触发错误:
刷新页面后,立刻检查日志文件是否新增对应条目。如无记录,请回头检查权限(/www/wwwlogs/ 目录需对 www 用户可写)和 SELinux/firewalld 是否拦截(极少数系统需关闭)。











