PHP Docker 常见问题：解决你的环境配置烦恼

发布日期： 2025-10-10 阅读量： 作者： admin

大家今天跟大家唠唠我最近折腾PHP用Docker的事儿。以前开发PHP项目，在本机电脑上装环境，一会儿是版本不对，一会儿是扩展缺了，换台电脑又得重来一遍，挺烦人的。听说Docker能把这些环境打包带走，到哪儿都一样，就想着试试看。

说干就干。第一步，肯定得先把Docker这个东西装到我电脑上。这个过程我就不多啰嗦了，网上教程挺多的，跟着步骤装好就行。

装好了Docker，接下来就得找PHP的“镜像”了。你可以理解成一个打包好的、最小化的运行环境。我去那个叫Docker Hub的地方搜了一下，PHP相关的镜像还真不少。看来看去，我选了个官方的，带FPM的那个版本，好像用php:fpm-alpine这个比较多，因为它小。在命令行里敲 docker pull php:fpm-alpine，等着它下载下来。

镜像下好了，我就想先跑起来看看。试着运行了一下 docker run php:fpm-alpine，结果发现它跑一下就自己退出了。当时有点懵，后来才搞明白，光跑一个PHP-FPM进程不行，它得有活儿干，得有Web服务器（比如Nginx）来调用它才行。

而且我的PHP代码还没放进去。这时候就得用到Docker的一个叫“卷（Volume）”的功能了。简单说，就是把你电脑上的文件夹，关联到Docker容器里的某个文件夹。我就用了-v参数，像这样：-v /我本地电脑的项目路径:/var/www/html。这样容器里的/var/www/html目录就能访问到我本地的代码了。这个路径得写对，不然代码进不去，白搭。

光有PHP还不行，还得有个Web服务器在前面接收请求，再把PHP的活儿交给PHP-FPM处理。我平时用Nginx比较多，所以又去拉了个Nginx的镜像：docker pull nginx。

最关键的一步来了：怎么让Nginx容器和PHP-FPM容器合作起来？它们得能互相找到对方。我得写个Nginx的配置文件，告诉它PHP文件来了该去找谁处理。配置文件里大概是这样写：fastcgi_pass php容器的名字:9000;。这里的9000是PHP-FPM默认监听的端口。

然后，运行Nginx容器的时候，也得用-v把这个写好的配置文件挂载到容器里Nginx的配置目录下，比如-v /我的nginx配置文件路径:/etc/nginx/conf.d/*。别忘了，项目代码那个卷也得挂给Nginx容器，因为它需要读取静态文件或者判断文件是否存在。

为了让浏览器能访问到Nginx，还得做端口映射。比如用-p 8080:80，意思就是把我电脑的8080端口收到的请求，转发给Nginx容器的80端口。

一开始我分开运行两个容器，发现Nginx报502错误，就是找不到PHP。查了资料才知道，默认情况下，两个容器是互相隔离的。得让它们加入同一个网络。我就先创建了一个网络：docker network create my-php-network。然后启动PHP和Nginx容器的时候，都加上--network my-php-network参数。我还给PHP容器起了个名字，比如--name myphp，这样Nginx配置文件里就可以直接用myphp:9000来找到它了。

对了，我的项目还用了Composer来管理依赖。这些依赖库也得装到PHP容器里才行。我是这么操作的：先让PHP容器跑起来，然后用docker exec -it myphp sh命令进入到容器的命令行环境里，再在里面执行composer install，把依赖都装上。

折腾中的小插曲

整个过程下来，磕磕绊绊也不少，主要碰到这几个坎：

端口被占用：有时候想用8080端口，结果电脑上别的程序已经用了，Nginx容器就起不来。得换个端口或者把占用的程序关掉。
路径写错：挂载卷的时候，本地路径或者容器内路径写错了，代码或者配置文件没成功放进去，访问要么是Nginx欢迎页，要么是404。
Nginx连不上PHP：这个最常见，通常是Nginx配置里的fastcgi_pass地址写错了，或者PHP-FPM容器没正常运行，或者网络没配置对。
权限问题：把代码挂进去后，发现PHP脚本没权限写日志或者缓存文件。这个得调整容器里运行用户或者文件夹的权限，稍微麻烦点。

一番折腾下来，总算是成功了！在浏览器里敲localhost:8080，看到自己熟悉的PHP页面跑起来了，那一刻感觉之前的折腾都值了。

虽然第一次搞有点费劲，但好处是实实在在的。以后不管在哪台电脑上，只要装了Docker，用同样的命令或者配置，就能快速跑起一模一样的开发环境，再也不用为环境差异头疼了。而且后来我还了解到用docker-compose这个工具，可以把PHP、Nginx甚至数据库这些服务写在一个配置文件里，一键启动、停止，比手动敲docker run命令方便多了。下次有空再跟大家分享下docker-compose的实践。

上一篇: 建设网站公司哪个好？别盲选，这份攻略请收好！

PHP Docker 常见问题：解决你的环境配置烦恼

随便看看