在 macos 中用 docker 搭建本地 php 多版本环境，核心是通过 dnmp 项目启动隔离的 php 容器（如 5.6、7.2、7.4、8.0），由 nginx 基于域名路由请求；配置 hosts 和 vhost 即可实现 legacy.test→php56、modern.test→php72；各容器可独立安装扩展、修改 php.ini、启用 xdebug；日常使用 docker-compose 统一管理启停、调试与日志。

在 macos 中用 docker 搭建本地 php 多版本环境，核心是让不同项目各自运行在隔离的容器里，互不干扰。不是装多个 php 到系统，而是为每个版本启动独立服务，再通过 nginx 统一路由和域名分发请求。

选一套开箱即用的方案起步

别从零写 docker-compose 或反复拉镜像。推荐直接使用 DNMP（Docker + Nginx + MySQL + PHP + Redis） 这类成熟项目，比如 Gitee 上的 bruce_qiq/dnmp：

• 已预置 PHP 5.6、7.2、7.4、8.0 等多个官方镜像，每个版本单独一个容器
• 所有服务通过 Docker Compose 管理，一键启停
• Nginx 默认支持虚拟主机（vhost），只需配几个 conf 文件就能按域名路由
• 代码挂载到 www/ 下对应子目录，比如 www/legacy/ 跑 PHP 5.6，www/modern/ 跑 PHP 7.2

配置域名与 Nginx 路由

不需要浏览器插件或端口代理，纯靠 hosts + vhost 就能实现干净访问：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 在 /etc/hosts 中添加两行：
  127.0.0.1 legacy.test
127.0.0.1 modern.test
• 在 DNMP 的 services/nginx/conf/vhost/ 下新建两个配置文件：
  • legacy.test.conf 中 fastcgi_pass php56:9000
  • modern.test.conf 中 fastcgi_pass php72:9000
• 执行 docker-compose exec nginx nginx -s reload 重载配置

扩展与调试按需定制

每个 PHP 容器彼此独立，扩展、ini 设置、Xdebug 都只影响当前版本：

• 进 PHP 5.6 容器安装 Redis 扩展：docker-compose exec php56 sh -c "pecl install redis && docker-php-ext-enable redis"
• 修改某版本的 php.ini：编辑对应容器的挂载配置目录（如 services/php56/conf/php.ini），改完重启该服务即可
• 调试时启用 Xdebug：在对应 PHP 容器的 ini 文件中开启，并把 IDE 配置为监听宿主机 IP（非 127.0.0.1，而是 host.docker.internal）

日常操作建议

用好 docker-compose 命令，避免手动管理容器：

• 全部启动：docker-compose up -d
• 只启 PHP 5.6 和 Nginx：docker-compose up -d php56 nginx
• 查看运行状态：docker-compose ps
• 进某个容器调试：docker-compose exec php72 sh
• 日志实时查看：docker-compose logs -f php56

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！