必须用 from ... as builder 分离 composer 安装与运行环境，否则 vendor/ 会混入 dev 依赖、测试文件、.git 目录和未优化 autoloader，导致镜像体积多出 50–200mb；传统单阶段构建易因未加 --no-dev/--optimize-autoloader、选用胖基础镜像及 copy 路径错误而膨胀至 400mb+。
直接结论：必须用 FROM ... AS builder 分离 Composer 安装与运行环境，否则 vendor/ 里会混进 dev 依赖、测试文件、.git 目录和未优化的 autoloader，最终镜像体积多出 50–200MB 是常态。
为什么 PHP 镜像容易膨胀到 400MB+？
传统单阶段构建常犯三个错误：
- 在同一个镜像里既
composer install又运行服务，导致vendor/里残留--dev依赖（如 phpunit、phpstan）、文档、测试用例 - 没禁用
composer install的冗余行为，比如不加--no-dev和--optimize-autoloader，autoloader 文件体积翻倍 - 基础镜像选了
php:8.3-apache这类带完整 Apache + mod_php 的胖镜像，而非php:8.3-cli-alpine或php:8.3-fpm-alpine
COPY --from=builder 复制时只取 vendor 和源码，别碰错路径
构建器阶段生成的 vendor/ 是“干净”的，但复制路径写错就会漏文件或带入不该有的东西：
- 确保构建器阶段
COPY . /app后执行composer install --no-dev --optimize-autoloader，且WORKDIR /app - 运行阶段用
COPY --from=builder /app/vendor /var/www/html/vendor，不是/app全量复制 - 如果项目有前端构建（如 Laravel Mix），需在 builder 阶段完成
npm ci && npm run build，再只复制public/到运行阶段 - 避免用
COPY --from=builder /app .—— 这会把.git、tests/、docker-compose.yml全拖进去
Alpine 镜像下 ext-redis 等扩展怎么装才不翻车？
在 builder 阶段装扩展没问题，但运行阶段必须保证扩展二进制兼容 Alpine 的 musl libc：
- 不要在运行阶段用
pecl install—— Alpine 上缺少编译工具链，且动态编译易失败 - 推荐做法：builder 阶段用
php:8.3-cli-alpine，先apk add --no-cache $PHPIZE_DEPS，再pecl install redis，最后docker-php-ext-enable redis - 运行阶段仍用
php:8.3-cli-alpine，通过COPY --from=builder /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/复制已编译好的redis.so - 验证是否生效：
php -m | grep redis；若报undefined symbol: redisCommand，说明扩展和 PHP 版本不匹配，需严格对齐 builder 与 runtime 的 PHP minor 版本（如都是 8.3.12）
最易被忽略的瘦身点：.dockerignore 和缓存污染
多阶段构建能解决大问题，但这两处不处理，体积照样虚高：
-
.dockerignore必须包含：node_modules/、tests/、.git/、.idea/、vendor/（防止 COPY . 时把本地 vendor 覆盖掉 builder 阶段生成的） - Composer 缓存目录默认在
/tmp/composer，每次构建都重下包。建议设COMPOSER_CACHE_DIR=/composer-cache并在 builder 阶段VOLUME ["/composer-cache"]（仅用于本地开发加速），CI 中则靠 Docker 构建缓存更稳 - 最终镜像用
docker history your-image检查：如果某层 >50MB 且内容不明，大概率是 COPY 错了路径或忘了清理
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
