Composer本身可在ARM架构原生运行，但依赖安装失败或vendor不可用，根本原因是PHP运行时、扩展、预编译二进制或Docker镜像平台错配；必须确保PHP及openssl、mbstring、xml、zip、curl等扩展均为arm64/aarch64原生构建并正确配置证书路径。
Composer 本身能在 ARM 架构上正常运行，但依赖安装失败或 vendor 不可用，几乎全是 PHP 运行时、扩展、预编译二进制或 Docker 镜像平台错配导致的——不是 Composer 的 bug，而是环境链路没对齐。
确认 PHP 和关键扩展是否为原生 arm64/aarch64
这是所有问题的起点。ARM 上 composer install 卡住、报 Illegal instruction: 4 或 cannot open shared object file，90% 源于 PHP 或其扩展非原生架构。
- 运行
file $(which php)，输出必须含arm64（M1/M2）或aarch64（Raspberry Pi）；若显示x86_64，说明你在 Rosetta 或 Intel Homebrew 下运行，立刻停用 - 检查必需扩展是否启用：
php -m | grep -E '^(openssl|mbstring|xml|zip|curl)$'，缺任一都可能导致 Packagist HTTPS 请求失败或 autoload 生成中断 - 验证 openssl 是否正确链接证书：
php -r "print_r(openssl_get_cert_locations());"，若default_cert_file为空或指向不存在路径，需手动配置openssl.cafile（常见于 Homebrew OpenSSL）
避免 vendor 中混入 x86_64 预编译二进制
即使 PHP 是 arm64，composer install 仍可能拉取 x86_64 的 CLI 工具（如 pest、phpunit 的 PHAR）、PHP 扩展（如 swoole、grpc 的 .so）或 Go 编写的 bin 脚本，导致后续在 ARM 容器或服务器上执行时报 exec format error。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 禁用自动下载预编译包：安装扩展时加
-f强制源码编译，例如pecl install -f swoole - 跳过平台敏感插件：移除
hirak/prestissimo（已废弃）、phpstan/extension-installer等可能触发二进制下载的包 - 锁死目标平台能力：在
composer.json中显式声明"config": {"platform": {"php": "8.3.0", "ext-openssl": "8.3.0"}}，让依赖解析阶段就排除需要 x86_64 扩展的包
构建阶段分离：别在 ARM 服务器上直接跑 composer install
生产服务器不应承担依赖解析和编译任务。ARM 服务器上直接 composer install 会暴露环境差异、权限限制、内存不足（memory_limit 默认常为 128M，不够解析大型 lock 文件）等问题。
- CI 或本地构建机使用与目标服务器一致的 PHP 版本和架构（如
php:8.3-cli-slimARM64 镜像），执行composer install --no-dev --optimize-autoloader --classmap-authoritative - 部署时只同步代码 +
vendor/+composer.lock，不执行任何 Composer 命令 - 若必须热更新，用
composer install --no-dev --no-scripts --classmap-authoritative，禁用 post-install-cmd（避免调用php artisan等可能因扩展缺失而崩的命令）
Docker 构建时复用 Composer 缓存而非 vendor 目录
不能把 ARM 主机生成的 vendor/ 直接挂进 --platform linux/amd64 容器——架构不兼容。但 ~/.composer/cache 是纯数据，可安全复用。
- 启用 BuildKit：
DOCKER_BUILDKIT=1+BUILDKIT_PROGRESS=plain - 在
Dockerfile中用COPY --from=cache /root/.composer/cache /root/.composer/cache（需配合多阶段构建） - 更稳的做法是用
docker buildx bake配合 registry cache，让不同平台构建共享同一份下载层
最容易被忽略的是：PHP 扩展的架构一致性比 Composer 版本重要得多；而真正让 vendor “跨平台可用”的，从来不是安装参数，而是从一开始就不让它下载任何平台绑定的东西。
