php docker镜像优化需从dockerfile首行起控制层缓存与多阶段构建：先copy composer.json/lock并立即run composer install，再copy源码；用as分阶段剥离构建工具，复用编译扩展；最终镜像以非root用户运行，user指令须置于所有安装和复制操作之后。
要让PHP应用在Docker中启动更快、镜像更小、构建更稳，必须从Dockerfile第一行开始控制层缓存与阶段划分，而不是等构建失败了再调。
先锁定依赖再拷贝代码
第一步：在Dockerfile开头显式COPY composer.json和composer.lock两文件到工作目录。
第二步：立即执行RUN composer install --no-dev --no-scripts --optimize-autoloader --no-interaction。
这一步必须紧接在COPY之后，中间不能插入任何其他指令。否则Docker会把后续指令的变更也纳入该层缓存判定范围，导致哪怕只改了一行PHP代码，整个vendor安装层都失效重跑。
第三步：最后才COPY . .（或COPY src/ ./src/）把源码复制进来。
【关键前提：.dockerignore必须排除node_modules、.git、tests等无关目录】否则这些大文件会参与COPY哈希计算，轻微修改.git/config都会让依赖层缓存失效。
用多阶段构建剥离构建工具
方法一：使用AS命名构建阶段
FROM php:8.3-cli AS builder
RUN apt-get update && apt-get install -y git zip unzip && rm -rf /var/lib/apt/lists/*
COPY composer.json composer.lock ./
RUN composer install --no-dev --no-scripts --optimize-autoloader
FROM php:8.3-cli-alpine
RUN apk add --no-cache icu-dev libzip-dev && docker-php-ext-install intl zip
COPY --from=builder --chown=www-data:www-data /var/www/html/vendor ./vendor
COPY . .
方法二：复用已编译扩展避免重复编译
在builder阶段用pecl install redis && docker-php-ext-enable redis；最终镜像直接COPY --from=builder生成的.so文件，跳过整个编译链路。
注意：alpine镜像中php-*扩展包名与deb系不同，比如php83-redis而非php-redis，写错会导致RUN指令静默失败且无报错提示。
非root用户与权限收敛
在builder阶段无需创建应用用户，但最终运行阶段必须切换：
RUN adduser -D -u 1001 -s /bin/sh app
USER app
这一步要放在COPY vendor和源码之后、CMD之前。如果提前切用户，COPY --from=builder时可能因权限不足无法读取上一阶段的vendor目录。
【不可逆操作：一旦执行USER指令，后续所有RUN都以该用户身份运行，无法再apt install或pecl install】
所以扩展安装、依赖下载、代码复制全部要在USER app之前完成。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
