alpine镜像装composer失败主因是缺phar、openssl、zlib扩展，需按顺序安装php83-phar、php83-openssl、php83-zlib并启用，再验证php -m输出三者；挂载导致vendor清空应改用子路径或.dockerignore；多阶段构建需builder加--optimize-autoloader，runtime执行dump-autoload并chown vendor。
直接装 composer 失败，不是网络或权限问题，而是 Alpine 镜像缺基础能力——补全依赖比换源更优先。
为什么 apk add composer 一定失败？
Alpine 3.16+ 官方仓库已移除 composer 包，错误提示 ERROR: unable to select packages 是明确信号，不是配置错，是包根本不存在。侥幸从 community 源装上的旧版，大概率因缺 phar、openssl 或 zlib 扩展而报 Class 'Phar' not found 或 SSL 错误。
- 别试
apk add php-composer或php8-composer——Alpine 没这种包名 - 别信
php -m | grep json显示已安装就完事，得确认docker-php-ext-enable json是否执行过 - 验证方式：进容器跑
php -r "new Phar('a.phar');"，不报错才算phar可用
curl | php 安装前必须装哪三个扩展？
官方安装脚本依赖运行时能力，缺一不可。Alpine 默认镜像只装 PHP 二进制，不启用扩展。顺序不能错：先 apk add，再 docker-php-ext-enable。
-
php83-phar：否则composer.phar根本无法加载 -
php83-openssl：校验签名、HTTPS 下载、包签名验证，缺它会卡在SSL certificate problem -
php83-zlib：解压 ZIP 包（Packagist 绝大多数包为 ZIP），缺它报failed to extract
验证命令：php -m | grep -E "^(phar|openssl|zlib)$" 必须输出三行。PHP 版本号（如 83）需与 php -v 主版本严格对齐。
挂载 ./:/var/www/html 导致 vendor 被清空？
这不是 Composer 错，是 Docker volume 挂载逻辑：宿主机空的 vendor/ 目录会直接覆盖镜像里预装好的依赖，composer install 白跑一遍。
- 最简解法：改用子路径挂载，例如
./src:/var/www/html/src:ro，避开vendor/和composer.json - 开发时若必须挂整个项目，加
.dockerignore并写入vendor/，防止 COPY 时带进去污染构建层 - CI 构建中禁用 volume 挂载，靠多阶段构建复制
/app/vendor，彻底隔离运行时与构建时
多阶段构建中 vendor 复制后 autoload 失效？
常见于 builder 阶段用了 --no-scripts，而 runtime 阶段没重生成 classmap。不是缓存没命中的问题，是 autoloader 文件本身缺失或未适配目标环境。
- builder 阶段务必加
--optimize-autoloader --classmap-authoritative - runtime 阶段若 PHP 版本或扩展（如
ext-zip）与 builder 不一致，vendor/autoload.php可能无法加载类 - 安全做法：runtime 阶段起手加
RUN composer dump-autoload --classmap-authoritative，确保映射准确 - 注意权限：
vendor/目录属主需与 runtime 用户一致，否则opcache或require可能静默失败
真正容易被忽略的点：Alpine 的 musl libc 对文件权限更敏感，chown -R www-data:www-data vendor/ 这步不能省，尤其当 builder 用 root、runtime 切非 root 用户时。
