Symfony Flex本地测试与私有Recipe覆盖问题求助

问题 #

我在为测试目的本地覆盖Symfony Flex recipes时遇到问题，已完成以下操作：

1. 为Symfony 5.4及以上版本实现了一个Symfony Bundle；
2. 将其发布到Packagist；
3. 阅读了Symfony 6.4文档《如何配置和使用Flex私有Recipe仓库》及其他资料；
4. 创建了一个私有仓库，按照symfony/recipes或symfony/recipes-contrib的结构搭建，包含工作流；
5. 按照文档说明创建Recipe并推送到私有仓库；
6. 从零创建新Symfony项目，用于测试composer require ...和composer remove ...命令；
7. 在根Symfony项目的composer.json中配置使用私有仓库作为Flex recipes源；
8. 运行composer update测试更改，但Symfony Bundle始终未使用私有Recipe，而是每次使用自动生成的配方。

需要指导：

• 如何在添加到仓库前本地测试Symfony Flex recipes？
• 如何正确覆盖Symfony Flex recipes并强制使用私有仓库中的配方？

一、本地测试Symfony Flex Recipes #

方法1：使用本地配方目录 #

1. 按官方规范搭建本地配方目录，结构示例：

   local-recipes/
   └── your-vendor/
       └── your-bundle/
           ├── 5.4/
           │   ├── composer.json
           │   ├── config/
           │   │   └── packages/
           │   │       └── your_bundle.yaml
           │   └── manifest.json
           └── manifest.json
   

2. 在测试项目的composer.json中添加本地配方源，确保优先级高于默认源：

   "extra": {
       "symfony": {
           "allow-contrib": true,
           "endpoint": [
               "file:///absolute/path/to/local-recipes",
               "flex://defaults"
           ]
       }
   }
   

3. 清除缓存并重新安装包：

   composer clear-cache
   composer require your-vendor/your-bundle
   

方法2：直接安装本地配方文件 #

1. 确保项目已安装Symfony Flex：

   composer require symfony/flex --dev
   

2. 直接从本地文件安装配方：

   php bin/console recipe:install your-vendor/your-bundle --file=/path/to/local-recipes/your-vendor/your-bundle/5.4/manifest.json
   

   此命令可快速验证配方的配置文件、bundle注册等逻辑是否生效。

二、强制使用私有仓库的配方 #

1. 确认私有仓库配置优先级 #

检查测试项目composer.json的extra.symfony.endpoint，私有仓库必须放在flex://defaults之前：

"extra": {
    "symfony": {
        "allow-contrib": true,
        "endpoint": [
            "https://your-private-recipes-repo-url",
            "flex://defaults"
        ]
    }
}

2. 彻底清除缓存与旧配方记录 #

Flex会缓存配方信息，需清理后重新拉取：

# 清除Composer全局缓存
composer clear-cache
# 删除项目本地的配方锁文件
rm -rf .symfony.lock

3. 指定包版本安装 #

确保安装的包版本与私有仓库中配方的版本严格匹配：

composer require your-vendor/your-bundle:^5.4

4. 标记配方为官方（可选） #

如果私有配方未被标记为官方，Flex可能优先使用自动生成的配方。在私有仓库配方的根manifest.json中添加：

{
    "bundles": {
        "YourVendor\\YourBundle\\YourVendorBundle": ["all"]
    },
    "official": true,
    "version": "5.4"
}

5. 验证配方来源 #

安装完成后，查看.symfony.lock文件，确认配方来源为你的私有仓库：

"your-vendor/your-bundle": {
    "version": "5.4.0",
    "recipe": {
        "repo": "https://your-private-recipes-repo-url",
        "branch": "main",
        "version": "5.4",
        "ref": "abc123..."
    }
}

内容的提问来源于stack exchange，提问作者Wolf