如何在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 offrem 启用延迟变量扩展setlocal enabledelayedexpansionrem 设置 Docker 容器名称和 PHP 路径set CONTAINER_NAME=bt82lnmprem 设置php在docker中的执行路径set PHP_PATH=phprem 设置Windows映射盘符set WIN_DRIVE=E:\rem 设置要替换为的windows盘符内容set WIN_DRIVE_REPLACE=\rem 原始文件路径set FILE_PATH=%1if 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

以上命令因为有注释，所以不过多解释，其中有个修改路径的操作，是因为我vscode中安装了code runner插件， 经常直接在php文件中执行某行代码测试用，这一块儿代码专门针对不能使用code runner的问题进行的处理；

配置php路径等

如上，创建完php.bat文件后，它的路径假如是这样： E:/www/php.bat 那么在vscode的配置文件中，路径就直接这样写： E://www//php.bat ，配置完后可以测试一下是否可用

打包容器为镜像

docker commit bt82lnmp baota bt82lnmp是新镜像名称，baota是当前容器的名称；

保存镜像为文件

docker save -o bt82lnmp.tar bt82lnmp bt82lnmp.tar是文件名称，可以带上路径，像我这样不带的话，那就看当前命令行是在哪个目录下，保存好的文件就直接在这个目录下了，后面的bt82lnmp是镜像名称；
（PS：打包格式好像必须是.tar）

加载镜像文件

docker load -i PATHFILE 在其它机器上加载镜像文件，这里的PATHFILE自行更换，填写你镜像.tar文件的具体路径

结语

至此，基本流程全部结束，间断的折腾了近一周，写文章写了快两个小时，写到后边的时候有些内容已经没有心思写的更详细了。但我总体看了下，基本流程应该已经没问题了；除了可能在实际操作中会碰到的一些乱七八糟的问题，但是基本都可以搜索解决；