最可靠判断PHP位数的方法是执行php -r "echo PHP_INT_SIZE === 8 ? '64-bit' : '32-bit';"，输出64-bit才达标；若为32-bit，需切换至64位PHP环境，否则依赖64位特性的包将运行异常。
Composer 本身不区分 PHP 的 32 位或 64 位架构，但它依赖的扩展、二进制包、甚至某些逻辑（比如 PHP_INT_SIZE === 8 判断）会因架构不同而行为异常——报错往往出现在 composer install 阶段，但根因是运行时环境不匹配。
如何快速判断当前 PHP 是 32 位还是 64 位
别信“系统是 64 位就代表 PHP 是 64 位”，Windows 上旧版 XAMPP、macOS 上用 Homebrew 装错版本、Docker 里拉了 i386 镜像，都可能导致 PHP 实际跑在 32 位模式下。最可靠的方式是执行：
php -r "echo PHP_INT_SIZE === 8 ? '64-bit' : '32-bit';"
输出 64-bit 才算真正达标。如果输出 32-bit，后续所有“要求 64 位”的包（如某些 UUID 库、PECL 扩展、预编译 CLI 工具）都会出问题。
用 php-64bit 虚拟平台包强制约束依赖
这是 Composer 原生支持的最干净方案：在 composer.json 中声明依赖，让安装失败发生在早期，而不是运行时报错。
- 添加到
require区域："php-64bit": "*"
- 它不是真实包，也不需要安装——只要你的 PHP 是 32 位，
composer install就会直接报错：Your requirements could not be resolved to an installable set of packages. - 注意：
php-64bit依赖识别靠 Composer 自动探测，某些容器或精简环境可能漏判；若不确定，先手动运行上面的PHP_INT_SIZE检查。
绕过检查只是掩耳盗铃，--ignore-platform-reqs 不解决运行时问题
很多人遇到 Your requirements could not be resolved 就加 --ignore-platform-reqs 强行装完，结果一运行就崩——尤其涉及大整数、时间戳精度、指针偏移的逻辑（比如 Laravel 的 Str::uuid() 在 32 位下可能生成重复 ID）。
-
composer install --ignore-platform-req=php：跳过 PHP 版本+位数校验 -
composer install --ignore-platform-reqs：跳过全部平台约束（含ext-gd、php-64bit等） - 它们只影响安装阶段，不会让 32 位 PHP 正确执行 64 位专用代码
- 仅限临时调试验证，上线前必须切回 64 位 PHP 环境
根本解法：切换到 64 位 PHP 环境（按系统实操）
别折腾兼容，直接换环境才是稳定路径。关键是确认并替换“实际被 Composer 调用的那个 PHP”：
-
Windows：卸载旧 XAMPP/WAMP，改用 php.net 官方 64 位 ZIP 包，或 Laragon（默认带 64 位 PHP）；装完后检查
where php和php -v输出路径是否指向新目录 -
macOS：Homebrew 默认装 64 位，但老命令如
brew install php@7.4可能残留 32 位；执行brew uninstall php@8.2 && brew install php@8.2（新版不再支持--cask写法），再确认arch输出为x86_64或arm64 -
Docker：确保 base image 是
php:8.2-cli（官方镜像已全架构支持 amd64/arm64），避免使用php:8.2-cli-i386（极罕见）；用docker run --rm php:8.2-cli php -r "echo PHP_INT_SIZE;"直接验证
切完务必双重验证：php -v 看版本，php -r "echo PHP_INT_SIZE;" 看值是否为 8——很多 CI 流水线卡在这里，因为构建镜像和运行镜像用的不是同一个 PHP。
