Composer Flex 是 Symfony 官方推荐的包管理增强工具，通过 recipes 自动完成配置文件生成、Bundle 注册等操作；默认集成于 Symfony 4+，旧项目需手动安装 symfony/flex；支持 recipe 查看、更新、禁用及自定义贡献。
Composer Flex 是 Symfony 官方推荐的包管理增强工具，它通过“recipes”（配方）自动完成包安装后的配置工作，比如生成配置文件、注册 Bundle、复制资源、执行脚本等，大幅减少手动配置成本。
启用 Flex 并确认已安装
Flex 默认集成在 Symfony 4+ 的新项目中。若你的项目是旧版本（如 Symfony 3.x）或手动初始化，需先安装 Flex：
- 运行 composer require symfony/flex --dev（推荐作为开发依赖）
- 检查 composer.json 中是否已存在
"symfony/flex": "^3"（v3 适配 Symfony 6/7，v2 适配 Symfony 5） - 确保 COMPOSER_HOME 环境变量未被错误覆盖，否则 recipes 可能无法加载
安装包时自动触发 recipe
只要包在 Symfony Recipes 仓库 中有对应配方，执行 composer require 就会自动应用：
- 例如：composer require doctrine/doctrine-bundle → 自动生成
config/packages/doctrine.yaml和实体目录结构 - 安装后可查看变化：git status 会显示新增/修改的配置、路由、迁移模板等文件
- 若 recipe 未自动运行（如网络问题或包无 recipe），可手动执行：composer sync-recipes --force
管理 recipes：查看、更新与禁用
Flex 提供命令行工具统一管理配方行为：
- composer recipes：列出所有已安装包及其 recipe 状态（✅ 已应用 / ⚠️ 过期 / ❌ 未应用）
- composer recipes doctrine/doctrine-bundle：查看指定包的 recipe 详情和源地址
- composer recipes:update：批量更新过期的 recipes（会提示差异并允许交互式合并）
- 临时跳过 recipe：安装时加 --no-scripts；永久禁用某包 recipe，可在
composer.json中添加"extra": {"symfony": {"allow-contrib": false}}或为特定包设"symfony": {"recipe": false}
自定义或贡献 recipe
如果你维护一个 Symfony 兼容包，可以为它提交 recipe 到官方仓库：
- recipe 是纯静态文件集合（YAML 配置 + 文件模板），存放在
symfony/recipes-contrib（社区）或symfony/recipes（官方审核） - 结构示例：
vendor/package/1.0/config/packages/vendor_package.yaml，支持占位符如%%CONFIG_DIR%% - 本地调试 recipe：将配方目录放在
recipes/子目录下，运行 composer recipes:install vendor/package --force
Flex 不改变 Composer 核心逻辑，只是在 install/update 后钩入自动化配置流程。用好它，能让 Symfony 项目的扩展更轻量、一致且可追溯。
