最近，出于对Symfony2的关注，在网上闲逛时不时会留意Symfony2的文章，尤其是中文方面的。前段时间拜读了一饼兄的《Symfony2入门》一文，觉得比官网上的例子涉及面更广便做了转载。今日有暇细读，却发现一饼兄只是大体对Symfony2做了介绍，如果参照该文来入门的话，却是存在很大的问题，于是便有了这一篇文章。
下载
首先是下载Symfony2，这个简单，到 http://symfony.com/download下载即可。本人由于使用的是Ubuntu系统，所以下了个.tgz的，然后解压到/var/www目录中：
- tar zxvf Symfony_Standard_Vendors_2.0.###.tgz -C /var/www
上面的###是指版本号，我下的时候是BETA5。
当解压之后，Symfony2的目录如下：
- /var/www/ <- Web根目录
- Symfony/ <- Symfony2解压目录
- app/ <- 存放symfony的核心文件的目录
- cache/ <- 存放缓存文件的目录
- config/ <- 存放应用程序全局配置的目录
- logs/ <- 存放日志的目录
- src/ <- 应用程序源代码
- ...
- vendor/ <- 供应商或第三方的模组和插件
- ...
- web/ <- Web入口
- app.php <- 生产环境下的前端控制器
- ...
如果你需要安装（如果你下载的是without vendor版本）或更新vendor（第三方）内容时，可以使用：
- cd /var/www/Symfony
- php bin/vendors install
配置
Symfony2的配置很简单，只需要在浏览器中输入：
- http://localhost/Symfony/web/config.php
然后按照提示来进行就可以了。其中值得注意的就是app/cache和app/logs目录的权限问题，由于我是在Ubuntu下安装的，所以可以使用（其中firehare是我的用户名，兄弟们在这里可以用你的用户名代替）：
- #为了保险起见
- rm -rf app/cache/*
- rm -rf app/logs/*
-
- #设置ACL
- sudo setfacl -R -m u:www-data:rwx -m u:firehare:rwx app/cache app/logs
- sudo setfacl -dR -m u:www-data:rwx -m u:firehare:rwx app/cache app/logs
如果系统不支持setfacl命令的话，要检查2个地方：
- setfacl是否已经安装，如果没有的话，可以通过以下命令安装（在Ubuntu 11.10中好象已经缺省安装了，包为叫acl）：
- sudo apt-get install setfacl
- 如果setfacl已经安装，那么请查看/etc/fstab文件，看看是否添加了acl选项：
- # /var was on /dev/sda7 during installation
- UUID=c2cc4104-b421-479a-b21a-1108f8895110 /var ext4 defaults,acl 0 2
然后根据页面提示填写数据库名等信息，再将这些信息拷到/var/www/Symfony/app/config/parameters.ini文件中，如下所示：
- ; These parameters can be imported into other config files
- ; by enclosing the key with % (like %database_user%)
- ; Comments start with ';', as in php.ini
- [parameters]
- database_driver="pdo_mysql"
- database_host="localhost"
- database_name="symfony"
- database_user="symfony"
- database_password="symfony"
- mailer_transport="smtp"
- mailer_host="localhost"
- mailer_user=""
- mailer_password=""
- locale="zh_CN"
- secret="29f96e9e70c2797cb77dd088d3954d3c38d9b33f"
如果全部OK的话，在你浏览器中输入下列地址时，你将得到一个Demo页：
- http://localhost/Symfony/web/app_dev.php
编程
创建Bundle
首先创建一个Bundle：
- php app/console gen:bundle "Acme\HelloBundle" src
为了确保Acme名称空间可以被自动加载，请在你的app/autoload.php文件添加下列语句：
- $loader->registerNamespaces(array(
- // ...
- //添加自定义的名称空间
- 'Acme' => __DIR__.'/../src',
- // ...
- ));
最后是将该Bundle注册到Symfony2中，请在你的app/AppKernel.php文件中添加下列语句：
- // app/AppKernel.php
- public function registerBundles()
- {
- $bundles = array(
- // ...
- new Acme\HelloBundle\AcmeHelloBundle(),
- );
-
- // ...
-
- return $bundles;
- }
创建路由
路由可以创建在app/config/routing.yml中，但为了有个好的编程习惯和代码组织，可以将它放在所建Bundle目录中的Resources/config/routing.yml中，而在app/config/routing.yml中只保留到该路由文件的引用，如下所示：
- # app/config/routing.yml
- homepage:
- pattern: /
- defaults: { _controller: FrameworkBundle:Default:index }
-
- hello:
- resource: "@AcmeHelloBundle/Resources/config/routing.yml"
而真正的路由则写在src/Acme/HelloBundle/Resources/config/routing.yml路由文件中，如下所示：
- # src/Acme/HelloBundle/Resources/config/routing.yml
- hello:
- pattern: /hello/{name}
- defaults: { _controller: AcmeHelloBundle:Hello:index, name:'pu' }
创建控制器
控制器的名字一定得是HelloController.php，原因很简单，因为你路由已经把控制器的名字给定下来了，在上面路由文件中的第4行和第7行中的控制器都是以AcmeHelloBundle:Hello开头的，其中AcmeHelloBundle表示Bundle名，而Hello则表示控制器名，所以控制器必须是HelloController.php，Controller名缀是命名约定。而至于后面的index和say则是控制器类中的方法。下面就定义了index方法，当然方法名为indexAction这个也是命名约定：
- // src/Acme/HelloBundle/Controller/HelloController.php
-
- namespace Acme\HelloBundle\Controller;
- use Symfony\Component\HttpFoundation\Response;
-
- class HelloController
- {
- public function indexAction($name)
- {
- return new Response('<html><body>Hello '.$name.'!</body></html>');
- }
- }
这样，当我们在浏览器中输入
- http://localhost/hello/index/World
就会显示Hello World!这样的字样。
创建模板
为了能够重用布局文件中的区块，可以使用模板来代替控制器中的HTML语句。首先创建页面布局文件：
- {# app/Resources/views/layout.html.twig #}
- <!DOCTYPE html>
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <title>{% block title %}Hello Application{% endblock %}</title>
- </head>
- <body>
- {% block body %}{% endblock %}
- </body>
- </html>
注意，该文件位于app/Resources/views/目录中，作用范围是整个应用程序的全局模板文件。在该文件中定义了两个区块：title和body。接下来就是创建一个专用于Hello控制器的模板，如下所示：
- {# src/Acme/HelloBundle/Resources/views/Hello/index.html.twig #}
- {% extends '::layout.html.twig' %}
-
- {% block body %}
- Hello {{ name }}!
- {% endblock %}
在该文件中，它继承了全局模板，并且定义了区块body，这样就覆写了全局模板中的body区块。如果系统在渲染到该模板时，会将区块body覆写全局模板的区块body，再进行渲染。
最后，将控制器中的HTML语句改成渲染上述模板即可：
- // src/Acme/HelloBundle/Controller/HelloController.php
- namespace Acme\HelloBundle\Controller;
-
- use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
- class HelloController extends Controller
- {
- public function indexAction($name)
- {
- return $this->render('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name));
- }
- }
打完收功！我们已经创建了一个典型的Symfony2程序。如果兄弟们有什么疑问的话可以下面的评论中直接提。
本文出自 “野火兔的窝” 博客，请务必保留此出处http://firehare.blog.51cto.com/809276/592385
