ThinkPHP 5.1 必须用多阶段构建，因其能分离构建与运行环境：第一阶段用含Node/Composer的完整镜像安装依赖并构建前端资源，第二阶段仅复制vendor、public/static等运行必需文件至轻量Alpine PHP-FPM镜像，并正确配置gd、pdo_mysql扩展及runtime目录权限与挂载。
ThinkPHP 5.1 接入 Docker 的关键不在“能不能跑”，而在于“能不能轻量、稳定、可复现地跑”。直接用 php:7.4-apache 一类的镜像打包，镜像体积轻松破 500MB，还混着 Apache、dev 工具、未清理的 apt 缓存——这不是部署，是搬运整套开发环境。
为什么 ThinkPHP 5.1 必须用多阶段构建？
ThinkPHP 5.1 项目依赖 Composer 安装扩展（如 topthink/think-queue）、可能含前端构建步骤（npm run build），还会生成 runtime/ 和 public/static/ 等产物。这些在构建时需要，运行时完全不需要。
- 单阶段构建会把
composer install下载的整个vendor/、临时node_modules/、甚至npm二进制本身都打进最终镜像 - 多阶段能明确切分：第一阶段用完整 PHP+Node 环境做构建；第二阶段只复制
vendor/、public/static/、源码和必要配置，不带任何构建工具 - ThinkPHP 5.1 的
runtime/目录必须由运行时进程（如 php-fpm）写入，所以不能在构建阶段生成，但需确保权限和挂载点正确
Alpine 镜像适配 ThinkPHP 5.1 的三个硬坑
Alpine 使用 musl libc 而非 glibc，PHP 扩展（尤其是 pdo_mysql、gd）必须用 Alpine 专用包安装，否则 php -m 看不见，或运行时报 undefined symbol: mysqlnd_connect 这类错误。
-
docker-php-ext-install在 Alpine 上默认不可用，得先apk add --no-cache $PHPIZE_DEPS，再手动编译扩展 -
gd库依赖jpeg-dev、png-dev、freetype-dev，缺一不可，否则imagecreatefromjpeg()直接报错 - 时区问题：Alpine 默认无
/usr/share/zoneinfo/Asia/Shanghai，需apk add --no-cache tzdata并设ENV TZ=Asia/Shanghai
一个可用的 ThinkPHP 5.1 多阶段 Alpine Dockerfile
以下结构已验证兼容 ThinkPHP 5.1.42（含队列、图片处理、MySQL 连接）：
立即学习“PHP免费学习笔记（深入）”；
# 构建阶段
FROM php:7.4-cli-alpine AS builder
RUN apk add --no-cache git zip unzip nodejs npm && \
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer
WORKDIR /app
COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader
COPY . .
RUN npm ci && npm run build 2>/dev/null || true
<h1>运行阶段</h1><p>FROM php:7.4-fpm-alpine
RUN apk add --no-cache tzdata jpeg-dev png-dev freetype-dev && \
docker-php-ext-configure gd --with-jpeg-dir=/usr/include --with-png-dir=/usr/include --with-freetype-dir=/usr/include && \
docker-php-ext-install pdo_mysql gd opcache && \
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
ENV TZ=Asia/Shanghai
WORKDIR /var/www/html
COPY --from=builder /app/ .
COPY --from=builder /app/public/static /var/www/html/public/static
RUN chown -R www-data:www-data /var/www/html/runtime /var/www/html/public/static && \
chmod -R 775 /var/www/html/runtime /var/www/html/public/static
EXPOSE 9000
注意：npm run build 输出目录需与 ThinkPHP 的 public/static/ 对齐；若项目不用前端构建，删掉 nodejs npm 和 npm 相关行即可。
运行时权限与挂载的实操细节
ThinkPHP 5.1 的 runtime/ 目录必须由容器内 www-data 用户可写，且不能在构建阶段固化内容（否则多实例共享时冲突）。常见错误是直接 COPY runtime/ 进镜像，导致启动失败。
- 不要在 Dockerfile 中
COPY runtime/，而应在docker run或docker-compose.yml中用 volume 挂载空目录：- ./runtime:/var/www/html/runtime - 若用
docker-compose，务必在phpservice 下加user: "www-data"，避免 root 启动后创建的文件属主为 root -
storage/同理，ThinkPHP 5.1 不强制要求该目录存在，但日志、缓存路径若指向它，也需挂载并设权限
最易被忽略的是：Alpine 的 php-fpm 默认以 www-data 用户运行，但它的 UID 是 82，而宿主机上 www-data 用户 UID 可能是 33 —— 若挂载宿主机目录，权限不匹配会导致写入失败。解决方法是统一 UID，或改用 named volume。
