--ignore-platform-reqs仅跳过安装前php版本、扩展（如ext-redis）、系统库的校验，不确保其真实存在，故运行时因缺失扩展或语法不兼容仍会报class 'redis' not found等错误。
直接加 --ignore-platform-reqs 或删 composer.lock 强行通过安装，不是“跳过检查”，而是绕过校验逻辑——结果极可能在运行时崩溃，且问题难以复现。
为什么 --ignore-platform-reqs 会导致运行时 Class not found
它只跳过 PHP 版本、扩展（如 ext-swoole）、系统库（如 lib-curl）的安装前检查，但不保证这些组件真实存在或可用。
- 本地没装
ext-redis，加该参数后composer install成功，但运行时new Redis()直接报Class 'Redis' not found - 项目依赖
laravel/octane，它硬要求ext-swoole，忽略后php artisan octane:start启动即失败 - 写成
--ignore-platform-reqs=true会被 Composer 当作非法参数，命令直接退出 - 更安全的做法是精准放行：例如只忽略 PHP 版本而保留扩展检查，用
composer install --ignore-platform-req=php
删 composer.lock 后 composer install 为什么报错
composer install 的语义就是“按锁文件还原”，没有 composer.lock，它根本不知道该装什么版本——这不是忽略，是命令误用。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 删锁文件后执行
composer install，会直接报Lock file does not contain required package或拒绝运行 - 正确做法是删锁后改用
composer update：它读composer.json，重新解析依赖树，生成新锁文件 - 若只是修复损坏的
vendor/，应只删vendor/，保留composer.lock，再跑composer install - 手动编辑
composer.lock更危险：哪怕改错一个逗号，JSON 解析失败就会触发Invalid argument supplied for foreach()
强制安装特定版本却提示 “don’t install” 的真实原因
这不是权限或网络问题，是 Composer 的 SAT 求解器判定当前依赖图无解——有其他包明确声明了冲突约束。
- 先查谁在拦：
composer prohibits vendor/package:v3.2.0，输出会明确指出哪个包的哪条require导致冲突 -
--ignore-platform-reqs对这类冲突完全无效；--force-reinstall也仍会校验兼容性 - 可行路径只有两条：① 手动调低冲突包版本再
composer update conflicting-package；② 先composer require vendor/package:v3.2.0 --no-update，再composer update vendor/package --with-all-dependencies - 临时注释掉
composer.json其他require来单独安装，风险极高，极易漏依赖
CI/CD 中用 --ignore-platform-reqs 的隐性代价
它把环境兼容性问题从安装阶段拖到运行时暴露，排查成本翻倍，且无法稳定复现本地行为。
- CI 使用 PHP 8.0，但加该参数后装上了只兼容 PHP 8.2 的包，运行时报
Undefined function str_contains() - 本地能跑，CI 失败，因为 CI 默认启用严格模式，而你的忽略操作绕过了依赖求解器的环境适配逻辑
- 真正可控的做法是：CI 环境用 Docker 固定 PHP 版本 + 扩展组合；
composer.lock必须提交且未被.gitignore；禁用composer update在测试环境的执行权限 - 如果必须跨环境构建，应设
COMPOSER_PLATFORM_CHECK=0并配合platform配置 +composer update --lock生成兼容锁文件
最易被忽略的一点：所有“强行通过”的操作，都会让 composer.lock 中的 content-hash 和实际依赖树脱钩——下次有人不做任何修改就 composer install，可能装出和你完全不同的 vendor/ 结构，连错误都不可复现。
