PhpStorm配置Docker实战教程

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战，手把手教大家学习《PhpStorm集成Docker配置实操指南》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

PhpStorm可通过Docker配置PHP解释器、Docker Compose多服务环境、CLI命令执行及Xdebug远程调试。具体包括：一、在Settings中添加Docker为PHP解释器并指定镜像；二、通过docker-compose.yml定义服务并在Run配置中启动；三、修改Terminal Shell path或External Tools调用容器内命令；四、配置Xdebug扩展与PhpStorm监听端口一致并启用远程调试。

如果您希望在PhpStorm中直接使用Docker容器作为开发环境，例如运行PHP服务、数据库或Composer依赖管理，则需将Docker作为解释器或服务运行时进行配置。以下是完成PhpStorm与Docker集成的具体操作步骤：

一、配置Docker为PHP解释器

此方法使PhpStorm能调用Docker容器内的PHP二进制文件执行代码检查、调试和单元测试，无需本地安装PHP。

1、打开PhpStorm，进入 File → Settings → Languages & Frameworks → PHP（macOS为PhpStorm → Preferences）。

2、点击右侧PHP Interpreter右侧的…按钮，选择Add...。

3、在弹出窗口左侧选择Docker，右侧选择已安装的Docker连接（如Docker for Windows或Docker for Mac）。

4、在Image name字段中输入有效镜像名，例如php:8.2-cli或自定义构建的镜像标签。

5、点击OK，PhpStorm将拉取镜像并自动挂载项目目录至容器内指定路径（默认为/var/www/html）。

二、使用Docker Compose配置多服务运行环境

当项目依赖MySQL、Redis、Nginx等组件时，可通过docker-compose.yml定义服务拓扑，PhpStorm可直接读取该文件启动完整栈。

1、确保项目根目录下存在有效的docker-compose.yml文件，且包含php服务（如service名称为app）。

2、进入 Run → Edit Configurations...，点击左上角+号，选择Docker-Compose。

3、在Service name中选择目标PHP服务（如app），在Volumes映射中确认项目路径与容器内路径一致（如./:/var/www/html）。

4、勾选Start services before launch，并指定启动后等待的超时时间（建议设为60秒）。

5、点击OK保存配置，点击绿色三角形运行按钮即可启动全部关联容器。

三、配置Docker容器为CLI脚本执行环境

此方式允许在PhpStorm终端或外部工具中直接调用容器内命令，例如运行phpunit、artisan或composer install。

1、进入 File → Settings → Tools → Terminal，修改Shell path为Docker exec命令格式。

2、将Shell path替换为类似以下结构的命令：docker exec -it /bin/sh（需先通过docker-compose up -d启动容器并确认容器名）。

3、在PhpStorm底部打开Terminal面板，输入php --version验证是否返回容器内PHP版本信息。

4、若需在External Tools中调用容器命令，进入 Settings → Tools → External Tools，新增工具，Program填入docker，Arguments填入exec -it php %&（%&代表当前文件路径）。

四、调试PHP代码时连接Docker内Xdebug

启用Xdebug远程调试需确保容器内Xdebug扩展配置与PhpStorm监听端口一致，并正确设置IDE key和主机映射。

1、在Dockerfile或docker-compose.yml的PHP服务中启用Xdebug扩展，配置xdebug.mode=debug、xdebug.client_host=host.docker.internal（Linux需改用宿主机IP）。

2、进入 Run → Edit Configurations → PHP Remote Debug，新建配置，Server name填写已定义的服务器名称（如localhost），IDE key填写PHPSTORM。

3、在PhpStorm右上角点击电话图标旁的Start Listening for PHP Debug Connections按钮。

4、在浏览器中访问目标URL并附加?XDEBUG_SESSION_START=PHPSTORM参数，触发断点命中。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~