composer install 默认校验php版本、扩展及架构兼容性，跨平台时可用--ignore-platform-reqs跳过全部检查，或用--ignore-platform-req=xxx按需忽略特定项，但不解决预编译二进制兼容问题。
Composer install 时跳过平台检查
默认情况下，composer install 会校验当前 PHP 版本、扩展、架构（如 ext-xdebug 或 php-64bit）是否匹配 composer.lock 中记录的平台约束。跨平台调试（比如在 macOS 上装为 Linux 构建的包）时，这会直接报错：Your lock file does not contain a compatible set of packages。
真正起作用的是 --ignore-platform-reqs 参数——它跳过所有平台约束检查，包括 PHP 版本、扩展、架构、甚至 ext-sodium 这类硬依赖。
- 仅用于本地调试或 CI 中临时绕过，不要提交到生产部署流程
- 它不会修改
composer.lock，只是让安装阶段忽略其中的platform字段 - 如果包本身含平台相关二进制（如
spatie/browsershot调用 Puppeteer），跳过检查 ≠ 能正常运行
只忽略特定平台项（更安全的替代方案）
全量跳过太粗暴，容易掩盖真实兼容问题。Composer 支持按需忽略某几项，比如只绕过架构不匹配，但保留 PHP 版本和关键扩展检查：
用 --ignore-platform-req=php 忽略 PHP 版本；--ignore-platform-req=ext-xdebug 忽略某个扩展；--ignore-platform-req=php-64bit 忽略位数约束。多个用空格分隔：
composer install --ignore-platform-req=php-64bit --ignore-platform-req=ext-sodium
-
php-64bit和php-32bit是 Composer 内部识别的架构标识，不是 PHP 自身常量 - 忽略
ext-*后，运行时若真缺该扩展，会抛出Class not found或Call to undefined function - 这个参数不能写成
--ignore-platform-reqs=ext-xdebug，后者语法错误
为什么 vendor/bin 下的二进制可能仍报错？
即使 composer install 成功了，某些包自带的可执行文件（如 vendor/bin/phpunit、vendor/bin/pest）仍可能启动失败，报 Bad CPU type in executable（macOS）或 cannot execute binary file: Exec format error（Linux）。这是因为：
- 这些二进制是预编译的，绑定目标平台（如 Alpine Linux 的
musl版本），与宿主机不兼容 -
--ignore-platform-reqs只影响 PHP 包解析和 autoload 注册，不重编译或替换二进制 - 解决办法通常是改用源码安装：设置
"bin-compat": "full"并确保包提供bin/的 PHP 入口（而非 shell wrapper）
CI 中模拟不同平台环境的务实做法
本地强行安装≠能测出真实问题。CI 环境应尽量贴近目标平台：
- Docker 是最稳的选择：用
php:8.2-cli-slim镜像跑composer install，天然隔离平台差异 - 避免在 GitHub Actions 的
ubuntu-latest上用--ignore-platform-reqs模拟 Alpine 环境——ext-swoole这类扩展根本装不上 - 如果必须本地验证，优先用
docker run --rm -v $(pwd):/app -w /app php:8.2-cli composer install，比绕过检查更可靠
跨平台调试真正的难点不在安装那一步，而在运行时行为差异——比如 proc_open() 在 Windows 和 Linux 下对路径、引号、环境变量的处理完全不同，这些靠强制安装发现不了。
