如何在Windows上使用Docker搭建PHP开发环境

前言

在本地搭建开发环境我好像没几年就要折腾一次，因为本地开发电脑使用的是windows，早些年的时候，用过很多类似WAMP之类的东西，但最终都有或多或少不满意的地方，前两年的时候，还折腾过WSL，但也是有这样那样的问题，不过后来终于是win版宝塔更新了，基本能和linux版的保持一致了，虽然有些东西在windows上要不没有，要不用不了；

最近又换了电脑，本地的环境需要重新配置，借此机会，其实我一直想试试docker，前两年折腾wsl2的时候，发现其实wsl2的io已经没有那么差了。而且Docker Desktop for windows 也已经支持基于wsl2来创建使用了。

(至于为什么要换，因为我老机器上跑的nginx好像内存泄露了一样，启动四到五个小时候内存占用就会跑到90%以上；启动一天，远程都连不上，鼠标都不会动了；老机器的环境是win版宝塔)

所以，花了几天的时间，现在终于是弄通了，本文记录下流程，以做沉淀。

安装Docker Desktop

Docker Desktop: The #1 Containerization Tool for Developers | Docker
访问上述链接即可下载，访问不了的话可能需要想想办法；
至于具体安装，这个网上有很多教程，不是本文要记录的重点，所以暂且路过，不过有一点要说明的是，要使用wsl2；wsl2要求应该是win10某个版本以上，目前你能下载到的新一点的win10镜像肯定都是没问题的；wsl2的启用可能也会有些小步骤，这个也建议去看下资料看看怎么安装使用，本文略过；

选择镜像

假设上面的必备条件都已经准备妥当。
接下来就是选择镜像来启动了，其实在一开始我是打算全部单独启动容器，比如我需要用到的php，mysql，nginx等等，我原计划打算一个php版本就启动一个容器，然后以后需要的时候就再用需要的php版本镜像再启动一个容器就好了；

但实际操作中，需要自己修改调试的东西还是很多，不仅要先理解docker的基本语法来进行端口映射和卷映射，还需要了解在nginx中怎么配置才能将请求转发到php进程进行处理，这些坑其实我都已经踩过了，但最后为什么放弃呢？

因为在我的实际开发中，虽然并不是外包公司，但是内部其实还是有很多大大小小的项目的，所以需要经常创建站点部署新项目，每配置一个新项目，我就需要去修改nginx的配置文件来配置代理，中间也记录了一些操作笔记，也自己尽量划分好了文件夹等等来实现nginx.conf自动加载某个目录下的文件来实现快速的新增站点，但这个问题解决完后又发现，在一些项目中，还需要为php安装特定扩展等等，我还想把php的配置文件映射到本地来随时修改并保证删除容器也不会对我做过的修改造成影响等等，更不用说还有mysql等等，这一系列操作，可能熟练了，或者专业的运维人员应该问题不大，但让我来一个个去配置确实很难受。

后来我还试过利用docker-compose来编排服务依赖等等，在某种程度上来说，确实减少了一些操作步骤等，但我在对docker不是很熟练的情况下，写了很多很多个版本，都没有一次性的成功启动并完美运行，前前后后也是折腾了两三天，到了最后还是绕不过手动配置站点以及其它的问题。再加上，需要端口映射，启动过的容器好像是不能修改端口映射了。这就很烦，网络是host模式我这边仅仅成功了一次，之后就直接失灵再也没正常过了；

所以，最后最后最后，我还是妥协了，我选择使用宝塔；
当然，我这次选择使用docker版的宝塔，相比于win版宝塔，linux版的宝塔要好用的多；

使用宝塔镜像

其实在以前我是知道在docker hub上是有大佬制作过baota镜像的，但是因为当时不知道docker具体指令是干什么用的，一知半解下启动的容器后来因为不懂把卷给删了，自己可算是把自己给坑到哭了；

这次发现宝塔官方有提供docker镜像，看了下版本也还算新（8.05）；于是就直接拿来使用了；

拉取镜像： docker pull btpanel/baota:lib ，我建议拉lib标签的，你可以先看一下官方的docker hub介绍： hub.docker.com/r/btpanel/baota ，介绍里给的例子是拉取lnmp标签，本身做php开发确实要这个就刚刚好，但是我启动后，发现里面的nginx，mysql，php什么的，都是挂掉的，反正是不能用。试了两次都不行，最后是卸载了重新安装才可以，所以与其如此，我觉得直接拉取lib标签的镜像就好了，启动进入后自己需要什么再单独安装吧；

