phpEnv与Docker Desktop完全独立，phpEnv管理宿主机PHP版本，Docker Desktop运行容器内PHP，二者互不感知、不可混用；docker-compose中PHP版本由image字段或Dockerfile的FROM指令决定，与宿主机phpEnv无关。
phpEnv 和 Docker Desktop 是两套完全独立的环境管理工具，不能配合使用，也不建议混用。这是关键前提。
phpEnv 是一个用于在宿主机（Windows/macOS/Linux）上本地安装多个 PHP 版本并快速切换的命令行工具，类似 pyenv 或 nvm，它直接修改系统 PATH、软链接 php 命令，所有 PHP 进程跑在宿主机上。
而 Docker Desktop 是容器运行时平台，它启动的是隔离的 Linux 容器，PHP 运行在容器内部，与宿主机的 PHP（包括 phpEnv 管理的版本）完全无关。
为什么 docker-compose.yml 里写 php:8.3-fpm 却不走 phpEnv？
-
docker-compose启动的服务只依赖镜像层和容器内配置，根本不会读取、调用或感知宿主机上的phpEnv。 - 即使你在 Windows 上用
phpEnv装了 PHP 8.1，php:8.3-fpm容器仍会从官方镜像拉取完整的 8.3 运行时，包含自己的php.ini、扩展、二进制路径（如/usr/local/bin/php）。 - 宿主机的
php命令对容器内进程零影响 —— 就像你电脑装了 Excel，但 WSL 里的 Ubuntu 不会因此多出一个 Excel。
常见误操作及后果
- 把
phpEnv当作“Docker 的 PHP 版本管理器”：- 错。Docker 的 PHP 版本由
image:字段决定（如php:8.2-fpm-alpine），不是宿主机命令。
- 错。Docker 的 PHP 版本由
- 在
Dockerfile里写RUN php --version期望看到phpEnv的输出：- 错。该命令执行的是容器内 PHP，和宿主机
phpEnv无任何关联。
- 错。该命令执行的是容器内 PHP，和宿主机
- 试图用
phpEnv切换版本来“影响”docker-compose up行为：- 无效。Compose 启动过程不调用宿主机
php，只调用docker和docker-composeCLI。
- 无效。Compose 启动过程不调用宿主机
正确做法：按场景选工具
-
需要多版本 PHP 快速测试 CLI 脚本、本地 composer install、phar 构建？
立即学习“PHP免费学习笔记（深入）”；
- 用
phpEnv（或shivammathur/phpHomebrew tap /laravel/valet）。
- 用
-
需要完整 LEMP/LEMP 栈、数据库联动、环境隔离、团队一致部署？
- 用
Docker Desktop + docker-compose.yml，PHP 版本直接写死在服务定义里：php: image: php:8.3-fpm # 或 build: ./php → 自定义 Dockerfile 控制版本与扩展
- 用
-
想同时拥有两者？可以，但必须分清边界：
-
phpEnv仅用于宿主机开发辅助（比如跑 PHPUnit、生成 migration、调试 .env 解析逻辑）； -
Docker仅用于运行 Web 请求栈（Nginx → PHP-FPM → MySQL）； - 二者共存不冲突，但绝不交叉调用。
-
实际项目中容易忽略的一点：
当你在 docker-compose.yml 中使用 build: 指向自定义 Dockerfile，且该文件里写了 FROM php:8.2-fpm，那这个 8.2 就是最终容器内的唯一 PHP 版本 —— 无论宿主机有没有 phpEnv、装没装 8.1 或 8.4，都不影响构建结果。镜像构建是封闭、可重现的过程，这点必须刻在脑子里。
