PHP调试需按场景选择方法：一、改php.ini启用错误显示与日志；二、脚本内用ini_set动态开启；三、.htaccess配Apache；四、装Xdebug实现断点调试；五、框架如Laravel通过.env设APP_DEBUG=true。
如果您尝试调试PHP代码但无法看到错误信息、变量状态或断点响应，则可能是PHP未启用调试相关功能。以下是开启PHP调试模式的多种方法：
一、修改php.ini全局启用错误报告与调试输出
该方式影响整个PHP运行环境，适用于本地开发服务器，确保所有脚本默认显示错误并记录日志。
1、执行 php --ini 命令，确认当前生效的 php.ini 文件路径。
2、用文本编辑器打开该 php.ini 文件，定位到 display_errors、error_reporting 和 log_errors 配置项。
立即学习“PHP免费学习笔记（深入）”；
3、将以下三行设置为指定值：
display_errors = On
error_reporting = E_ALL
log_errors = On
4、可选：指定错误日志路径，添加或修改 error_log = /var/log/php_debug.log（需确保目录可写）。
5、保存后，重启Web服务器（如 sudo systemctl restart apache2 或 sudo systemctl restart php-fpm）。
二、在PHP脚本中动态启用调试
该方式不依赖服务器配置，适合共享主机或临时测试场景，仅对当前脚本生效，避免影响其他应用。
1、在PHP文件最顶部（任何输出之前）插入以下两行：
ini_set('display_errors', 1);
ini_set('error_reporting', E_ALL);
2、若需强制输出至浏览器且绕过SAPI限制，追加：
error_reporting(E_ALL);
3、可配合 var_dump($var); die(); 快速中断并查看变量结构。
三、通过.htaccess文件为Apache站点启用调试
该方式无需修改php.ini，适用于拥有Apache目录权限但无root访问权的用户，仅作用于当前目录及子目录。
1、在网站根目录创建或编辑 .htaccess 文件。
2、添加以下两行指令：
php_flag display_errors On
php_value error_reporting 32767
3、保存文件，刷新网页，验证是否出现未捕获的Notice或Warning提示。
四、启用Xdebug扩展实现断点与远程调试
Xdebug提供完整的交互式调试能力，包括单步执行、变量监视、堆栈追踪和远程IDE连接，是深度调试的必备方案。
1、执行 pecl install xdebug 安装扩展；或从 xdebug.org/downloads 下载匹配PHP版本的DLL/SO文件。
2、在php.ini末尾添加加载语句：
zend_extension=xdebug.so（Linux/macOS）
或
zend_extension=php_xdebug.dll（Windows）
3、在php.ini中新增 [xdebug] 段落，并配置以下参数：
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
4、重启PHP服务后，运行 php -m | grep xdebug 确认扩展已加载。
五、使用框架内置调试开关快速启用
主流PHP框架（如Laravel、ThinkPHP、CodeIgniter）均提供独立的调试配置入口，优先级高于php.ini，便于环境隔离。
1、对于Laravel项目，编辑 .env 文件，将 APP_DEBUG=true 设置为true。
2、对于ThinkPHP项目，打开 config/app.php，将 'app_debug' => true 修改为true；或在.env中设 APP_DEBUG=true。
3、对于CodeIgniter 4，编辑 app/Config/Exceptions.php，确保 $showErrorPages = true；并在 app/Config/Boot/development.php 中启用调试上下文。
4、修改后清除框架缓存（如 php artisan config:clear 或 php think clear），刷新页面验证调试面板是否出现。
