Windows 10 下使用 PHPStorm 开发/调试， Docker + Swoole + XDebug + Hyperf
2020/5/5 5:26:16
本文主要是介绍Windows 10 下使用 PHPStorm 开发/调试， Docker + Swoole + XDebug + Hyperf，对大家解决编程问题具有一定的参考价值，需要的程序猿们随着小编来一起学习吧！
图片来源于网络，如果侵犯到您的权利，请与我联系。
前言
Xdebug 应该有很多人并不会陌生，调试安装虽然有些繁琐，但是使用起来还是很顺手。
Docker 和 Swoole ，近年来也是很火，就是不便于调试，很多人看到标题的第一反应「Swoole 不是和 Xdebug 不兼容吗？」，
是的，在 Swoole 的官方文档中就明确指出了 Swoole 和 Xdebug 不兼容。
但是，强大的社区还是给了我们答案：SDEBUG
Sdebug 是 fork 自 Xdebug 2.7 ，可用于 Swoole 环境进行断点、调试的一个工具。
运行环境
| 软件 | 版本 |
|---|---|
| Windows 10 专业版 | 1909 |
| PHPStorm | 2020.1 |
| Docker Desktop | 2.2.0.5(43884) |
| Docker | 19.03.8 |
| Hyper-V | latest |
| Hyperf (PHP Framework) | 1.1.25 (hyperf-skeleton create) |
| Sdebug | 2.7 |
| PHP | 7.3.12 |
开始安装
Docker && Docker Desktop
Docker 在 Windows 下可以通过 官网下载 ，但是需要注意有以下限制。
- 64 位操作系统
- 4G 以上的 RAM
- BIOS 中开启虚拟化
- Windows 专业版及以上
- 开启 Hyper-V
这里我并不打算展开介绍，因为类似的文章实在太多了，确保 Docker 安装完成。
当安装完成后，在你的桌面任务栏会出现一个 静态 Docker 的小图标,注意，这里强调一下 静态 静态图标表示 Docker 在运行中，动态则表示处于启动中等非运行状态，然后右键点击，选择 Settings ,我们需要打开两个选项。
- 1、启用 TCP 连接
- 2、设置国内的 Docker Hub 镜像
{
"registry-mirrors": [
"http://hub-mirror.c.163.com"
],
"insecure-registries": [],
"debug": true,
"experimental": false
}
现在，选择右下角的 Apply & Restart 等待 Docker 重启，如果 Docker 没有重启，可以手动点击任务栏 Docker 图标的 Restart ，重启完成后，执行命令检查。
$ docker info Labels: Experimental: false Insecure Registries: 127.0.0.0/8 Registry Mirrors: http://hub-mirror.c.163.com/ Live Restore Enabled: false Product License: Community Engine
现在你应该可以看到网易的镜像地址。
开始吧
检查连接
能否进行调试的重要因素就是 Docker 容器能否和宿主机进行通信，否则，以下都是白扯。
使用 PowersShell 或者 Cmder
$ cat C:/Windows/System32/drivers/etc/hosts|findstr host.docker.internal 192.168.3.22 host.docker.internal
执行后你应该可以看到输出了一个 192.168.x.x 的 IP ，映射到了 host.docker.internal，请记住这个 IP。
现在执行如下命令,运行一个 alpine linux 容器，并执行一个 ping 命令，但是你在这里是看不到输出的。
- 扩展阅读
Networking features in Docker Desktop for Windows | Docker Documentation
$ docker run -di alpine:latest a8369f4e057e161c2079281e4bfbc31dc509f802e3ce0c2f09708cd8613459ae
接着执行以下命令获取到容器的 ID ,其实在上一条执行完毕我们就已经得到了容器 ID。
$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES a8369f4e057e alpine:latest "/bin/sh" About a minute ago Up About a minute pensive_lehmann
使用 docker exec 打开可以可以和容器交互的命令行。
$ docker exec -it a8369f4e057e sh
一般我们看到的命令都是 docker exec -it <CONTAINER ID> /bin/bash ，但是 alpine 没有 /bin/bash 这个位置，所以这里我们直接用 sh 即可。
在进去终端后，我们从新执行一下 ping 命令。
/ # ping 192.168.3.22 PING 192.168.3.22 (192.168.3.22): 56 data bytes 64 bytes from 192.168.3.22: seq=0 ttl=37 time=1.003 ms 64 bytes from 192.168.3.22: seq=1 ttl=37 time=0.937 ms 64 bytes from 192.168.3.22: seq=2 ttl=37 time=1.026 ms 64 bytes from 192.168.3.22: seq=3 ttl=37 time=1.141 ms ^C --- 192.168.3.22 ping statistics --- 4 packets transmitted, 4 packets received, 0% packet loss round-trip min/avg/max = 0.937/1.026/1.141 ms
如果能输出正常的 ping 信息，说明我们的 docker 容器内部可以和主机通信了。
如果不行，可以尝试 ping 192.168.56.1。
如果这两个命令都 ping 不通，我觉得你就没必要看了，😨因为最基本的就是要做到 Docker 容器内部和宿主机通信，才能
使用 Xdebug，如果你只是想搭建一个开发环境，那么你还可以继续看下去。
接下来的内容，我会带你使用 Dockerfile 构建一个自己的 Docker PHP 开发环境。
Docker
安装 PHP
大多数情况下，我都会选用最新的 PHP 作为开发使用，除非项目要求使用旧版，这里就属于情况例外。因为 Sdebug 是基于 Xdebug 2.7 的，
而 Xdebug 2.7 是不支持最新的 PHP 7.4 的，所以我们只能到 Docker Hub PHP Library 选择一个较新的 php:7.3.17-cli-alpine3.11 这个 tag。
新建一个 php.dockerfile 文件，并安装一些必要的扩展和 Composer。
FROM php:7.3.17-cli-alpine3.11
# 现在我们需要配置一些东西。
# 编译参数，用于指定 Swoole 版本
ARG swoole_ver
# 保存到环境变量，如果没有传递就给默认值
ENV SWOOLE_VER=${swoole_ver:-"v4.4.15"}
# apk 是 alpine 的一个包管理器
# set -ex 是为了在出错时及时停掉脚本
RUN set -ex \
# 在临时目录进行这一切
&& cd /tmp \
# 把 apk 的默认源改为aliyun镜像
&& sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories \
# 更新包列表
&& apk update \
# 添加这么多扩展是因为后面我们编译 swoole 和 sdebug 需要用到
&& apk add vim git autoconf openssl-dev build-base zlib-dev re2c libpng-dev oniguruma-dev
# install composer
RUN cd /tmp \
# 从aliyun 下载composer
&& wget https://mirrors.aliyun.com/composer/composer.phar \
&& chmod u+x composer.phar \
&& mv composer.phar /usr/local/bin/composer \
# 给 composer 设置aliyun镜像
&& composer config -g repo.packagist composer https://mirrors.aliyun.com/composer \
# 把 composer 全局命令加入 PATH ，以确保以后我们会用到
&& echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc
# php ext
RUN php -m \
# docker-php-ext-install 是 php 为我们提供的指令，让我们可以安装一些 php 的预设扩展
# 可以在这里启用必要的扩展
&& docker-php-ext-install gd pdo_mysql mysqli sockets pcntl \
# 现在可以检查一下 php 已经安装的扩展
&& php -m
这样我们的镜像就可以运行 php 了，但是接下来我们还要安装 swoole 。
安装 Swoole
如果用过 PECL 的朋友可能会知道，Swoole、PhpRedis 可以用 PECL 直接安装，但是 PECL 安装因为下载比较慢，所以我们这里
采用 Swoole 官方在国内的仓库 。
# install swoole
RUN cd /tmp \
# from mirrors
&& git clone https://gitee.com/swoole/swoole swoole \
&& cd swoole \
# 切换到指定版本的 tag
&& git checkout ${SWOOLE_VER} \
&& phpize \
# 执行configure命令
&& ./configure --enable-openssl --enable-sockets --enable-http2 --enable-mysqlnd \
&& make \
&& make install \
# 通过 docker-php-ext-enable 来启用扩展，这个命令也是 php 为我们提供的。
&& docker-php-ext-enable swoole \
# 检查 php 已经安装的模块
&& php -m \
# 检查 swoole 是否正确安装
&& php --ri swoole
安装 Sdebug
Sdebug 源代码托管在了 Github 上面，众所周知，因为一些原因，Github 下载速度很慢，所以我们需要使用到国内镜像，
但是 Sdebug 在国内貌似也没有镜像，所以就要我们自己动手了，到 码云 ，注册一个帐号，然后新建项目选择从 Github 导入，
这样我们就能创建一个仓库的镜像了，我已经创建好了一个 Sdebug ，如果你介意的话，可以自己创建一个，方法就在上面。
安装 Sdebug 的过程和 Swoole 几乎完全一样，但是也要注意一些点，接下来在 Dockerfile 中我将会详细注释
# install sdebug
# 运行克隆前，先把目录切换到 /tmp ，避免之前的命令导致目录错误
RUN cd /tmp \
# from mirrors
&& git clone https://gitee.com/vyi/sdebug sdebug \
# 进入克隆的目录
&& cd sdebug \
# 切换到 sdebug_2_7 分支，这里一定到切换分支，因为 master 分支是 Xdebug 的源码
&& git checkout sdebug_2_7 \
&& phpize \
&& ./configure --enable-xdebug \
&& make \
&& make install \
# 这里 安装完成后执行的值 xdebug
&& docker-php-ext-enable xdebug \
&& php -m \
# 这里检查也是哟,注意是 sdebug
&& php --ri sdebug
现在一切都安装完成了，我们还需要对 swoole 和 sdebug 进行简单的配置，跟刚才一样，这里还是使用 Dockerfile 指令/usr/local/etc/php/conf.d 这个位置是 php 默认会扫描的 ini 加载目录，我们可以执行php --ini命令检查
/mnt/d/htdocs/tom # php --ini Configuration File (php.ini) Path: /usr/local/etc/php Loaded Configuration File: (none) Scan for additional .ini files in: /usr/local/etc/php/conf.d Additional .ini files parsed: /usr/local/etc/php/conf.d/99-xdebug-enable.ini, /usr/local/etc/php/conf.d/docker-php-ext-gd.ini, /usr/local/etc/php/conf.d/docker-php-ext-mysqli.ini, /usr/local/etc/php/conf.d/docker-php-ext-pcntl.ini, /usr/local/etc/php/conf.d/docker-php-ext-pdo_mysql.ini, /usr/local/etc/php/conf.d/docker-php-ext-redis.ini, /usr/local/etc/php/conf.d/docker-php-ext-sockets.ini, /usr/local/etc/php/conf.d/docker-php-ext-sodium.ini, /usr/local/etc/php/conf.d/docker-php-ext-swoole.ini, /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
可以看到以下内容,也就是说他会在这里扫描配置文件
Scan for additional .ini files in: /usr/local/etc/php/conf.d
# config php
RUN cd /usr/local/etc/php/conf.d \
# swoole config
# 关闭 swoole 短名称，使用 Hyperf 这个是必须要
&& echo "swoole.use_shortname = off" >> 99-off-swoole-shortname.ini \
# config xdebug
&& { \
# 添加一个 Xdebug 节点
echo "[Xdebug]"; \
# 启用远程连接
echo "xdebug.remote_enable = 1"; \
# 这个是多人调试，但是现在有些困难，就暂时不启动
echo ";xdebug.remote_connect_back = On"; \
# 自动启动远程调试
echo "xdebug.remote_autostart = true"; \
# 这里 host 可以填前面取到的 IP ，也可以填写 host.docker.internal 。
echo "xdebug.remote_host = host.docker.internal"; \
# 这里端口固定填写 19000 ，当然可以填写其他的，需要保证没有被占用
echo "xdebug.remote_port = 19000"; \
# 这里固定即可
echo "xdebug.idekey=PHPSTORM"; \
# 把执行结果保存到 99-xdebug-enable.ini 里面去
} | tee 99-xdebug-enable.ini
host.docker.internal 和 19000 这两个是必然关系，这 host 指向的是宿主机，端口是 PHP Storm 监听的端口，docker 需要把请求发送过去，所以这里需要确保没有被占用。
- 扩展阅读
Networking features in Docker Desktop for Windows | Docker Documentation
安装 PhpRedis
因为项目需要连接 Redis 所以使用这个扩展，这个只是一个连接库，并不是 Redis。
# install phpredis
RUN cd /tmp \
# from mirrors
&& git clone https://gitee.com/mirrors/phpredis phpredis \
&& cd phpredis \
&& phpize \
&& ./configure \
&& make \
&& make install \
&& docker-php-ext-enable redis \
&& php -m \
&& php --ri redis
杂项配置
# check
# 检查一下 PHP 版本信息和 已安装的模块
RUN cd /tmp \
# 检查 PHP 版本
&& php -v \
# 检查已安装的模块
&& php -m \
&& echo -e "Build Completed!"
# 暴露 9501 端口
EXPOSE 9501
# 设置工作目录，即默认登录目录，这个目录现在并不存在，
# 我们需要在 run 时把我们外部 windows 的文件目录映射到 docker 容器中去
WORKDIR /mnt/d/htdocs
Dockerfile
现在我们的 Dockerfile 应该已经是下面的样子
FROM php:7.3.17-cli-alpine3.11
# 现在我们需要配置一些东西。
# 编译参数，用于指定 Swoole 版本
ARG swoole_ver
# 保存到环境变量，如果没有传递就给默认值
ENV SWOOLE_VER=${swoole_ver:-"v4.4.15"}
# apk 是 alpine 的一个包管理器
# set -ex 是为了在出错时及时停掉脚本
RUN set -ex \
# 在临时目录进行这一切
&& cd /tmp \
# 把 apk 的默认源改为aliyun镜像
&& sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories \
# 更新包列表
&& apk update \
# 添加这么多扩展是因为后面我们编译 swoole 和 sdebug 需要用到
&& apk add vim git autoconf openssl-dev build-base zlib-dev re2c libpng-dev oniguruma-dev
# install composer
RUN cd /tmp \
# 从aliyun 下载composer
&& wget https://mirrors.aliyun.com/composer/composer.phar \
&& chmod u+x composer.phar \
&& mv composer.phar /usr/local/bin/composer \
# 给 composer 设置aliyun镜像
&& composer config -g repo.packagist composer https://mirrors.aliyun.com/composer \
# 把 composer 全局命令加入 PATH ，以确保以后我们会用到
&& echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc
# php ext
RUN php -m \
# docker-php-ext-install 是 php 为我们提供的指令，让我们可以安装一些 php 的预设扩展
# 可以在这里启用必要的扩展
&& docker-php-ext-install gd pdo_mysql mysqli sockets pcntl \
# 现在可以检查一下 php 已经安装的扩展
&& php -m
# install swoole
RUN cd /tmp \
# from mirrors
&& git clone https://gitee.com/swoole/swoole swoole \
&& cd swoole \
# 切换到指定版本的 tag
&& git checkout ${SWOOLE_VER} \
&& phpize \
# 执行configure命令
&& ./configure --enable-openssl --enable-sockets --enable-http2 --enable-mysqlnd \
&& make \
&& make install \
# 通过 docker-php-ext-enable 来启用扩展，这个命令也是 php 为我们提供的。
&& docker-php-ext-enable swoole \
# 检查 php 已经安装的模块
&& php -m \
# 检查 swoole 是否正确安装
&& php --ri swoole
# install sdebug
# 运行克隆前，先把目录切换到 /tmp ，避免之前的命令导致目录错误
RUN cd /tmp \
# from mirrors
&& git clone https://gitee.com/vyi/sdebug sdebug \
# 进入克隆的目录
&& cd sdebug \
# 切换到 sdebug_2_7 分支，这里一定到切换分支，因为 master 分支是 Xdebug 的源码
&& git checkout sdebug_2_7 \
&& phpize \
&& ./configure --enable-xdebug \
&& make \
&& make install \
# 这里 安装完成后执行的值 xdebug
&& docker-php-ext-enable xdebug \
&& php -m \
# 这里检查也是哟,注意是 sdebug
&& php --ri sdebug
# config php
RUN cd /usr/local/etc/php/conf.d \
# swoole config
# 关闭 swoole 短名称，使用 Hyperf 这个是必须要
&& echo "swoole.use_shortname = off" >> 99-off-swoole-shortname.ini \
# config xdebug
&& { \
# 添加一个 Xdebug 节点
echo "[Xdebug]"; \
# 启用远程连接
echo "xdebug.remote_enable = 1"; \
# 这个是多人调试，但是现在有些困难，就暂时不启动
echo ";xdebug.remote_connect_back = On"; \
# 自动启动远程调试
echo "xdebug.remote_autostart = true"; \
# 这里 host 可以填前面取到的 IP ，也可以填写 host.docker.internal 。
echo "xdebug.remote_host = host.docker.internal"; \
# 这里端口固定填写 19000 ，当然可以填写其他的，需要保证没有被占用
echo "xdebug.remote_port = 19000"; \
# 这里固定即可
echo "xdebug.idekey=PHPSTORM"; \
# 把执行结果保存到 99-xdebug-enable.ini 里面去
} | tee 99-xdebug-enable.ini
# install phpredis
RUN cd /tmp \
# from mirrors
&& git clone https://gitee.com/mirrors/phpredis phpredis \
&& cd phpredis \
&& phpize \
&& ./configure \
&& make \
&& make install \
&& docker-php-ext-enable redis \
&& php -m \
&& php --ri redis
# check
# 检查一下 PHP 版本信息和 已安装的模块
RUN cd /tmp \
# 检查 PHP 版本
&& php -v \
# 检查已安装的模块
&& php -m \
&& echo -e "Build Completed!"
# 暴露 9501 端口
EXPOSE 9501
# 设置工作目录，即默认登录目录，这个目录现在并不存在，
# 我们需要在 run 时把我们外部 windows 的文件目录映射到 docker 容器中去
WORKDIR /mnt/d/htdocs
以上就是我们完整的 Dockerfile，现在我们要来生成一下镜像文件
docker build -f php.dockerfile -t faqqcn/php-swoole-sdebug:1.0 .
- -f 表示我们要使用那个 dockerfile 文件
- -t 表示为我们的镜像起一个名字格式
<domain>/<name>:<tag> - . 最后的
.表示当前目录
Successfully built 9c5c20556cf2 Successfully tagged faqqcn/php-swoole-sdebug:1.0 SECURITY WARNING: You are building a Docker image from Windows against a non-Windows Docker host. All files and directories added to build context will have '-rwxr-xr-x' permissions. It is recommended to double check and reset permissions for sensitive files and directories.
输出以上内容说明镜像制作成功了，现在来看一下。
$ docker image ls REPOSITORY TAG IMAGE ID CREATED SIZE faqqcn/php-swoole-sdebug 1.0 9c5c20556cf2 About a minute ago 526MB
现在来运行一下
$ docker run -di -p 8080:9501 -v D:/2vy-cc/htdocs:/mnt/d/htdocs --name php-swoole-sdebug faqqcn/php-swoole-sdebug:1.0 19db6032c9fe9cd2228844e4c029c980f14172991a4f113480ee5facd1763c2e
- 参数解释
| 参数 | 说明 |
|---|---|
| -di | 这是两个参数 -d 和 -i 的简写，d 表示后台运行，i 表示交互操作 |
| -p | 启用一个端口映射，把宿主机的 8080 和 容器 内的 9501 映射 |
| -v | 启用一个目录映射，把宿主机的 D:/2vy-cc/htdocs 目录和 容器内的 /mnt/d/htdocs 映射 |
| --name | 给容器起一个名字，方便下次启动、停用、删除、日志 |
更多参数详见 Docker run 命令
最后面就跟上我们镜像的名字，然后 docker 会输出一个容器的 id
现在进入容器。
docker exec -it php-swoole-sdebug sh
-it 表示创建一个交互操作和创建一个终端，后面跟刚刚上面的 name ，最后跟一个启动的 shell ， alpine 默认是 sh
进入到终端内后检查一下 php 信息，并创建一下项目
# php -v
PHP 7.3.17 (cli) (built: Apr 24 2020 18:12:13) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.17, Copyright (c) 1998-2018 Zend Technologies
with Sdebug v2.7.3-dev, Copyright (c) 2002-2019, by Derick Rethans
# php
[PHP Modules]
Core
ctype
curl
date
dom
fileinfo
filter
ftp
gd
hash
iconv
json
libxml
mbstring
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
sdebug
session
SimpleXML
sockets
sodium
SPL
sqlite3
standard
swoole
tokenizer
xml
xmlreader
xmlwriter
zlib
[Zend Modules]
Sdebug
# composer
______
/ ____/___ ____ ___ ____ ____ ________ _____
/ / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 1.10.5 2020-04-10 11:44:22
可以看到已经安装 swoole、redis、Sdebug、composer ，接下来我们将创建一个 Hyperf 项目
创建项目
# composer create-project hyperf/hyperf-skeleton
安装过程中会有一个引导，这里你可以全部敲回车默认，也可以根据需要选择自己要用的组件。
现在进入项目，并启动。
cd hyperf-skeleton php bin/hyperf.php start
你将会看到一切错误蹦了出来，但是不要担心，如果你细看，你会发现这是 Redis 的错误，稍后我们来解决它。
为了我们愉快的开发，如果每次修改文件后我们都要来执行一下上面的命令，岂不是很麻烦，
我们现在来安装一个自动文件修改后自动重启的工具 hyperf-watch。
# curl -o watch https://gitee.com/liangguifeng/hyperf-watch/raw/master/watch # ls -alF | grep watch -rwxr-xr-x 1 root root 3921 May 4 07:40 watch*
如果这里的 watch 权限中没有 x 我们就手动给他加一下
chmod +x watch
现在我们执行 php watch。然后在宿主机中打开 PHPStorm ，开始在 PHPStorm 里面写代码，并配置 Sdebug。
PHPStorm
打开文件
- config/autoload/async_queue.php
修改里面的 'processes' => 1, 为 'processes' => 0, 注意，这里是指关掉异步队列，从而来解决
控制台中的 Redis 错误，如果你需要使用到异步队列，请把这里保持不变，并且到 config/autoload/redis.php 中正确配置 redis 链接信息。
保存后，看到控制台会自动重启，现在页面已经不会报错了，在浏览器中访问试试，刚刚我们把宿主机的 8080 映射到了主机内的 9501 端口，
所以我们直接访问本机的 8080 端口。
OK，现在我们已经可以访问到 docker 中部署的项目了，接下来配置调试。
打开 PHPStorm 设置 进入 Languages & Frameworks | PHP ，看起来是下面这样。
点击这里的 ...
选择 + 并选择 From Docker ...
如果这里没有出现 successful 这说明你在第一步出错了，没有启用 TCP 连接，选择上这里后重启 docker
这里选择镜像。
检查确认后 ok
现在进去这里从新选择选择一下容器和本机的映射关系，帮助我们在调试是找到对应的文件，否则会调试失败。
先删除已有的映射关系，选中默认的映射
然后点击上一行的 Mapping 进去添加
现在添加一下目录映射关系
现在，在打开设置 Languages & Frameworks | PHP | Debug
创建一个服务，并填写对应的信息，并且请记住 Name XDEBUG_02 这个名字
新建一个调试
添加一个配置
现在点击右上角的电话，让他变成这个状态。
启动调试吧!
切换到容器窗口，结束掉先前的命令，现在我们执行 php watch ,你会发现卡住了！！！这特喵什么鬼呀？这就说明 Xdebug 开始工作了
切换到 PHPStorm ，你会发现左边的跳过按钮断点按钮绿了，现在我们从新点到 Debugger 栏目下，你会发现有一个错误。而且 IDE 中没效果。
因为这还么有真正完成。
现在我们来解决它 ，根据错误错误信息，我们简单了解到，是需要以环境变量，叫 PHP_IDE_CONFIG ，点击 more info...,
进去 PHPStorm 的文档页面，检索一下 PHP_IDE_CONFIG ，发现要让我们配置一个叫 serverName 的参数，
就是前面创建的 Server ，用来映射本地文件。
因为我们调试的是容器内的 cli ，所以我们切入到容器的终端，输入以下内容
export PHP_IDE_CONFIG=serverName=XDEBUG_02
然后在执行 php watch 。
现在你就会看，我们在 watch 的时候，断点就开始工作了。
现在你进行调试的话，你会发现下面的调试栏，有时候会有好几个 hyperf.php 来回切，很是干扰，
这是因为项目默认配置了使用多个 worker ，你可以在这里把他改成 1。
业务调试
现在试试开始调试业务代码吧！
进入默认的控制器，下个断点。
打开浏览器刷新，你会发现，并没有发生变化，貌似没有捕获到断点。
这时候只需要在URl加上参数 XDEBUG_SESSION_START=PHPSTORM ，
URL 变成了 http://localhost:8080/?XDEBUG_SESSION_START=233
好了现在我们可以看到 PHPStorm 中成功加载到了断点了。
如果你觉得这样麻烦，可以安装一个 Chrome 扩展 Xdebuge Helper 。
安装以后在插件栏右键选择 选项 ，在 IDE Key 中选择 PHPSTORM 然后 save，回到页面，
左键点击插件栏的虫子，选择 Debug ，现在刷新页面，PHPStorm 就能自动捕获到 Debug 了。
在 POSTMAN 中调试
一般的 GET 请求我们可以在浏览器直接调试，但是有时候需要发送 header 或者 post 的时候，
就会选择 POSTMAN 这种工具进行请求，这时候我们只需要在请求参数中加上 XDEBUG_SESSION_START=PHPSTORM 这个参数就行了
也可以 在 Cookie 中添加 XDEBUG_SESSION=PHPSTORM 也可以触发调试。
完结。
整篇下来，比之前那一篇文章还要复杂，但是我已经尽量去用较少的内容讲清楚更多的东西，开发时我们总是离不开调试。
如果你有别的想法或者好的建议可以直接与我联系，如您发现文章内容有错误欢迎指出。
如果你对远程调试还感兴趣，可以看看我的另一篇文章，用来介绍 XDEBUG 远程调试。
Xdebug 远程调试，你会用吗？
参考内容
- Networking features in Docker Desktop for Windows | Docker Documentation
- Debug a PHP CLI script - Help | PhpStorm
- hyperf-watch
- 安装 - Hyperf
- mabu233/sdebug: Xdebug — Step Debugger and Debugging Aid for PHP
这篇关于Windows 10 下使用 PHPStorm 开发/调试， Docker + Swoole + XDebug + Hyperf的文章就介绍到这儿，希望我们推荐的文章对大家有所帮助，也希望大家多多支持为之网！
- 2024-11-23怎么实现安卓+php 热更新方案？-icode9专业技术文章分享
- 2024-11-22PHP 中怎么实现判断多个值是否为空、null 或者为 false？-icode9专业技术文章分享
- 2024-11-11开源 PHP 商城项目 CRMEB 二次开发和部署教程
- 2024-11-09怎么使用php在kaufland平台刊登商品？-icode9专业技术文章分享
- 2024-11-05PHP的抽象类和接口是什么，有什么区别-icode9专业技术文章分享
- 2024-11-01开源 PHP 商城项目 CRMEB 安装和使用教程
- 2024-11-01用php和mysql写无限分类，有哪几种方法-icode9专业技术文章分享
- 2024-10-31php数据分表导出时部分数据无法导出什么原因-icode9专业技术文章分享
- 2024-10-30有经验的 PHP 开发者学习一门新的编程语言，有哪些推荐的有前景的语言-icode9专业技术文章分享
- 2024-10-21php 检测图片是否篡改过-icode9专业技术文章分享
