报错明确提示PHP版本不满足时，应使用--ignore-platform-req=php精准跳过PHP版本检查，保留ext-*等扩展校验；该参数仅绕过"php": "^8.2"类声明，对依赖版本约束无效，多个平台项可叠加如--ignore-platform-req=php --ignore-platform-req=ext-gd。
直接用 composer install --ignore-platform-reqs 就能绕过，但别乱用——它跳过所有平台检查，包括 PHP 版本、扩展、lib 等，不是“修复”，只是临时跳过校验。
报错明确说 PHP 版本不满足时，该用哪个参数？
错误典型如：Your PHP version (7.4.33) does not satisfy that requirement 或 Root composer.json requires php ^8.2。这时最精准的做法是只忽略 PHP 版本检查，保留对扩展（如 ext-mbstring）的校验：
-
composer install --ignore-platform-req=php—— 只跳过 PHP 版本约束，其他照常检查 - 不要用
--ignore-platform-reqs全局跳过，除非你清楚所有依赖在当前环境 runtime 真的能跑 - 如果同时要忽略某个扩展（比如本地没装
ext-igbinary），可叠加：composer install --ignore-platform-req=php --ignore-platform-req=ext-igbinary
为什么 config.platform.php 有时比命令行参数更稳妥？
当你需要在项目中长期维持兼容性（比如团队共用低版本 PHP，但要生成适配高版本的 vendor/ 目录），config.platform.php 是编译期“假装有这个版本”的标准做法：
- 在
composer.json的config段加："config": { "platform": { "php": "8.1.28" } } - 值必须是完整语义化版本（
"8.1"会解析失败，得写"8.1.28"） - 它不影响 runtime，只影响
install/update阶段的包选择逻辑；运行时报错仍是 runtime 问题，跟 platform 无关 - CI 构建时推荐用这个，避免
--ignore-platform-reqs污染composer.lock
绕过之后，为什么 vendor/autoload.php 加载失败或 Class not found？
这不是 Composer 安装失败，而是自动加载机制没覆盖到——常见于被忽略平台后装了本不该装的包版本：
立即学习“PHP免费学习笔记（深入）”；
- 检查
vendor/composer/autoload_classmap.php是否包含你预期的类路径 - 运行
composer dump-autoload -o强制重生成 autoload 文件，比重装快 - 确认目标包的
composer.json真有autoload字段（如"psr-4"或"files"），没有就无法自动加载 -
--ignore-platform-reqs不会修复路径权限或缺失目录，vendor/下对应文件夹得真实存在且可读
真正容易被忽略的是：绕过检查 ≠ 代码能跑。PHP 8.2 的 match 表达式在 7.4 里永远 parse error，platform 配置和 ignore 参数都救不了语法层面的不兼容。
