Docker部署PHP环境详细教程

大家好，今天本人给大家带来文章《Docker部署PHP环境的完整教程》，文中内容主要涉及到，如果你对文章方面的知识点感兴趣，那就请各位朋友继续看下去吧~希望能真正帮到你们，谢谢！

通过Docker可快速搭建PHP开发环境。1. 创建项目目录php-docker-env，新建index.php和docker-compose.yml；2. 配置Nginx服务，设置default.conf转发.php请求至PHP-FPM；3. 在docker-compose.yml中定义php服务使用php:8.1-fpm镜像，挂载代码目录；4. 添加mysql服务，设置root密码和数据库并持久化数据；5. 完整定义各服务的端口、卷、依赖关系后执行docker-compose up -d启动；6. 访问http://localhost:8080查看phpinfo页面，并测试连接MySQL确保环境正常。

如果您正在搭建PHP开发环境，但面临依赖复杂、配置繁琐的问题，可以通过Docker快速构建隔离且可复用的环境。以下是实现该目标的具体操作步骤：

一、准备项目目录与文件结构

在本地创建一个专用目录用于存放PHP项目及相关配置文件，确保容器可以挂载代码并实时同步修改。

1、在终端执行 mkdir php-docker-env && cd php-docker-env 创建项目根目录。

2、在该目录下新建 index.php 文件，写入简单的PHP信息输出代码，例如：。

3、创建 docker-compose.yml 文件，用于定义服务组件如Web服务器、数据库等。

二、编写Nginx服务配置

使用Nginx作为Web服务器处理HTTP请求，并通过FastCGI与PHP-FPM通信。

1、在项目根目录下新建 nginx 文件夹，并在其内创建 conf.d 子目录。

2、在 conf.d 中创建 default.conf 配置文件，内容包含server块定义监听端口、root路径及location对.php文件的转发规则。

3、配置示例中需将 root 指向 /var/www/html，并将 fastcgi_pass 设置为指向PHP-FPM容器的服务名和端口（如 php:9000）。

三、配置PHP-FPM容器

PHP-FPM负责解析PHP脚本，选择合适的镜像版本以匹配开发所需的PHP特性。

1、在 docker-compose.yml 中定义名为 php 的服务，基于官方镜像如 php:8.1-fpm。

2、设置容器内的工作目录为 /var/www/html，并通过 volumes 将本地代码挂载到容器中。

3、添加依赖项，确保PHP服务在Nginx启动前已就绪，使用 depends_on 字段进行声明。

四、集成MySQL数据库服务

为支持常见的LAMP或LNMP架构应用，需要引入数据库服务供PHP连接使用。

1、在 docker-compose.yml 中添加 mysql 服务，使用镜像 mysql:5.7 或更高兼容版本。

2、设置环境变量 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE 来初始化管理员密码和默认数据库。

3、配置数据卷（volume）将数据库文件持久化存储在宿主机上，避免容器重启后数据丢失。

五、编写并启动Docker Compose配置

整合所有服务定义至统一编排文件中，通过一条命令启动整个开发环境栈。

1、编辑 docker-compose.yml 文件，包含 services: nginx, php, mysql 及 networks 和 volumes 的声明。

2、在文件中为每个服务指定 image、container_name、ports、volumes、environment 等关键字段。

3、保存文件后，在项目根目录运行 docker-compose up -d 命令后台启动所有容器。

六、验证环境是否正常运行

确认各服务均已成功启动并能协同工作，访问网页查看PHP信息页是否正确显示。

1、执行 docker-compose ps 查看所有服务状态，确保无容器处于退出或重启状态。

2、打开浏览器访问 http://localhost:8080（假设Nginx映射了8080端口），应看到phpinfo()输出页面。

3、检查是否能通过PHP脚本连接MySQL数据库，可编写测试脚本使用PDO尝试连接 host: mysql, port: 3306。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~