Composer Recipes 是 Symfony Flex 提供的自动化配置机制，能根据安装的包自动注入配置、创建目录、注册 bundle 等；需启用 Flex、确保 SYMFONY_ENDPOINT 有效，安装已注册包时自动触发 Recipe 并支持预览与手动同步。
Composer Recipes 是 Symfony Flex 提供的自动化配置机制，能根据你安装的包自动注入配置文件、创建目录、注册 bundle 或设置环境变量。它让集成第三方包（比如 Doctrine、Twig、API Platform）变得几乎零手动配置。
确保项目启用 Symfony Flex
Flex 是 Recipes 背后的核心工具，必须启用才能生效。新 Symfony 项目默认已启用；老项目需手动安装：
- 运行 composer require symfony/flex --dev
- 检查 composer.json 中是否包含 "symfony/flex": "^2"（或 "^3"）并设为 plugin
- 确认 SYMFONY_ENDPOINT 环境变量未被禁用（默认指向
https://www.php.cn/link/14b7936e5785eacf8749f37ef562c1e5）
安装包时自动触发 Recipe
只要包在 Symfony Recipes 网站注册过，执行 composer require 就会自动拉取对应 Recipe：
- 例如：composer require doctrine/doctrine-bundle → 自动生成
config/packages/doctrine.yaml、注册DoctrineBundle、创建migrations/目录 - Recipe 执行前会显示预览（列出将新增/修改的文件），输入 y 确认，n 跳过
- 跳过后仍可手动运行 composer sync-recipes vendor/package-name 补回
查看和管理已安装的 Recipes
了解哪些 Recipe 已生效、是否兼容当前版本，有助于排查配置缺失问题：
- composer recipes：列出所有已安装 Recipe 及状态（Inst = 已安装，Mod = 被手动修改过）
- composer recipes vendor/package-name：查看某包 Recipe 的详情与原始文件差异
- 若配置被误改，可用 composer recipes:install vendor/package-name --force 强制重置为官方版本
自定义或覆盖 Recipe（谨慎使用）
多数情况无需干预，但特殊需求下可局部调整：
- Recipe 默认写入
config/下的标准路径，如需改位置（比如把 Doctrine 配置移到config/packages/prod/doctrine.yaml），先禁用自动安装：composer config extra.symfony.allow-contrib false - 然后手动复制 Recipe 内容，按需调整路径和参数
- 注意：自定义后 composer update 不再自动同步该包的 Recipe 更新，需自行维护
基本上就这些。Recipes 不是黑魔法，而是靠社区维护的标准化模板，关键是保持 Flex 启用、信任官方包、定期用 composer recipes 检查状态。
