首先编写Dockerfile构建PHP环境,接着配置Nginx反向代理PHP-FPM,然后通过docker-compose.yml定义Nginx、PHP-FPM和MySQL服务,最后运行docker-compose up启动容器并访问http://localhost:8080验证部署成功。

将PHP网站部署到Docker容器中,可以实现环境隔离、快速部署和跨平台运行。整个过程包括编写Dockerfile、配置Nginx或Apache、连接数据库(如MySQL)以及使用docker-compose管理多服务。下面详细介绍具体步骤。
准备项目文件结构
在开始之前,整理好你的PHP项目目录,例如:
- project/
- ├── src/(存放PHP代码,如index.php)
- ├── Dockerfile
- ├── nginx.conf(可选,自定义Nginx配置)
- └── docker-compose.yml
确保src/index.php能正常输出内容,比如:
编写Dockerfile构建PHP环境
在项目根目录创建Dockerfile,用于构建PHP应用镜像:
立即学习“PHP免费学习笔记(深入)”;
FROM php:8.1-fpm安装常用扩展
RUN docker-php-ext-install mysqli pdo pdo_mysql
设置工作目录
WORKDIR /var/www/html
复制本地代码到容器
COPY src/ .
更改权限(防止运行时权限问题)
RUN chown -R www-data:www-data /var/www/html
这里使用php:8.1-fpm作为基础镜像,适合与Nginx配合使用。如果你用Apache,可以选择php:apache并直接启用Apache服务。
配置Nginx反向代理PHP-FPM
创建nginx.conf文件:
server {
listen 80;
root /var/www/html;
index index.php index.html;
server_name localhost;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
fastcgi_pass php-container:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}}
注意:fastcgi_pass指向的是PHP-FPM服务的容器名称(在docker-compose中定义为php-container)。
使用docker-compose编排服务
创建docker-compose.yml来统一管理Nginx、PHP和MySQL服务:
version: '3.8'
services:
nginx:
image: nginx:alpine
ports:
- "8080:80" volumes:
- ./src:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf depends_on:
- php-container
php-container: build: context: . volumes:
- ./src:/var/www/html depends_on:
- db
db: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: rootpassword MYSQL_DATABASE: myapp MYSQL_USER: user MYSQL_PASSWORD: password ports:
- "3306:3306" volumes:
- db_data:/var/lib/mysql
volumes: db_data:
这个配置启动三个容器:
- Nginx监听8080端口,处理静态请求并转发PHP给fpm
- PHP-FPM运行PHP代码
- MySQL提供数据库支持,数据持久化通过命名卷
db_data保存
启动容器并验证运行
在项目根目录执行:
docker-compose up -d --build
等待镜像构建并启动后,访问http://localhost:8080,如果看到PHP输出内容,说明部署成功。
查看日志排查问题:
docker-compose logs nginx docker-compose logs php-container
进入PHP容器测试数据库连接或执行脚本:
docker exec -itbash
优化与注意事项
- 生产环境建议:不要暴露MySQL端口,使用内部网络通信;关闭不必要的错误显示(display_errors=Off)
- 性能考虑:可添加OPcache扩展提升PHP性能
- HTTPS支持:可通过挂载SSL证书并在Nginx中配置SSL
- 代码更新:修改PHP文件后,由于挂载了volume,无需重建镜像即可生效(但Dockerfile变更需重新build)
基本上就这些。只要结构清晰,配置正确,PHP网站在Docker中运行非常稳定且易于维护。











