alpine 3.16+ 中 apk add composer 必然失败，因官方已移除该包；必须用 curl 安装并提前安装 git unzip curl，再通过多阶段构建分离构建与运行环境，同时启用 phar、zip 等扩展并配置阿里云镜像源。
apk add composer 在 Alpine 3.16+ 必然失败
别再试 apk add composer，它在 Alpine 3.16 及之后所有主流版本（3.18/3.19/3.20）中都会报 ERROR: unable to select packages。这不是网络问题，是 Alpine 官方主动移除了该包——维护者认为 Composer 属于 PHP 应用层工具，不该由系统包管理器分发，且其对 git、unzip 的版本要求与 Alpine musl 环境存在冲突。
即使你侥幸在旧版 Alpine 中装上，大概率是 v1.x 过时版本，运行 composer --version 会直接报 PHP Parse error 或 Class 'Phar' not found，因为缺 phar 扩展或 zlib 支持。
curl 安装前必须装齐三个依赖
官方推荐的 curl -sS https://getcomposer.org/installer | php 在 Alpine 上会静默失败，常见现象是卡在 Cloning into... 或 failed to extract。根本原因不是脚本问题，而是缺底层工具：
-
git：拉私有仓库、解析 VCS 类型源（如"type": "vcs"）必需 -
unzip：绝大多数 PHP 包以 zip 分发，没它就解不开 -
curl：HTTPS 源下载依赖，Alpine 默认不带
务必在安装 Composer 前执行：apk add --no-cache git unzip curl；装完立刻删掉：apk del --purge git unzip curl，避免污染运行时镜像。
多阶段构建中 builder 阶段要完整，runtime 阶段要干净
真正瘦身不是靠 rm -rf /tmp/*，而是靠阶段隔离。很多人把 php:8.3-cli-alpine 整个镜像复制进最终层，体积直接翻倍。正确做法：
- builder 阶段用
php:8.3-cli-alpine（含docker-php-ext-install和完整构建链） - runtime 阶段切到更小的
php:8.3-alpine（不含 cli、pear、dev 扩展） - 只
COPY --from=builder /app/vendor /app/vendor，不复制composer.json、composer.lock或.composer目录 - runtime 阶段起手就
apk del --purge git unzip curl
否则你看到的“精简镜像”，其实只是把构建垃圾打包进了运行时。
ext-zip 和权限问题最容易被忽略
运行 composer install 时报 ext-zip not available，不是没装扩展，而是没启用。Alpine 中 PHP 扩展命名随版本变化：
- PHP 8.3 → 装
php83-zip（Alpine 3.20+）或统一用php-zip - 装完必须显式启用：
docker-php-ext-enable zip，否则php -m | grep zip不输出 - 非 root 用户运行时报
touch(): Unable to create file /home/app/.composer/config.json，是因为/home/app目录未提前chown -R app:app - 务必加
--no-interaction，否则遇到私有包或 prompt 会挂起；加--no-dev --optimize-autoloader，否则 vendor 体积多出 2–3 倍
镜像里跑 composer --version 成功，不代表 composer install 能过——ext-zip、phar、openssl 缺一不可，且用户权限和缓存目录归属必须手动对齐。
