PHPStorm 在 laradock 下进行 Xdebug 断点调试

laradock 配置

编辑 laradock/.env 文件

WORKSPACE_INSTALL_XDEBUG=true
PHP_FPM_INSTALL_XDEBUG=true

重新构建容器

docker-compose build workspace php-fpm
# 启动
docker-compose up -d nginx mysql redis

贴一下 workspace/xdebug.ini & php-fpm/xdebug.ini 默认配置，新手不要拷贝网上教程配置，保持默认配置就可以，这里只解释一个参数 xdebug.remote_connect_back=1 表示动态捕获来源 host，不需要设置 xdebug.remote_host，如果设置等于 0，则需要指定 xdebug.remote_host 地址

; xdebug.remote_host=dockerhost
; Mac 系统需要设置remote_host
; xdebug.remote_host=docker.for.mac.localhost
; xdebug.remote_host=docker.for.mac.host.internal
xdebug.remote_connect_back=1
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

PHPStorm 配置

打开 PHPStorm， File -> Settings 进入 Languages & Frameworks -> PHP -> Servers。新建一个 Servers，如下图

• Name 填写内容必须和 laradock/.env 文件 serverName 一致，默认为 laradock
• host 为 server 对应的 host 地址；Port 不用修改；Debugger 选择 Xdebug
• 设置目录映射(Use path mappings)，本地目录 -> 远程目录

### Remote Interpreter ####################################

# Choose a Remote Interpreter entry matching name. Default is `laradock`
PHP_IDE_CONFIG=serverName=laradock

设置断点，点击电话按钮启动监听就可以进行断点调试了