Composer不支持主动声明架构限制，所谓“只允许x64安装”实为通过composer.lock中自动写入的"php-64bit"标识在校验阶段触发，若当前PHP环境为32位则install失败；--ignore-platform-reqs仅跳过校验，不解决vendor/bin二进制运行时兼容问题。
Composer 本身不支持直接限制“只能在 x64 架构安装”，也没有 platform.arch 或 platform.os-arch 这类配置项。所谓“架构限制”，实际是通过校验 PHP 自身的位数标识（php-64bit 或 php-32bit）间接实现的，且仅在 composer install 阶段比对 composer.lock 中记录的平台快照时触发。
为什么 composer install 会报 “不支持的架构”？
这不是你在安装前主动设的“开关”，而是 Composer 在读取 composer.lock 时，发现其中记录的 platform 字段（比如 "php-64bit": "8.1.28"）与当前 PHP 环境不匹配。常见于：
- CI 流水线用 Alpine x86_64 镜像生成 lock 文件，开发者本地是 macOS ARM64 + PHP 8.3
- 团队协作中有人用 32 位 PHP 执行了
composer update，锁入了php-32bit标识 - 依赖包（如
spatie/browsershot）自带预编译二进制，其bin/脚本绑定 x86_64 指令集，但 Composer 只在校验阶段报错，不检查运行时兼容性
如何让项目“只允许 x64 环境安装”？
你不能靠 composer.json 主动声明“仅 x64”，但可通过以下方式强制校验：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在 CI 或部署脚本中，始终用
composer install --no-dev（不加--ignore-platform-reqs），确保php-64bit校验生效 - 若 lock 文件里已含
"php-64bit": "8.1.28"，则任何 32 位 PHP 环境执行composer install都会失败，错误信息类似：Your lock file does not contain a compatible set of packages - 不要手动往
composer.json的platform里写"php-64bit": "8.1.28"—— 这个字段是 Composer 自动生成并写入 lock 的，不是用户配置项；写错位置（比如塞进config.platform）完全无效
误用 --ignore-platform-reqs 的后果
用 composer install --ignore-platform-reqs 能跳过 php-64bit 检查，但装上 ≠ 能跑：
-
vendor/bin下的可执行文件（如 PHAR 或 musl 编译的二进制）仍会因 CPU 指令集不匹配而报Bad CPU type in executable -
--ignore-platform-req=php-64bit比全量忽略稍安全，但它只跳过位数校验，不解决二进制兼容问题 - 真正要跨架构运行，得靠源码安装（如使用
"bin-compat": "full"让 Composer 生成 PHP 包装器，而非调用原生二进制）
最易被忽略的一点：架构校验只发生在 composer install 阶段，且完全依赖 composer.lock 内容；如果你没提交 lock 文件，或有人用不同架构环境更新过它，这个“限制”就形同虚设。
