phpEnv是一款集成了PHP、MySQL、Nginx等常用组件的Windows本地开发环境工具,而Docker可以将服务打包为容器。将phpEnv与Docker联动,既能利用phpEnv便捷的PHP版本切换,又能用Docker运行Redis、消息队列等附加服务。下面介绍具体配置方式。

一、在phpEnv中开启Docker相关设置
新版本phpEnv左侧菜单有Docker面板,首次使用需先安装Docker Desktop并启动,然后phpEnv才能识别守护进程。确认状态为已连接后,即可在phpEnv里直接管理容器。
检查Docker环境
- 安装Docker Desktop,开启WSL2后端
- 在phpEnv设置中勾选允许调用Docker命令行
- 终端执行 docker version 验证可用
二、编写docker-compose实现服务容器化
我们可以在phpEnv站点根目录新建 compose.yaml,把MySQL以外的服务放进容器,代码仍由phpEnv的Nginx处理。这样phpEnv负责PHP运行,Docker负责中间件。
version: '3'
services:
redis:
image: redis:7-alpine
ports:
- "6379:6379"
volumes:
# 挂载持久化数据,路径用正斜杠
- ./redis_data:/data
rabbitmq:
image: rabbitmq:3-management
ports:
- "15672:15672"
- "5672:5672"
三、phpEnv与容器网络互通
phpEnv默认在Windows宿主网络,Docker容器在桥接网络。PHP代码连接Redis时,不要写127.0.0.1,而应填容器IP或Docker网关地址。可在phpEnv的hosts中绑定一个名称指向容器。
| 连接方式 | 地址示例 | 说明 |
|---|---|---|
| 直接容器IP | 172.17.0.2 | 不稳定,重启可能变 |
| 宿主机网关 | host.docker.internal | Docker推荐用法 |
PHP中调用示例
使用Predis连接宿主机上的Docker Redis容器:
<?php
// 通过docker网关访问redis容器
$client = new PredisClient([
'scheme' => 'tcp',
'host' => 'host.docker.internal',
'port' => 6379,
]);
$client->set('test', 'hello_from_phpEnv');
echo $client->get('test');
四、用phpEnv管理联动流程
日常开发时,在phpEnv启动对应PHP站点,终端进入项目目录运行 docker compose up -d 拉起容器。代码改动由phpEnv热加载,服务依赖在Docker中隔离。停服时先停容器再关phpEnv,避免端口占用。
注意:若phpEnv自带MySQL而你又起了Docker MySQL,需修改其中之一端口,例如Docker映射为3307,防止冲突。
五、常见问题处理
- 容器连不上:检查防火墙是否放行端口,以及host.docker.internal是否可解析
- 权限问题:Windows目录挂载到容器常遇写权限不足,可在compose中加 user: "1000:1000"
- PHP扩展:phpEnv内开启redis扩展后,代码才能用上面类库
按照上述步骤,phpEnv配置Docker容器并不复杂,联动开发既能保留本地调试方便,又获得容器化部署的一致性。