Best Practice

Best Practice

使用Symfony安装器来创建基于Symfony的项目。

参考安装和设置Symfony框架章节来了解如何安装和使用Symfony Installer。

现在每样东西都被设置好了，你可以创建基于Symfony的全新项目了。在命令行中，进入一个你有权限新建文件的目录，并执行下述命令：

Note

如果安装器不工作，你看不到任何输出，确保电脑上的已经安装和启用。

上面的命令，创建了一个名为的目录，里面是一个基于Symfony最新稳定版的全新项目。除此之外，安装器还会检查你的操作系统是否满足了运行Symfony所需之环境。如果不满足，你会看到一个列表，上面有你需要修复的信息。

Tip

Symfony发布后因为安全原因而带有数字签名。如果你希望校验你的Symfony程序，请参考public checksums repository/公共校验库并按照来校验签名。

创建完程序之后，进入blog/目录，你会发现有一堆文件和文件夹被自动生成了：

• app/config/，存放用来定义各种环境的配置文件；

• app/Resources/，存放程序级别的全部模板和翻译文件。（译注：程序级是被Symfony内核最先查找的位置）；

• ，存放Symfony特殊代码（控制器和路由），你的域对象代码（如Doctrine类），以及你的全部业务逻辑；

• var/logs/，存放程序生成的日志；

• var/sessions/，存放程序生成的session；

• ，存放程序的自动测试（如单元测试）；

• web/，存放前端控制器和所有的web assets资源，例如css、js和图片。

Symfony 2.0推出之后，多数开发者很自然地用Symfony 1.x的方式去划分程序的逻辑模块。这就是为何很多Symfony应用都把它们的代码按逻辑功能进行拆分的原因：UserBundle、ProductBundle、InvoiceBundle等等。

但bundle的真义在于，它是作为软件的一个“可被复用”的独立构成而存在。如果UserBundle不能“原封不动地”使用在别的Symfony程序中，它不应该成为bundle。另外，如果InvoiceBundle依赖于ProductBundle，那便没有任何必要将它们分成两个bundle。

Best Practice

为你的程序逻辑只创建一个名为AppBundle的bundle。

去实现一个单独的AppBundle可令你的程序简明易懂。

Note

AppBundle前面没有你的vendor前缀（比如AcmeAppBundle），因为程序的这个bundle将永远不会共享分发。

Note

创建一个新bundle的另一个原因是，当你要覆写某个三方bundle的一些内容时。参阅如何利用Bundle的继承来重写Bundle局部。

总而言之，下面是Symfony程序的一个典型目录结构，它遵循了上述最佳实践：

Tip

如果你的Symfony安装没有预建AppBundle，你可以用下面的命令手动生成：

若你的项目或内核需要对Symfony默认目录结构作出某些改变的话，你可以：cache/、和web/。