Alpine中apk安装的Composer因PHP扩展未启用而报错，应改用官方phar安装并校验签名，或显式启用json/xml/zip等依赖扩展。
为什么 apk add composer 安装的 Composer 在 Alpine 里跑不起来？
Alpine 默认源里的 composer 包是系统打包维护的旧版本（常为 2.2.x），它依赖 php-json 和 php-xml 扩展，但 Alpine 的 PHP 镜像（比如 php:8.3-cli-alpine）默认不启用这些扩展——不是没装，是没启用。现象是运行 composer --version 报错：PHP Fatal error: Uncaught Error: Call to undefined function json_encode()。
- 别信
apk list | grep php-json显示已安装就万事大吉，得确认docker-php-ext-enable json是否执行过 - 更稳妥的做法是绕过系统包，用官方安装脚本：它会检测扩展、自动 fallback 到 phar 模式，兼容性更强
- 如果坚持用
apk安装，必须显式启用所有依赖扩展：docker-php-ext-enable json xml mbstring zip
如何在 Alpine Dockerfile 中正确安装最新版 Composer？
官方推荐方式是下载 composer.phar 并设为全局命令，这比系统包更新快、依赖少、行为一致。关键点不在“下载”，而在“校验”和“路径处理”——Alpine 的 /usr/local/bin 在 $PATH 里，但默认没有写权限（尤其非 root 用户构建时）。
- 用
curl -sS https://getcomposer.org/installer | php -- --install-dir=/tmp --filename=composer先装到/tmp，再mv到/usr/local/bin/，避免权限失败 - 务必验证签名：
php -r "copy('https://composer.github.io/installer.sig', '/tmp/composer-installer.sig');"，然后用openssl dgst -sha384校验（官方文档有对应哈希值） - 别漏掉
RUN chmod +x /usr/local/bin/composer，Alpine 的mv不保留可执行位
使用 composer install 时提示 “ext-zip not available” 怎么办？
这是 Alpine 下最典型的扩展缺失错误。虽然 zip 扩展名看着像压缩工具，但它实际是 PHP 解包 .zip 文件（比如下载包、解压 vendor）必需的，而 Alpine 的 PHP 镜像默认只装了 apk add php7-zip（旧版命名），新版 PHP 8+ 应该用 php8-zip 或统一用 php-zip（取决于 apk 源版本）。
- 先查清楚当前 PHP 版本：
php -v输出的主版本号（如 8.3），再装对应扩展：apk add php83-zip（Alpine 3.20+）或apk add php-zip（较新镜像已统一） - 装完必须启用：
docker-php-ext-enable zip，否则php -m | grep zip看不到 - 如果项目用了
hirak/prestissimo或其他插件，它们可能额外依赖ext-curl或ext-openssl，一并检查启用
为什么 composer update 在 Alpine 里特别慢甚至卡住？
根本原因是 Alpine 的 DNS 解析默认走 musl libc，对某些 CDN 域名（比如 packagist.org 的边缘节点）解析不稳定，加上 Composer 默认并发数高，容易触发超时或连接复用失败。
- 临时解决：加
--no-plugins和--no-cache排除插件干扰和缓存污染 - 长期方案：在
Dockerfile里写死 DNS，比如RUN echo "nameserver 8.8.8.8" > /etc/resolv.conf（注意别覆盖原有配置，可用sed -i替换） - 更轻量的办法是降并发：
COMPOSER_PROCESS_TIMEOUT=300 COMPOSER_HOME=/tmp/composer composer update --prefer-dist -n --jobs=4，避免默认 16 个并发把 musl 的 socket 耗尽
事情说清了就结束。Alpine 的坑不在 Composer 本身，而在 PHP 扩展启用机制、musl 的网络栈、以及 apk 包命名和 PHP 版本的错位——盯住这三个点，基本不会栽。
