WSL2 Ubuntu20.04 Laravel Sail & vscode安装xDebug

hi，我是温新，一名PHPer

保持热爱

windows11下，WSL Ubuntu20.04，使用Laravel Sail开发时，安装xDebug断点调试。使用 vscode 作为开发工具使用，只需要安装相关插件即可，需要多余的操作。

前提，假设已经有Laravel Sail的项目。

第一步：编辑 Dockerfile 文件

Dockerfile 文件中添加如下内容：

ARG XDEBUG

# 如果php安装了xdebug扩展
# 则可能不用添加如下命令
RUN if [ ${XDEBUG}] ; then \
    apt-get install -y php-xdebug; \
fi;

第二步：修改 php.ini 文件

php.in 配置文件中添加 XDebug 配置

[XDebug]
zend_extension = xdebug.so
xdebug.mode = debug
xdebug.discover_client_host = true
xdebug.idekey = VSC
xdebug.client_host = host.docker.internal
xdebug.client_port = 9003

第三步：修改 docker-compose.yml

  laravel.test:
    build:
      context: ./docker/8.1
      dockerfile: Dockerfile
      args:
        WWWGROUP: "${WWWGROUP}"
        XDEBUG: ${SAIL_DEBUG}

第四步： .evn添加配置

SAIL_DEBUG=true 

第五步：执行sail

./vendor/bin/sail build --no-cache

第六步：vscode 安装插件

vscode 安装 PHP Debug 插件

第七步： vscode 配置 launch.json 文件

launch.json 配置文件加追加如下配置：

{
     "name": "Listen for XDebug on WSL Sail",
     "type": "php",
     "request": "launch",
     "port": 9003,
     "pathMappings": {
         "/var/www/html": "${workspaceFolder}"
     },
     "hostname": "localhost",
     "xdebugSettings": {
         "max_data": 65535,
         "show_hidden": 1,
         "max_children": 100,
         "max_depth": 5
     }
 }

就这样配置完啦~