symfony 2.7.10 创建自定义 bundle 需手动完成三步:生成目录结构(如 src/acme/hellobundle/ 及 acmehellobundle.php 类)、注册到 app/appkernel.php 的 registerbundles() 方法、可选配置路由与控制器;不支持 make:bundle 命令和 flex 自动注册。

Symfony 2.7.10 创建自定义 Bundle 需手动完成三步:生成目录结构、编写 Bundle 类、注册到内核。它不支持 make:bundle(该命令在 Symfony 3.4+ 才由 Maker Bundle 提供),也不具备 Flex 自动注册能力,必须显式配置。
1. 手动创建 Bundle 目录与类文件
Bundle 是功能模块单元,所有代码(控制器、模板、配置等)都放在其专属目录下。以 AcmeHelloBundle 为例:
- 在
src/下新建目录:src/Acme/HelloBundle/ - 在该目录中创建 Bundle 类文件:
Acme/HelloBundle/AcmeHelloBundle.php - 类内容严格如下(注意命名空间、继承、类名结尾):
namespace Acme\HelloBundle;
use Symfony\Component\HttpKernel\Bundle\Bundle;
class AcmeHelloBundle extends Bundle
{
}
⚠️ 常见错误:类名写成 AcmeHello 或 HelloBundle;文件名不是 AcmeHelloBundle.php;未使用 Symfony\Component\HttpKernel\Bundle\Bundle 命名空间。
2. 注册 Bundle 到 AppKernel
Symfony 2.7 使用 app/AppKernel.php 管理启用的 Bundle。打开该文件,在 registerBundles() 方法中添加实例:
new Acme\HelloBundle\AcmeHelloBundle(),
完整示例如下(位于 return 数组内):
public function registerBundles()
{
$bundles = array(
// ... 其他 bundle
new Acme\HelloBundle\AcmeHelloBundle(),
);
return $bundles;
}
✅ 添加后运行 php app/console debug:bundle | grep Acme,应能输出 AcmeHelloBundle 表示注册成功。
3. 添加路由与控制器(可选但典型)
Bundle 要对外提供功能,通常需配置路由并编写控制器:
- 在
src/Acme/HelloBundle/Resources/config/routing.yml中定义路由:
acme_hello:
pattern: /hello/{name}
defaults: { _controller: AcmeHelloBundle:Hello:index }
- 在
app/config/routing.yml主路由文件末尾导入:
acme_hello_bundle:
resource: "@AcmeHelloBundle/Resources/config/routing.yml"
- 创建控制器类:
src/Acme/HelloBundle/Controller/HelloController.php,返回Response对象即可。
此时访问 http://your-app/app_dev.php/hello/world 即可看到响应。











