Nginx 中 PHP-FPM 怎么在容器化 Dockerfile 中构建轻量镜像

冬杰同学_4561

冬杰同学_4561

2026-08-27

221人浏览

原创

使用 alpine linux 基础镜像(如 alpine:3.20)源码编译或 apk 精简安装 php-fpm,仅启用 opcache、pdo、pdo_mysql、mbstring 等必需扩展,删除冗余配置与缓存,配合最小化 nginx 配置及 dumb-init 作为 pid 1,可构建约 35–45mb 的轻量级 nginx + php-fpm 容器镜像。

nginx 中 php-fpm 怎么在容器化 dockerfile 中构建轻量镜像

用 Alpine Linux 基础镜像 + 源码编译或 apk 精简安装 PHP-FPM,关闭不必要的模块和扩展,是构建轻量 Nginx + PHP-FPM 容器镜像的核心思路。

选对基础镜像:优先 Alpine,避免 Debian/Ubuntu

Alpine 镜像体积通常仅 5–7MB,而 Debian slim 版本约 120MB,完整版超 200MB。PHP 官方镜像虽方便,但默认包含大量调试工具、dev 包和未启用的扩展,不适合生产轻量部署。

  • 使用 alpine:latest 或固定小版本如 alpine:3.20,避免 php:8.3-apache 这类“开箱即用但臃肿”的镜像
  • 确认 Alpine 的 PHP 包是否满足需求:apk list php*-fpm(如 php83-fpm),多数常用扩展(pdo_mysql、opcache、mbstring)在 community 源中可用
  • 禁用包管理缓存和索引:构建末尾加 && apk del .build-deps && rm -rf /var/cache/apk/*

精简 PHP-FPM 配置与扩展

默认 PHP-FPM 配置含大量注释和冗余选项,扩展加载过多会拖慢启动并增加内存占用。

  • 只启用必需扩展:例如 opcache(必须)、pdo、pdo_mysql、mbstring、json、xml;移除 gd、zip、soap 等非业务强依赖项
  • 覆盖默认 www.conf:用最小化配置,例如设置 pm = static、pm.max_children = 5、禁用 access.log 和 slowlog(开发阶段可保留,上线前关掉)
  • 删除未使用的 INI 文件:rm /etc/php83/conf.d/20-*.ini,只保留显式需要的配置片段

Nginx 与 PHP-FPM 协同:不跑 supervisord,用 dumb-init 或直接 exec

多进程管理器(如 supervisord)会额外引入依赖和体积,且在容器中非必需。

Dolphindb Docker
Dolphindb Docker

自动化 DolphinDB Docker 部署,支持自动架构检测(ARM64/x86_64),智能内存分配(50% 规则)以及完整数据持久化。

下载
  • 推荐方式:Nginx 作为 PID 1,用 daemon off; 启动;PHP-FPM 用 php-fpm83 -F 前台运行,通过 shell 脚本或 docker-compose 的 depends_on 控制顺序
  • 更健壮做法:用 dumb-init(仅 150KB)作为入口点,处理信号转发,避免僵尸进程:apk add --no-cache dumb-init,然后 ENTRYPOINT ["dumb-init", "--"]
  • 不推荐:把 Nginx 和 PHP-FPM 打包进同一镜像还用 supervisord —— 镜像变大、日志混杂、扩缩容困难

构建示例 Dockerfile(Alpine + PHP83-FPM + Nginx)

以下是一个典型轻量级组合镜像写法(最终镜像约 35–45MB):

FROM alpine:3.20
<h1>安装运行时依赖</h1><p>RUN apk add --no-cache \
nginx \
php83-fpm \
php83-opcache \
php83-pdo \
php83-pdo_mysql \
php83-mbstring \
php83-json \
php83-xml \
&& rm -rf /var/cache/apk/*</p><h1>清理默认配置</h1><p>RUN rm /etc/nginx/conf.d/default.conf \
&& rm /etc/php83/conf.d/20-*.ini \
&& echo "opcache.enable=1" > /etc/php83/conf.d/00-opcache.ini</p><h1>复制自定义配置</h1><p>COPY nginx.conf /etc/nginx/nginx.conf
COPY www.conf /etc/php83/php-fpm.d/www.conf
COPY app.conf /etc/nginx/conf.d/app.conf</p><h1>复制应用代码(建议用多阶段构建分离)</h1><p>COPY --chown=nginx:nginx ./src /var/www/html</p><h1>设置用户与权限</h1><p>RUN chown -R nginx:nginx /var/www/html \
&& chmod -R 755 /var/www/html</p><h1>暴露端口</h1><p>EXPOSE 80</p><h1>启动:Nginx 前台运行,自动拉起 PHP-FPM(通过 include 或 fastcgi_pass unix socket)</h1><p>CMD ["nginx", "-g", "daemon off;"]
</p>

注意:若需严格分离 Nginx 和 PHP-FPM 进程(如调试、独立扩缩容),应拆为两个镜像,用 docker-compose 联合部署 —— 单镜像轻量,双镜像更云原生。

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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10064

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5961

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2075

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3748

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4434

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3471

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4957

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3882

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11862

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习