Composer 兼容 PHP 8.3，但安装或运行失败多因 platform 配置、CLI 版本、扩展缺失未对齐；需确认 Composer 实际调用的 PHP 是否为 8.3，检查并补全 fileinfo 等必需扩展，合理设置 platform.php 和 require.php 版本约束。
Composer 本身完全兼容 PHP 8.3，但项目 install 失败或运行报错，90% 是因为 platform 配置、CLI 版本、扩展缺失三者没对齐，不是 Composer 本身的问题。
确认 Composer 实际用的 PHP 版本是不是 8.3
别只信 php -v，它可能和 Composer 调用的不是同一个解释器。Windows 上尤其常见：PATH 里 XAMPP 的 php.exe 排在前面，php -v 显示 7.4，但你装的是 8.3。
- 运行
which php（macOS/Linux）或where php（Windows），看第一个路径是否指向你的 PHP 8.3 安装目录 - 运行
composer show --platform—— 这个输出才是 Composer 内部读到的真实 PHP 版本和已启用扩展 - 如果两者不一致，说明 Composer 没走你预期的 PHP，必须显式调用：
/usr/bin/php8.3 /path/to/composer.phar install（Linux/macOS）或"C:\php\php83\php.exe" composer.phar install（Windows）
配置 config.platform.php 锁定目标环境版本
这个配置只影响 install 和 update 阶段的依赖解析，不改变运行时行为。它不是“让低版本 PHP 跑高版本代码”，而是告诉 Composer：“请按 PHP 8.3 的能力去选包”。
- 写法必须是完整版本号，例如
"8.3.0"；"^8.3"或">=8.3"会被静默忽略 - 加完后必须执行
composer update --lock，否则composer.lock仍记录旧版本包的约束 - 本地 CLI 是 PHP 8.1，但你要部署到 PHP 8.3 的服务器？这时才需要设
"platform.php": "8.3.0"，并配合--ignore-platform-reqs临时绕过本地校验（仅限 CI 构建）
检查并补全 PHP 8.3 必需扩展
很多失败不是 PHP 版本不够新，而是缺扩展。ThinkPHP 8、Laravel 11、Symfony 7 都强制要求 ext-fileinfo，而它在多数环境下默认未启用。
立即学习“PHP免费学习笔记（深入）”；
- Windows：打开
php.ini，取消注释extension=php_fileinfo.dll，重启终端（关掉再开） - Ubuntu/Debian：
sudo apt install php-fileinfo，然后sudo systemctl restart php8.3-fpm（Web 场景）或重开终端（CLI） - 验证是否生效：
php -m | grep fileinfo；若无输出，说明未加载成功 - 其他常见必需扩展：
ext-mbstring、ext-openssl、ext-curl，都得一个个确认
避免 "php": "^8.3" 这类窄约束
在 composer.json 的 require 段写死 "php": "^8.3" 是自找麻烦。Packagist 上绝大多数主流包（如 monolog/monolog、guzzlehttp/guzzle）当前稳定版仍只声明支持 "^8.0" 或 "^8.1 || ^8.2"。
- Composer 会因找不到满足
"^8.3"的候选版本而卡住，甚至返回空结果 - 推荐写法：
"php": "^8.0"或更宽松的"php": ">=8.0.0 ，保留升级弹性 - 真正要约束运行环境，靠的是
config.platform.php+ CI 测试，而不是require.php
最易被忽略的一点：每次切换 CLI PHP 版本后，vendor/ 和 composer.lock 必须全部删除，再用新版本 PHP 重新 install。生成的 autoload_static.php 会嵌入 PHP 版本相关的反射逻辑和语法适配，跨版本复用必然在运行时报 ParseError，哪怕安装过程看起来一切正常。
