必须同时开启 display_errors、error_reporting 和 log_errors 才算真正启用调试能力:display_errors=on 显示错误,error_reporting=e_all 报告所有错误,log_errors=on 且 error_log 设绝对路径记录日志。

XAMPP 默认只开启 display_errors,但常因 log_errors = Off 或 error_reporting 值过低导致报错“看不见也留不下”——必须同时打开三者才算真正启用调试能力。
确认并修改 php.ini 中的 display_errors
这是让错误直接显示在浏览器页面的关键开关,但仅设为 On 不够,还需确保它没被后续配置覆盖。
- 用
phpinfo()查看 “Loaded Configuration File” 路径,别改错文件(XAMPP 里通常是C:/xampp/php/php.ini或/Applications/XAMPP/xamppfiles/etc/php.ini) - 搜索
display_errors,确认其值是On(不是Off或1字符串) - 顺手检查 “Local Value” 列是否真为
On—— 若显示Off,说明有其他 .ini 文件(如php.d/下的扩展配置)把它又关了 - Windows 下注意 BOM 头:用 VS Code 或 Notepad++ 保存为 UTF-8 无 BOM 格式,否则 Apache 可能加载失败
设置 error_reporting 为 E_ALL(别信“默认已开”)
error_reporting 决定“报哪些错”,display_errors = On 只是决定“要不要打出来”。很多 XAMPP 版本默认设为 E_ALL & ~E_NOTICE & ~E_STRICT,结果数组下标未定义、变量未声明等提示全被过滤掉。
- 在 php.ini 中找到
error_reporting行,改为:error_reporting = E_ALL - 不推荐写成数字(如
32767),虽然等价,但可读性差且 PHP 8.0+ 对某些整数解释有差异 - 若项目跑在 PHP 7.x 环境,
E_ALL不含E_DEPRECATED,需手动补上:error_reporting = E_ALL | E_DEPRECATED - 改完后重启 Apache,再访问
phpinfo()页面核对 “error_reporting” 的 Local Value 是否真为32767(PHP 8.0+)或对应数值
必须开启 log_errors 并指定绝对路径的 error_log
仅靠页面显示不可靠:500 错误、解析失败、@ 抑制符、框架早期报错都可能让页面空白,而日志才是唯一可信记录源。
- 确认
log_errors = On(默认是Off,这点最容易漏) -
error_log必须填**绝对路径**:error_log = "C:/xampp/php/logs/php_error.log"(Windows)或error_log = "/Applications/XAMPP/xamppfiles/logs/php_error.log"(macOS) - 相对路径(如
./logs/error.log)一定失效 —— Apache 进程工作目录不是你的项目根目录 - 路径中避免中文、空格、符号;确保目录存在且 Apache 用户(Windows 一般没问题,macOS/Linux 需
sudo chown _www:wheel /Applications/XAMPP/xamppfiles/logs)有写权限 - 写个测试脚本:
<?php trigger_error("test", E_USER_WARNING); ?>,访问后立刻查日志文件是否新增一行
临时调试时用 ini_set() 更快,但注意顺序和时机
改 php.ini 要重启服务,不适合快速验证。脚本开头加三行最直接,但极易因位置不对而失效。
- 必须放在
<?php后第一行,前面不能有任何输出(包括空格、UTF-8 BOM、HTML 注释) - 三行缺一不可:
ini_set('display_errors', '1');、ini_set('display_startup_errors', '1');、error_reporting(E_ALL); -
display_startup_errors是关键:没有它,undefined function这类解析期错误仍不会显示 - 若项目用了 Composer 自动加载,这三行必须放在
require 'vendor/autoload.php'之前,否则框架可能已重置 error_reporting - 上线前务必删掉,否则会暴露敏感路径和变量名
最常被忽略的是 log_errors = Off 这个默认状态,以及 error_log 用相对路径——这两项一错,哪怕页面显示正常,出问题时你也找不到日志在哪。调试不是“开了 display_errors 就完事”,而是让错误既看得见、又留得下、还分得清来源。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