启动容器

docker run --name baota -v E:/www/wwwroot:/www/wwwroot -v E:/www/mysql_data:/www/server/data -v E:/www/vhost:/www/server/panel/vhost -p 22:22 -p 443:443 -p 80:80 -p 888:888 -p 8888:8888 -p 3306:3306 --restart=unless-stopped -d btpanel/baota:lib

上面是我的指令，简单解释下:
--name是给容器起名，我这里就起做baota了；

-v 是卷映射,:符号作为分隔，前面的是你本地的路径，后面的是容器内的实际路径，映射分几种不同的模式，我这里就是把本机（windows）下的目录映射到了容器里的具体路径，比如这里的wwwroot目录，做完映射就实现了代码在我本地宿主机上，我可以随时用windows来编辑修改；最重要的是不会随着容器删除等对我的代码造成影响；以上映射的三个目录也是遵循官方说明来做的，一个站点目录，一个mysql数据目录，一个是虚拟域名的配置目录；

-p 是端口映射，因为我本地测试给容器使用host网络模式失败，所以最后只能采用bridge模式，bridge模式就必须做端口映射了，不然本地可能就访问不了你容器内的服务了，语法上，同样是:做分隔，前面是本地（宿主机）端口，后面是容器内具体服务的端口，例如我这里有80（nginx），8888（该宝塔镜像面板默认端口），以及mysql等等；按需做映射，或者如果你可以使用host模式，就不需要做映射了，但是要注意host模式下，是直接占用了宿主机的端口的，要注意这些端口是不是已经被占用；

--restart=unless-stopped 这个意思是仅在非正常停止的情况下自动重启容器，也有其它选项，可自行查询按需配置

-d 表示在后台运行，我想大概就是守护模式运行一个意思；

btpanel/baota:lib 这个是镜像名称，要指定使用哪个镜像来启动容器；

一般是可以正常启动的，启动后访问 http://localhost:8888/btpanel 就可以进入后台了，这个地址是官方镜像默认的地址，你可以自己使用docker进入容器，输入bt就可以调出宝塔的指令，可自行进行修改端口，路径，账号，密码等；

进入后版本为8.05，当前最新版本为8.20，我试过直接升级，目前没发现什么问题；但是要注意，你在容器中做的操作，除了映射到本地的文件夹外，其它内容都会随着容器的删除等等丢失！（该问题可以考虑先启动容器后把环境配置到自己满意的程度，然后把容器打包为新的镜像后期备用，同时镜像也是可以保存为文件的，可以保存为文件方便更换设备时使用）

附加：使用docker中的php来配置vscode中的php验证等

环境已经使用docker搭建了，其它一些依赖php的服务如果再让去本地再装一个php环境就本末倒置了，这点也有解决方案，但是有没有未知的问题我还不清楚；后续使用中如果有发现我再更新说明；

创建php.bat文件

自己找个目录，比如我放在了E:/www目录下，新建php.bat文件，命名随意；
内容如下，请根据备注释义按需修改：

@echo off

rem 启用延迟变量扩展

setlocal enabledelayedexpansion

rem 设置 Docker 容器名称和 PHP 路径

set CONTAINER_NAME=bt82lnmp

rem 设置php在docker中的执行路径

set PHP_PATH=php

rem 设置Windows映射盘符

set WIN_DRIVE=E:\

rem 设置要替换为的windows盘符内容

set WIN_DRIVE_REPLACE=\

  

rem 原始文件路径

set FILE_PATH=%1

  

if exist "%FILE_PATH%" (

    rem 将 Windows 路径转换为容器内的路径

    set "FILE_PATH=!FILE_PATH:%WIN_DRIVE%=%WIN_DRIVE_REPLACE%!"

    rem 将 Windows 路径转换为linux的路径

    set FILE_PATH=!FILE_PATH:\=/!

)

  

rem 使用 Docker 容器中的 PHP 运行传递的 PHP 文件

docker exec %CONTAINER_NAME% %PHP_PATH% !FILE_PATH!

  

rem 结束局部化变量的作用域

endlocal