alpine上“file not found”或“glibc_2.30 not found”报错根源不在composer本身（其为纯php脚本，不链接c库），而是项目依赖的二进制扩展（如sqlsrv.so、grpc.so）或cli工具（如protoc、vendor/bin/xxx）与musl libc不兼容；验证需用composer install -vvv定位失败命令，再以ldd检查具体so文件依赖；优先源码编译（如pecl install sqlsrv），必要时才引入glibc兼容层并同步补全libstdc++等依赖。
为什么Alpine上composer install报“file not found”或“GLIBC_2.30 not found”
这类报错根本不是Composer本身的问题，而是你误把错误对象当成了目标。Composer是纯PHP脚本（composer.phar），不链接任何C库；报GLIBC_2.30 not found的，一定是它调用的某个二进制扩展或CLI工具——比如sqlsrv.so、grpc.so、protoc，或者项目里某个vendor/bin/xxx脚本。
验证方法很简单：composer install -vvv看最后一行失败命令是谁；再用ldd vendor/ext/sqlsrv.so 2>/dev/null | grep libc.so确认是否真依赖glibc。
- 别急着装
glibc——Alpine用的是musl，硬塞glibc会引发更多符号冲突 - 优先尝试源码编译：比如
pecl install sqlsrv，前提是先apk add unixodbc-dev autoconf g++ - 若必须用预编译包，才考虑
GLIBC_VERSION=2.37-r0+LD_LIBRARY_PATH=/usr/glibc-compat/lib，但得同步补apk add glibc和兼容层
Alpine中“/usr/bin/env: 'php\r': No such file or directory”怎么修
这是典型的Windows换行符（\r\n）混入脚本导致的解析失败，常见于composer.json、composer.lock或自定义scripts里调用的shell脚本。
Alpine默认不带dos2unix，所以得先装再处理：
apk add --no-cache dos2unixdos2unix composer.json composer.lock- 如果项目里有
bin/目录下的shell脚本，也一并处理：find bin/ -type f -name "*" -exec dos2unix {} \;
注意：这个错误和PHP扩展无关，php -v能跑通不代表env能正确加载带\r的shebang行。
composer install卡在“Cloning into”或“Downloading”却不报错
这不是Composer挂了，是底层工具链缺失或DNS异常。Alpine镜像默认不含git、unzip、curl，且musl对/etc/resolv.conf的解析逻辑和glibc不同，容易导致GitHub包拉取超时。
- 构建阶段必须显式安装：
apk add --no-cache git unzip curl - Docker下建议加
--dns 8.8.8.8或在/etc/resolv.conf里硬写可信DNS - 私有Git仓库务必用HTTPS而非SSH协议（Alpine没
ssh-agent支持），并确保php-openssl已启用 - 临时验证可用：
git ls-remote https://github.com/laravel/framework.git refs/tags
“Class 'Phar' not found”或“undefined function json_encode()”说明什么
这代表PHP扩展已安装但未启用。Alpine的PHP包（如php83-json）只是把so文件放进/usr/lib/php83/modules/，不会自动激活——你得手动告诉PHP CLI去加载它们。
运行php -m | grep -E "^(phar|json|xml|mbstring|zip)$"，如果没输出，就说明没启用。
- 启用命令（注意PHP版本号对齐）：
docker-php-ext-enable phar json xml mbstring zip - 改完必须重启容器或重建镜像，
php -v不报错才算生效 - 别信
apk list | grep php-json显示已安装就完事——那只是包管理器层面的状态
真正容易被忽略的是：这些扩展缺一不可。phar让composer.phar可执行，json读composer.json，zip解包，openssl校验签名——少一个，install就停在不同环节。
