使用docker搭建php运行环境的核心是通过容器化实现快速部署和环境隔离。具体步骤为：1. 使用docker-compose.yml定义nginx、php、mysql服务；2. 通过自定义dockerfile安装php扩展及composer；3. 配置nginx以支持php-fpm请求处理。各组件通过网络和数据卷互联并持久化数据，从而构建稳定、可复用的开发环境。
使用Docker搭建PHP运行环境，本质上就是将PHP、Web服务器（如Nginx或Apache）、数据库（如MySQL）等组件分别或组合打包成独立的容器，通过容器编排工具（如Docker Compose）进行管理和互联，从而实现快速部署、环境隔离和团队协作的便利。这种方式能有效解决传统开发环境中版本冲突、依赖管理复杂等痛点，让开发和部署流程变得更加高效和可控。
搭建一个PHP运行环境，我个人偏好使用Nginx作为Web服务器，PHP-FPM来处理PHP请求，再配上MySQL作为数据库。这种组合在生产环境中非常常见，而且用Docker来搞定，简直是降维打击。
我们需要一个docker-compose.yml文件来定义这些服务。我通常会把这个文件放在项目根目录，这样整个环境就和项目代码绑定在一起了。
立即学习“PHP免费学习笔记（深入）”；
version: '3.8'
services:
nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./nginx:/etc/nginx/conf.d
- ./src:/var/www/html
depends_on:
- php
networks:
- app-network
php:
build:
context: .
dockerfile: Dockerfile.php
volumes:
- ./src:/var/www/html
networks:
- app-network
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: your_strong_password
MYSQL_DATABASE: your_database_name
MYSQL_USER: your_user_name
MYSQL_PASSWORD: your_user_password
volumes:
- dbdata:/var/lib/mysql
networks:
- app-network
networks:
app-network:
driver: bridge
volumes:
dbdata:这里面有几个关键点：
-
nginx服务：用了最新的Nginx镜像，映射80端口，把本地的nginx配置目录和src（你的PHP代码）目录挂载进去。depends_on: - php只是确保php服务先启动，但Nginx不依赖PHP-FPM的健康状态。 -
php服务：我倾向于用build指令，这样可以自定义PHP环境，比如安装一些扩展。Dockerfile.php就是我们用来构建PHP镜像的文件。 -
mysql服务：直接用MySQL官方镜像，设置好环境变量，数据卷挂载，防止数据丢失。 -
networks和volumes：这是Docker Compose的精髓，让服务之间可以互相通信，数据可以持久化。
接下来是Dockerfile.php，这个文件定义了PHP容器的具体内容。
FROM php:8.2-fpm-alpine
# 安装常用的PHP扩展
RUN apk add --no-cache \
libzip-dev \
libpng-dev \
jpeg-dev \
freetype-dev \
icu-dev \
onig-dev \
git \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install -j$(nproc) pdo_mysql opcache gd exif pcntl zip intl bcmath mbstring
# 安装Composer
COPY --from=composer/composer:latest-bin /composer /usr/bin/composer
WORKDIR /var/www/html
# 暴露PHP-FPM端口，虽然在docker-compose里不是直接访问，但良好实践
EXPOSE 9000
CMD ["php-fpm"]这个Dockerfile基于php:8.2-fpm-alpine，这是一个轻量级的PHP-FPM镜像。我加了一些常用的PHP扩展，比如pdo_mysql、gd、zip等，这些都是开发中经常会用到的。Composer也一并安装了，方便管理PHP依赖。
最后，别忘了Nginx的配置，通常我会创建一个nginx/default.conf文件：
server {
listen 80;
index index.php index.html index.htm;
root /var/www/html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
try_files $fastcgi_script_name =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass php:9000; # 注意这里是php，对应docker-compose.yml中的服务名
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
error_log /var/log/nginx/error.log warn;
access_log /var/log/nginx/access.log combined;
}这个Nginx配置就是典型的PHP-FPM反向代理配置，把所有.php请求转发给`php:900
