composer 2.2+ 是 php 8.x 的唯一可行选择，因 1.x 不支持 php 8 语法（如联合类型），会报 parseerror；必须升级至 2.2.4+ 以兼容构造函数属性提升等特性，并通过 platform 配置锁定 php 版本确保依赖解析准确。
Composer 2.2+ 是 PHP 8.x 的唯一可行选择
PHP 8.0 及以上版本不支持 Composer 1.x，强行运行会直接报错 ParseError: syntax error, unexpected token "string"——这是因 Composer 1 用了 PHP 7 风格的类型声明（如 function foo(array $a)），而 PHP 8 强化了联合类型解析逻辑，导致旧版解析器崩溃。
必须升级到 Composer 2.2 或更高版本（推荐 2.5+），它原生支持 PHP 8.0–8.3 的所有语法特性，包括 mixed、static 返回类型、属性提升等。
- 检查当前版本：
composer --version；若显示Composer version 1.x，立刻卸载重装 - 官方安装命令（覆盖式）：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 验证是否生效：
php -d detect_unicode=Off -d memory_limit=-1 /usr/local/bin/composer --version（加参数防某些宿主环境报错）
composer.json 中的 platform 配置必须显式声明 PHP 版本
即使系统 PHP 是 8.2，Composer 默认仍按“当前运行环境”解析依赖，但 CI/CD 或容器构建时容易误用 host 的 PHP 版本。更危险的是：某些包在 require 中写了 "php": "^7.4 || ^8.0"，若没锁死 platform，Composer 可能选中仅兼容 7.4 的旧版子依赖，导致运行时报 Fatal error: Array and string offset access syntax with curly braces is no longer supported。
解决方法是在 composer.json 根级加 "platform" 字段，强制所有依赖解析基于目标 PHP 版本：
立即学习“PHP免费学习笔记（深入）”；
{
"config": {
"platform": {
"php": "8.2.10"
}
}
}
-
"platform"只影响依赖解析，不影响实际运行时 PHP 版本 - 值必须与部署环境一致，比如 Dockerfile 里是
FROM php:8.3-cli，这里就得写"php": "8.3"（补全小版本更稳） - 删掉
"platform"后运行composer update，可能触发大量依赖降级，别手抖
autoload 生成后需检查 classmap 是否含 PHP 8 专属语法
Composer 自动生成的 vendor/autoload_classmap.php 是纯 PHP 数组，但如果项目里某个类用了 PHP 8 的构造函数属性提升（public function __construct(public string $name)），而该类又被 classmap 扫描进了自动加载，早期 Composer 2.2.0–2.2.3 会因反射解析失败导致 Class not found——不是找不到文件，是根本没注册进 classmap。
这不是配置问题，是 Composer 自身 bug，修复版本从 2.2.4 开始：
- 运行
composer dump-autoload -o后，打开vendor/autoload_classmap.php，搜索public function __construct，确认对应类名已出现在数组中 - 若缺失，先升级 Composer：
composer self-update（确保 ≥ 2.2.4） - 再清空并重生成：
rm -rf vendor/autoload_*.php && composer dump-autoload -o - 注意：启用
-o（optimize）时，psr-4和classmap混用可能让某些类被跳过，建议开发期先用composer dump-autoload不加-o测试
插件和脚本在 PHP 8 下可能静默失败
很多 Composer 插件（比如 hirak/prestissimo、roave/security-advisories）未适配 PHP 8 的错误处理机制，表现为 composer install 卡住、无输出，或执行完 scripts 后直接退出不报错。典型线索是日志里出现 Deprecated: Function ReflectionParameter::getClass() is deprecated —— 这类提示在 PHP 8.1+ 默认不显示，但会终止插件执行。
排查优先级：先禁用插件，再逐个开：
- 临时跳过所有插件：
composer install --no-plugins - 查启用的插件：
composer global show --installed | grep -i plugin - 禁用全局插件（如
composer-unused）：composer global remove composer-unused/composer-unused - 项目级插件在
composer.json的"require-dev"里，注释掉再试
真正麻烦的是自定义 scripts：PHP 8 默认关闭 display_errors，脚本里哪怕有 parse error 也只返回 exit code 1，没任何提示。务必在 script 命令前加 php -d display_errors=1。
