composer 不支持根据 cpu 架构自动匹配包版本，仅依赖 php 版本和扩展名进行依赖解析，不读取 uname、php_uname('m') 或 docker platform 字段；架构适配需由包作者通过运行时脚本或私有包实现。
Composer 不支持根据 CPU 架构（如 arm64/x86_64）或操作系统平台标签自动匹配包版本。 它根本不会读取、解析或利用 php_uname('m')、uname -m 或 Docker 的 platform 字段来做依赖筛选——所有“平台感知”仅限于 PHP 版本和扩展名（如 ext-curl），且仅通过 require 和 config.platform 显式声明生效。
为什么 composer install 不会因 arm64 自动选不同版本的包
Composer 的依赖求解器只关心三类元数据：包的 composer.json 中声明的 require.php、require.ext-xxx 和 conflict 字段；本地运行环境报告的 PHP 版本与已加载扩展；以及 lock 文件中记录的已验证组合。它不查询 php -v 输出里的架构信息，也不检查 /proc/cpuinfo 或容器 PLATFORM 标签。哪怕你在 docker buildx build --platform linux/arm64 下执行 composer install，只要 php -v 返回的是 PHP 8.2.12，它就只按这个 PHP 版本去过滤 packagist 上所有满足 "php": "^8.2" 的版本，完全无视你当前跑在 Apple M2 还是 AWS Graviton 上。
- 所有架构相关适配必须由包作者主动实现：比如用
bin/下不同二进制、或通过scripts+post-install-cmd检测php_uname('m')后下载对应预编译产物 - Composer 只负责把
vendor/目录结构拉下来，不负责判断某个.so文件是否能在 arm64 上dlopen - 如果你看到某包“似乎适配了多架构”，那是因为它的
install脚本做了运行时判断，不是 Composer 在安装期做的版本路由
config.platform 无法设置架构，只能伪造 PHP 和扩展版本
config.platform 是 Composer 唯一能“欺骗”自身解析逻辑的配置项，但它只接受 php、ext-xxx、lib-xxx 这三类键，不支持 arch、os、platform 等字段。写 "platform": {"arch": "arm64"} 完全无效，Composer 会静默忽略该字段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 合法写法只有：
"platform": {"php": "8.1.0", "ext-gd": "8.1.0"} - 它只影响依赖解析阶段的“可用版本候选集”，不改变实际下载行为——就算你设
"php": "7.4.33"，如果包 v3.0 元数据里明确写了"php": "^8.0"，它依然不会被选中 - 试图靠 platform 掩盖架构差异（比如在 x86 CI 里假装自己是 arm64）毫无意义，因为 Composer 根本不看这个维度
真正起作用的架构适配手段只有两种
若你确实需要为不同 CPU 架构安装不同依赖（比如预编译的 grpc.so 或 protobuf.so），必须绕过 Composer 的纯 PHP 依赖模型，采用以下任一方式：
- 用
scripts配合post-install-cmd：在composer.json里定义脚本，运行时调用php -r "echo php_uname('m');"判断架构，再用curl下载对应二进制并放入ext/目录 - 用私有包 + 条件化
repositories：为每个架构发布独立包（如myorg/grpc-arm64和myorg/grpc-amd64），并在 CI 脚本中根据uname -m动态改写composer.json的require字段，再执行composer update - 放弃 Composer 管理二进制：把架构敏感部分移出
vendor/，改用容器COPY或启动脚本初始化，让 Composer 只管纯 PHP 逻辑
最常被忽略的一点：Docker 多平台构建中的 --platform 只控制基础镜像和最终镜像的元数据，不影响中间层运行的 php 进程本身的能力。你在 FROM php:8.2-cli 镜像里执行 composer install，它看到的永远是那个镜像里 php -v 报出的版本和扩展，而不是你构建时传的 linux/arm64 标签。
