Laradock 使用 PhpStorm Debug 代码

Mortence 的个人博客 / 2241 / 7 / 创建于 5年前 / 更新于 3年前

安装 Xdebug 扩展

编辑 laradock 目录下 .env 文件，修改以下两项

WORKSPACE_INSTALL_XDEBUG=true
PHP_FPM_INSTALL_XDEBUG=true

修改后执行 docker-compose build php-fpm workspace 使配置生效

配置 Xdebug

编辑 laradock/workspace/xdebug.ini 及 laradock/php-fpm/xdebug.ini，具体配置如下

  xdebug.remote_host=docker.for.win.localhost
  xdebug.remote_connect_back=0
  xdebug.remote_port=9000
  xdebug.idekey=PHPSTORM

  xdebug.remote_autostart=0
  xdebug.remote_enable=0
  xdebug.cli_color=0
  xdebug.profiler_enable=0
  xdebug.profiler_output_dir="~/xdebug/phpstorm/tmp/profiling"

  xdebug.remote_handler=dbgp
  xdebug.remote_mode=req

  xdebug.var_display_max_children=-1
  xdebug.var_display_max_data=-1
  xdebug.var_display_max_depth=-1

- 其中 remote_host 很关键。我使用的是 windown，如使用 Mac 应修改为 docker.for.mac.localhost **
  配置 PhpStorm

配置 PHP server，具体配置如图

** 其中server name 需和 laradock 目录中 .env 文件中 PHP_IDE_CONFIG 配置项一致，默认为 laradock **
配置、验证 Xdebug
- 配置保持默认配置即可，修改完配置后需校验配置
- 点击 Validate 后界面如图
  
  点击下方 Validate 按钮，校验成功后如图
  
  填写校验脚本地址时，需注意，如项目为 laravel ，目录必须为 public 目录。在这一步我被坑了很久，直接填写项目目录校验会 404
- 添加 debug 项目配置
  run -> Edit Configurations，添加 PHP Remote Debug。其中 server 为 laradock 的 PHP_IDE_CONFIG 配置项，默认为 laradock，IDE key 为 PhpStorm。如图：
- 配置完成后，选择上一步配置的 remote debug 启功，设置断点，刷新浏览器项目网页，即可开始调试