symfony插件系统本质是符合规范的bundle，通过composer加载、kernel注册、配置驱动和服务注入管理；需创建bundle骨架、注册到bundles.php、定义配置接口、控制实体映射、暴露twig功能，并以symfony-bundle类型发布为composer包。
在 Symfony 中构建可复用、可插拔的插件系统，本质就是开发符合框架规范的 Bundle。它不是第三方插件市场那种 ZIP 包安装机制，而是通过 Composer 加载、Kernel 注册、配置驱动、服务注入的完整生命周期管理——Bundle 就是 Symfony 的插件。
创建 Bundle 的基础骨架
进入项目根目录，执行官方 Maker 命令：
php bin/console make:bundle MyPlugin
命令会提示你选择命名空间（如 【MyPlugin\Bundle】）、Bundle 类名（默认 MyPluginBundle）、是否生成空目录结构。选“yes”后，它自动创建 src/MyPlugin/Bundle/MyPluginBundle.php 及 Resources/config/services.yaml。
这一步必须完成注册到 AppKernel（Symfony 5.4 及更早）或 config/bundles.php（Symfony 6+）。Maker 默认帮你写入 config/bundles.php，但若你手动创建 Bundle，漏掉这行会导致整个 Bundle 不被加载——【Bundle 类必须在 bundles.php 中返回 true 才能生效】。
定义插件配置接口（YAML 驱动）
让使用者能通过 config/packages/my_plugin.yaml 控制行为，需在 Bundle 内部实现 Extension 类：
在 src/MyPlugin/Bundle/DependencyInjection/ 目录下新建 MyPluginExtension.php，继承 SymfonyComponentDependencyInjectionExtensionExtensionInterface。
必须实现 getConfiguration() 方法：返回一个 Configuration 实例，用 TreeBuilder 定义允许的键（如 enabled、timeout、api_key），并设 defaultValue() 和 isRequired()；load() 方法接收解析后的 $config 数组，再调用 $container->loadFromExtension('my_plugin', $config) 加载 services.yaml 或动态注册服务。
注意：Configuration 类必须放在同级 DependencyInjection/Configuration.php 文件中，且命名空间要与 Bundle 匹配，否则框架找不到配置 schema。
提供可开关的实体与数据库表
若 Bundle 内含 Doctrine 实体但不希望所有用户都生成对应表，不能靠注释或条件判断跳过映射——Doctrine 会扫描全部 Entity 目录。
方法一：用自定义 Metadata Driver
创建类 src/MyPlugin/Bundle/Doctrine/ConditionalAnnotationDriver，继承 DoctrineORMMappingDriverAnnotationDriver，在 loadMetadataForClass() 中检查 $className 是否在 bundle 配置的 allow_entities 列表里，不在则直接 return null；再在 Extension 的 load() 中替换默认 driver：$config['metadata_cache_driver'] = ['type' => 'custom', 'class' => ConditionalAnnotationDriver::class];
方法二：把实体移出默认扫描路径
将实体放在 src/MyPlugin/Bundle/Entity/Optional/ 下，并在 doctrine.yaml 中显式排除该路径：doctrine.orm.mappings.my_plugin.is_bundle: false; doctrine.orm.mappings.my_plugin.dir: '%kernel.project_dir%/src/MyPlugin/Bundle/Entity/Core'——这样只有明确包含的目录才参与映射。
暴露 Twig 函数与模板片段
步骤一：在 services.yaml 中声明 Twig 全局函数服务：
my_plugin.twig_extension: class: MyPluginBundleTwigMyPluginExtension tags: [{ name: 'twig.extension' }]
步骤二：编写 MyPluginExtension 类，继承 TwigExtensionAbstractExtension，重写 getFunctions() 返回新函数数组，每个函数用 TwigTwigFunction 包装，回调指向 Bundle 内部服务方法。
步骤三：把模板片段放至 Resources/views/Includes/，例如 alert.html.twig；使用者可通过 {% include '@MyPlugin/Includes/alert.html.twig' %} 直接调用——【@MyPlugin 命名空间由 Bundle 类的 getName() 方法返回值决定，不可随意修改】。
发布为 Composer 包供他人安装
第一步：在项目根目录创建 composer.json（非应用级，是 Bundle 级），内容含 name（如 mycompany/my-plugin-bundle）、type（symfony-bundle）、autoload（psr-4 映射 MyPlugin\Bundle → src/）、require（指定兼容的 symfony/framework-bundle 版本）。
第二步：打 Git 标签，如 git tag v1.0.0；推送到 GitHub/GitLab 仓库。
第三步：提交到 Packagist.org 并启用自动更新。其他项目只需 composer require mycompany/my-plugin-bundle 即可安装，Composer 自动触发 autoload 注册和 bundles.php 添加逻辑。
这一步操作起来很简单，直接把文件拖进去就行。
