怎么制作自己的php镜像？手把手教你定制开发环境！

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

最近又开始折腾服务器上的东西了，主要是之前那个PHP环境，每次换个机器或者本地搞测试，都得重新配一遍，烦得很。特别是那些PHP扩展，有时候在这个机器上装得上，换个机器又出幺蛾子，真是够了。

为啥要搞这个镜像

起因还是手头有几个老项目，PHP版本不高不低，但依赖的扩展还挺怪。之前直接在服务器装环境，装完这个忘了那个，或者版本不对，项目跑不起来。后来有次服务器挂了，重装系统，重新配环境，弄了我大半天，当时就想，要是有个弄好的环境包，直接跑起来多

后来知道了Docker这玩意儿，感觉像是找到了救星。别人都说好用，能把环境整个打包带走，在哪都能跑。我就琢磨着，干脆自己也弄一个PHP镜像，把我需要的扩展、配置啥的都放进去，以后就用这个跑，省心。

说干就干。我先去找了个官方的PHP基础镜像，版本就选我项目最常用的那个，比如PHP 7.4的fpm版本，这个比较纯粹，不带乱七八糟的东西。

第一步，就是写那个Dockerfile。就是个文本文件，里面写清楚要基于哪个镜像，然后要执行啥命令。

我先指定了基础镜像：

FROM php:7.4-fpm

然后就是更新一下apt源，装一些后面编译扩展可能需要的基础工具，像编译工具链build-essential、还有些库文件什么的。虽然基础镜像可能自带一些，但为了保险，我还是自己又装了一遍常用的。

RUN apt-get update && apt-get install -y \

git \


zip \
unzip \
libzip-dev \
libpng-dev \
libjpeg-dev \
libfreetype6-dev \
# ... 其他可能需要的库

这些库主要是为了后面装GD库、ZIP这些扩展准备的。

接下来就是重头戏，装PHP扩展了。这是最烦人的一步，因为不同的扩展安装方式还不太一样。

Docker提供了一些方便的命令来装官方支持的扩展，比如：

上面这个-j$(nproc)是看别人加的，说是能用多核编译快一点，我也就照猫画虎加上了。

有些扩展可能需要用pecl来装，比如redis或者mongodb的扩展：

RUN pecl install redis && docker-php-ext-enable redis

装这些扩展的时候，经常会碰到依赖问题，缺这个库少那个包的。有时候得回到前面装基础工具那一步，再加几个apt-get install的包，然后重新构建镜像。试了好几次才把项目需要的扩展都装齐了。

还有个事儿，就是配置。PHP默认的配置有时候不太够用，比如上传文件大小限制upload_max_filesize、内存限制memory_limit这些。我把自己常用的配置文件准备然后在Dockerfile里把它复制到镜像里对应的位置：

COPY * /usr/local/etc/php/conf.d/*

这样启动容器的时候，PHP就会加载我的配置了。

装完所有东西后，最好清理一下apt缓存和不需要的包，让镜像小一点：

RUN apt-get clean && rm -rf /var/lib/apt/lists/

设置一下工作目录，或者暴露端口啥的，看具体需求。我这个是fpm镜像，主要是给Nginx用的，所以暴露了9000端口。

WORKDIR /var/www/html EXPOSE 9000

整个Dockerfile写完，就开始构建镜像：

docker build -t my-php:7.4 .

这个过程根据网络情况和机器性能，可能要等一会儿，特别是编译扩展的时候。中间可能还会报错，根据错误提示再回去改Dockerfile，然后重新构建，反复几次。

等镜像终于构建成功了，心里一块石头落地。

然后我就跑个容器试试看：

docker run --name test-php -d my-php:7.4

再进容器里看看PHP版本、加载的扩展对不对：

docker exec -it test-php php -v docker exec -it test-php php -m

看到自己装的扩展都在列表里，版本也对，配置也加载了，总算是弄好了。

以后部署项目或者本地开发，直接用这个镜像跑起来，环境就都一样了，确实省了不少事。虽然过程有点折腾，但弄好之后用起来是真的方便。