Alpine 3.16+中apk add composer必然失败，因官方已移除该包，认定其为PHP应用层工具；必须用curl安装并预装git/unzip/curl，启用phar/openssl/zlib扩展，结合多阶段构建裁剪镜像。
为什么apk add composer在Alpine 3.16+上必然失败
不是网络或权限问题，是Alpine官方从3.16起彻底移除了composer包。维护者明确将其划为“PHP应用层工具”，不再交由apk管理——它对git、unzip的版本要求与musl生态存在底层冲突。你看到的ERROR: unable to select packages，本质是仓库里根本没这个包。侥幸在旧版装上的v1.x也大概率报Class 'Phar' not found，因为默认镜像没启用phar扩展。
curl | php安装卡住的三个硬性依赖
官方脚本curl -sS https://getcomposer.org/installer | php在Alpine上静默失败，常见现象是停在Cloning into或failed to extract。根本原因不是脚本本身，而是缺三样东西：
-
git：拉私有仓库、解析"type": "vcs"源必需 -
unzip：Packagist上90%的包以ZIP分发，没它连vendor目录都解不开 -
curl：HTTPS源下载元数据和包文件，Alpine基础镜像默认不带
必须在执行安装前跑：apk add --no-cache git unzip curl；装完立刻删：apk del --purge git unzip curl，否则这些工具会污染运行时镜像。
PHP扩展缺失导致composer install直接报错
即使composer.phar能生成，运行composer install仍可能崩在ext-zip not available或Class 'Phar' not found。这不是没装扩展，而是没启用：
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
-
php83-phar：加载.phar文件的基础，缺了composer.phar根本无法执行 -
php83-openssl：校验HTTPS下载内容、验证包签名，缺失会导致SSL certificate problem -
php83-zlib：解压ZIP包，没有它failed to extract会反复出现
验证是否生效：php -m | grep -E "^(phar|openssl|zlib)$"必须输出三行。注意PHP版本号要跟镜像一致（如php83-而非php82-）。
多阶段构建中vendor/复制失败的典型陷阱
很多人以为“把composer install跑完就完事了”，结果最终镜像体积翻倍、启动慢、甚至autoload断裂。关键不在“能不能装”，而在“装在哪、留不留”：
- builder阶段必须用
php:8.3-cli-alpine（含完整CLI链），不能用alpine:latest自建PHP -
composer install必须加--no-dev --optimize-autoloader --no-interaction，否则dev依赖拖垮体积，交互式prompt会让CI挂起 - runtime阶段只
COPY --from=builder /app/vendor /app/vendor，绝不复制composer.json、composer.lock或/root/.composer - builder末尾务必清理：
rm -rf /root/.composer /tmp/* /var/cache/apk/*，前提是前面apk add已带--no-cache
最容易被忽略的是权限和扩展启用顺序——docker-php-ext-enable必须在apk add之后、composer install之前执行，且ext-zip的启用依赖zlib已加载。漏掉任意一环，vendor/里看似有文件，但require vendor/autoload.php会直接500。
