Docker 运行 PHP

这一课你将能做到

1. 独立搭建 php:8.2-fpm + nginx 两个容器，用 docker-compose 一键起停
2. 用官方镜像的 docker-php-ext-install 机制补装 pdo_mysql 等扩展
3. 看懂 nginx 与 php-fpm 之间的 FastCGI 握手配置，排查 502/文件找不到类问题

为什么要学

「我这能跑，服务器跑不了」是 PHP 老项目的高频惨剧——本机 PHP 7.4 服务器 8.2、扩展缺一半、php.ini 天差地别。Docker 把 PHP 版本、扩展、配置、nginx 全部固化进镜像，开发/测试/生产三环境一致。而且 php-fpm + nginx 双容器架构是 PHP 生产部署的通用形态，理解它就理解了所有 PHP 部署方案（宝塔、K8s、Swoole 例外）的底层逻辑。

人话：nginx 是「前台接待」，只收 HTTP；php-fpm 是「后厨」，只跑 PHP；两者通过 FastCGI 协议传菜单和菜。Docker 就是给每个角色一个独立的标准厨房。

先建立图像

两个容器的拓扑与端口：

┌─────────────┐   FastCGI(TCP 9000)   ┌──────────────────┐
│ nginx:alpine │ ────────────────────► │ php:8.2-fpm       │
│  容器 80 端口 │   fastcgi_pass php:9000│  容器 9000 端口    │
└──────┬──────┘                        │  执行 .php 脚本    │
       │ 映射宿主机 8080                └────────┬─────────┘
       ▼                                        │ 同一网络
  浏览器 localhost:8080                 代码目录（volume 双方共享）

关键认知：两个容器必须共享同一份代码目录——nginx 找静态文件，fpm 执行脚本，路径必须一致；fpm 容器的 9000 端口不映射到宿主机，只在 compose 网络内互通。

跟着做

步骤 1：项目结构

php-docker/
├── docker-compose.yml
├── php/
│   └── Dockerfile
├── nginx/
│   └── default.conf
├── db/
│   └── init.sql
└── src/
    └── index.php

步骤 2：编写 Dockerfile（补装扩展）

php/Dockerfile：

FROM php:8.2-fpm

# 官方镜像内置的扩展安装助手
RUN docker-php-ext-install pdo pdo_mysql

# 常用扩展备查：
# docker-php-ext-install pdo_mysql opcache bcmath gd zip
# pecl install redis && docker-php-ext-enable redis

# 生产建议的自定义配置（可选）
RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini

php:8.2-fpm 镜像默认只有核心扩展，pdo_mysql 必须手动装——这是新手第一个坑。

步骤 3：nginx 站点配置

nginx/default.conf：

server {
    listen 80;
    server_name localhost;
    root /var/www/html;              # 必须与 fpm 容器的代码路径一致
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass  php:9000;      # 服务名 = compose 里的服务名
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include       fastcgi_params;
    }
}