composer --version成功仅说明命令可执行，不保证环境就绪；需进一步运行composer init、composer install和php -l vendor/autoload.php验证PHP环境、网络、权限及扩展等是否完备。
composer --version 能跑不代表环境就 OK
输出版本号只说明 composer 命令能执行，不等于 PHP 环境、扩展、网络、权限都就绪。常见现象是 composer --version 成功，但 composer install 卡在 Could not load package 或直接报 mkdir(): Permission denied。
真正验证环境是否可用，必须进项目根目录（含 composer.json）后执行三步：
-
composer init（空目录下回车默认即可，生成composer.json）—— 测试基础 PHP 运行时和临时目录写入权限 -
composer install—— 测试网络连通性、SSL 配置、缓存目录可写、PHP 扩展（如ext-zip,ext-curl）是否启用 -
php -l vendor/autoload.php—— 验证自动加载文件语法无误，且当前 PHP 版本能解析它（避免高版本语法导致运行时报错）
check-platform-reqs 不是万能的，但它能暴露最硬的兼容问题
composer check-platform-reqs 只检查 composer.json 中声明的 require.php 和 config.platform 是否满足，不涉及网络或磁盘权限。但它能提前发现你根本跑不动项目的事实。
运行前确认三件事：
- 必须在项目根目录下执行，否则报
Could not find composer.json -
composer.json里得有"require": {"php": "^8.1"}这类声明，否则命令无输出 - 若项目用了
config.platform.php，该命令检查的是“模拟环境”，不是你当前真实 PHP 版本——容易误判
典型输出：php: 8.1.27 (64 bit) does not satisfy php ^8.2。这时别急着升级 PHP，先看是不是 config.platform.php 写死了 8.2，而你本地其实是 8.1 —— 删掉 config.platform.php，让检查回归真实环境。
PHP 版本和扩展缺失，install 阶段才报，但运行时才崩
composer install 会校验 require.php 和扩展要求（如 "ext-gd": "*"），不满足就中断并提示 Your requirements could not be resolved。但一旦安装成功，vendor/autoload.php 就能加载，哪怕 PHP 版本低于声明值。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
真出问题是在运行时：
- PHP 8.0 项目写了
"php": "^8.2"，你用 8.1 强行COMPOSER_IGNORE_PLATFORM_REQS=1 install—— 安装完可能一切正常，直到某处用了match表达式，直接ParseError - 扩展缺失（如没开
ext-mbstring）也会被require检查拦住，但如果你绕过检查，运行时调用mb_strlen()就是Fatal error
所以 CI 或部署脚本里别只信 composer install 成功，加一句：php -v && php -m | grep -E '^(gd|mbstring|zip|curl)$'。
Flex 自动配置失效？先看 recipe 是否真触发了
Symfony 项目里，config/packages/my_bundle.yaml 文件存在 ≠ bundle 已加载。Flex 的 recipe 是一次性写入动作，依赖三个条件同时满足：包版本匹配 recipe 目录、"extra": {"symfony": {"allow-contrib": true}} 存在、composer recipes 显示 ✅。
排查步骤很具体：
- 运行
composer require symfony/mailer -v，日志里没出现[Symfony\Flex\Recipe]字样，说明 Flex 根本没接管 - 运行
composer show symfony/flex，返回空或not found，得先composer require symfony/flex --dev - 运行
composer config extra.symfony.allow-contrib，返回false就立刻改：composer config extra.symfony.allow-contrib true
recipe 没生效时，手动改 config/bundles.php 加上 MyBundle::class => ['all' => true] 是最快绕过方式，但别忘了清缓存：php bin/console cache:clear --env=prod —— dev 环境清了，prod 下还是老配置。
