Debian怎样进行PHP代码调试

Debian系统PHP代码调试指南（以Xdebug为核心）

一、准备工作：安装Xdebug扩展

Xdebug是Debian下最主流的PHP调试工具，支持断点调试、变量监控、函数跟踪等功能。安装步骤如下：

更新软件包列表：sudo apt update
安装Xdebug：sudo apt install php-xdebug（若使用PHP 8.x，需替换为php8.x-xdebug，如php8.1-xdebug）。

二、配置Xdebug：修改php.ini文件

Xdebug的配置需根据PHP运行环境（CLI/Apache/Nginx/PHP-FPM）调整php.ini路径：

Apache（模块模式）：/etc/php/{version}/apache2/php.ini
Nginx/PHP-FPM：/etc/php/{version}/fpm/php.ini
命令行（CLI）：/etc/php/{version}/cli/php.ini

在php.ini末尾添加以下配置（关键参数说明见注释）：

[Xdebug]
; 启用Xdebug扩展（路径通常自动识别，无需手动指定）
zend_extension=xdebug.so
; 设置调试模式为'debug'（必需）
xdebug.mode=debug
; 指定IDE监听的主机地址（默认本地）
xdebug.client_host=127.0.0.1
; 指定IDE监听的端口（默认9003，需与IDE一致）
xdebug.client_port=9003
; 自动启动调试会话（可选：'yes'表示所有请求都触发，'trigger'表示通过Cookie/GET参数触发）
xdebug.start_with_request=yes
; 可选：设置IDE标识（如PHPSTORM、VSCode），用于区分不同工具
xdebug.idekey=PHPSTORM

修改完成后，保存文件。

三、重启Web服务器：使配置生效

Apache：sudo systemctl restart apache2
Nginx+PHP-FPM：sudo systemctl restart php{version}-fpm && sudo systemctl restart nginx（将{version}替换为实际PHP版本，如8.1）。

四、配置IDE：建立与Xdebug的连接

1. Visual Studio Code（推荐新手）

安装扩展：在扩展商店搜索“PHP Debug”并安装。

创建调试配置：点击左侧“运行”图标→“创建launch.json文件”→选择“PHP Debug”，修改配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/var/www/html": "${workspaceFolder}"  // 将服务器项目路径映射到本地工作区
            }
        }
    ]
}

启动调试：点击顶部“开始调试”按钮（绿色三角形），VS Code会进入监听状态。

2. PhpStorm（专业级工具）

打开设置：File → Settings → Languages & Frameworks → PHP → Servers，点击“+”添加服务器：
- 名称：Local（自定义）
- 主机：localhost
- 端口：80（或Nginx的443端口）
- 勾选“Use path mappings”，将服务器路径（如/var/www/html）映射到本地项目路径。
配置调试：Settings → PHP → Debug，确保“Xdebug”选项已启用，端口设置为9003。

五、开始调试：设置断点与执行

设置断点：在代码行号左侧点击，出现红色圆点即为断点（如$result = $db->query($sql);）。
触发调试：
- 若xdebug.start_with_request=yes，直接访问页面（如http://localhost/index.php）即可触发。
- 若设置为trigger，需在浏览器中安装Xdebug Helper插件（Chrome/Firefox），点击插件图标开启调试模式后访问页面。
调试操作：当代码执行到断点时，IDE会暂停并显示：
- 变量值（悬停鼠标或查看“变量”面板）
- 调用栈（“调用堆栈”面板）
- 当前执行的代码行（红色高亮）
  可通过“继续”“单步跳过”“单步进入”等按钮控制执行流程。

六、辅助调试技巧（可选）

错误日志：在代码中添加ini_set('display_errors', 1); ini_set('log_errors', 1); ini_set('error_log', '/var/log/php_errors.log');，将错误信息输出到指定文件。
var_dump/print_r：快速打印变量值（如var_dump($array);），适合简单调试。
日志记录：使用error_log("Debug: ".$variable);将关键信息写入日志，避免影响页面显示。

通过以上步骤，即可在Debian系统下使用Xdebug完成PHP代码的调试。根据实际需求选择IDE（VS Code适合轻量级调试，PhpStorm适合大型项目），并灵活运用辅助技巧，能快速定位和解决问题。