Docker集成PHP与Nginx详细教程

本文手把手带你完成Docker环境下PHP与Nginx的深度集成，从零构建可复用、易维护的容器化Web开发环境：通过规范的项目目录结构分离代码与配置，定制支持常用扩展的PHP-FPM镜像，编写精准转发PHP请求的Nginx配置，并借助Docker Compose统一编排双服务网络与启动顺序，最终一键启动并成功在localhost:8080验证PHP解析——无论你是初学者想夯实容器化部署基础，还是开发者寻求轻量高效的服务组合方案，这套经过Ubuntu 22.04 + Docker Desktop实测的完整流程都能为你提供清晰、可靠、开箱即用的实践指南。

如果您正在搭建一个基于容器化的Web应用环境，可能需要将PHP与Nginx组合使用以实现动态内容解析。以下是完成Docker中PHP与Nginx集成的具体操作流程。

本文运行环境：Docker Desktop，Ubuntu 22.04

一、准备项目目录结构

合理的目录结构有助于分离配置与代码，提升可维护性。通过建立清晰的文件夹层级，可以方便地挂载到Docker容器中。

1、在本地创建项目主目录，例如命名为php-nginx-app。

2、在该目录下分别创建html、nginx和php子目录。

3、将PHP测试文件放入html目录，如index.php，内容为。

二、编写Nginx配置文件

Nginx作为反向代理服务器，需正确转发PHP请求至PHP-FPM服务处理。配置文件定义了服务监听端口与解析规则。

1、在nginx目录中创建default.conf文件。

2、写入server块配置，指定根目录为/var/www/html，并设置location对.php结尾的请求进行转发。

3、确保fastcgi_pass指向PHP-FPM容器的服务名或IP及端口，通常为php-fpm:9000。

三、构建自定义PHP-FPM镜像

官方PHP-FPM镜像可能缺少某些扩展，可通过Dockerfile定制化构建满足项目需求的镜像。

1、在php目录中创建Dockerfile。

2、基础镜像选择php:8.2-fpm，并安装常用扩展如pdo_mysql、gd、zip等。

3、设置工作目录为/var/www，并将权限用户设为www-data。

四、编写Docker Compose编排文件

Docker Compose用于定义多容器应用服务，简化启动与网络管理。通过YAML文件统一声明Nginx与PHP服务。

1、在项目根目录创建docker-compose.yml文件。

2、定义两个服务：web（Nginx）和php-fpm（PHP）。

3、为web服务指定镜像nginx:alpine，并将本地nginx/default.conf挂载到容器配置路径。

4、为php-fpm服务使用自定义构建镜像，上下文指向./php，并共享同一自定义网络。

5、设置depends_on确保PHP服务先于Nginx启动。

五、启动容器并验证服务

完成所有配置后，通过Compose命令启动服务，并检查是否正常响应PHP请求。

1、打开终端，进入项目根目录执行docker compose up -d --build。

2、等待镜像构建完成并运行容器。

3、访问http://localhost:8080查看phpinfo输出页面。

4、若页面成功显示PHP信息，则表示集成成功；否则查看日志排查错误。

今天关于《Docker集成PHP与Nginx详细教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！