最近,出于对Symfony2的关注,在网上闲逛时不时会留意Symfony2的文章,尤其是中文方面的。前段时间拜读了一饼兄的《Symfony2入门》一文,觉得比官网上的例子涉及面更广便做了转载。今日有暇细读,却发现一饼兄只是大体对Symfony2做了介绍,如果参照该文来入门的话,却是存在很大的问题,于是便有了这一篇文章。

下载

首先是下载Symfony2,这个简单,到 http://symfony.com/download下载即可。本人由于使用的是Ubuntu系统,所以下了个.tgz的,然后解压到/var/www目录中:

  1. tar zxvf Symfony_Standard_Vendors_2.0.###.tgz -C /var/www 

上面的###是指版本号,我下的时候是BETA5。

当解压之后,Symfony2的目录如下:

  1. /var/www/ <- Web根目录 
  2.     Symfony/ <- Symfony2解压目录 
  3.         app/ <- 存放symfony的核心文件的目录
  4.             cache/ <- 存放缓存文件的目录
  5.             config/ <- 存放应用程序全局配置的目录
  6.             logs/ <- 存放日志的目录
  7.         src/ <- 应用程序源代码
  8.             ... 
  9.         vendor/ <- 供应商或第三方的模组和插件
  10.             ... 
  11.         web/ <- Web入口
  12.             app.php <- 生产环境下的前端控制器
  13.             ... 

如果你需要安装(如果你下载的是without vendor版本)或更新vendor(第三方)内容时,可以使用:

  1. cd /var/www/Symfony
  2. php bin/vendors install 

配置

Symfony2的配置很简单,只需要在浏览器中输入:

  1. http://localhost/Symfony/web/config.php 

然后按照提示来进行就可以了。其中值得注意的就是app/cache和app/logs目录的权限问题,由于我是在Ubuntu下安装的,所以可以使用(其中firehare是我的用户名,兄弟们在这里可以用你的用户名代替):

  1. #为了保险起见 
  2. rm -rf app/cache/* 
  3. rm -rf app/logs/* 
  4.  
  5. #设置ACL 
  6. sudo setfacl -R -m u:www-data:rwx -m u:firehare:rwx app/cache app/logs 
  7. sudo setfacl -dR -m u:www-data:rwx -m u:firehare:rwx app/cache app/logs 

如果系统不支持setfacl命令的话,要检查2个地方:

  1. setfacl是否已经安装,如果没有的话,可以通过以下命令安装(在Ubuntu 11.10中好象已经缺省安装了,包为叫acl):
    1. sudo apt-get install setfacl 
  2. 如果setfacl已经安装,那么请查看/etc/fstab文件,看看是否添加了acl选项:
    1. # /var was on /dev/sda7 during installation 
    2. UUID=c2cc4104-b421-479a-b21a-1108f8895110 /var  ext4  defaults,acl  0  2 

然后根据页面提示填写数据库名等信息,再将这些信息拷到/var/www/Symfony/app/config/parameters.ini文件中,如下所示:

  1. ; These parameters can be imported into other config files 
  2. ; by enclosing the key with % (like %database_user%) 
  3. ; Comments start with ';', as in php.ini 
  4. [parameters] 
  5.     database_driver="pdo_mysql" 
  6.     database_host="localhost" 
  7.     database_name="symfony" 
  8.     database_user="symfony" 
  9.     database_password="symfony" 
  10.     mailer_transport="smtp" 
  11.     mailer_host="localhost" 
  12.     mailer_user="" 
  13.     mailer_password="" 
  14.     locale="zh_CN" 
  15.     secret="29f96e9e70c2797cb77dd088d3954d3c38d9b33f" 

如果全部OK的话,在你浏览器中输入下列地址时,你将得到一个Demo页:

  1. http://localhost/Symfony/web/app_dev.php 

编程

创建Bundle

首先创建一个Bundle:

  1. php app/console gen:bundle "Acme\HelloBundle" src 

为了确保Acme名称空间可以被自动加载,请在你的app/autoload.php文件添加下列语句:

  1. $loader->registerNamespaces(array(  
  2.     // ...
  3.     //添加自定义的名称空间  
  4.     'Acme' => __DIR__.'/../src',  
  5.     // ...  
  6. )); 

最后是将该Bundle注册到Symfony2中,请在你的app/AppKernel.php文件中添加下列语句:

  1. // app/AppKernel.php 
  2. public function registerBundles() 
  3.     $bundles = array( 
  4.         // ... 
  5.         new Acme\HelloBundle\AcmeHelloBundle(), 
  6.     ); 
  7.  
  8.     // ... 
  9.  
  10.     return $bundles; 

 创建路由

路由可以创建在app/config/routing.yml中,但为了有个好的编程习惯和代码组织,可以将它放在所建Bundle目录中的Resources/config/routing.yml中,而在app/config/routing.yml中只保留到该路由文件的引用,如下所示:

  1. # app/config/routing.yml 
  2. homepage: 
  3.     pattern:  / 
  4.     defaults: { _controller: FrameworkBundle:Default:index } 
  5.  
  6. hello: 
  7.     resource: "@AcmeHelloBundle/Resources/config/routing.yml"

而真正的路由则写在src/Acme/HelloBundle/Resources/config/routing.yml路由文件中,如下所示:

  1. # src/Acme/HelloBundle/Resources/config/routing.yml 
  2. hello: 
  3.     pattern: /hello/{name} 
  4.     defaults: { _controller: AcmeHelloBundle:Hello:index, name:'pu' }  

 创建控制器

控制器的名字一定得是HelloController.php,原因很简单,因为你路由已经把控制器的名字给定下来了,在上面路由文件中的第4行和第7行中的控制器都是以AcmeHelloBundle:Hello开头的,其中AcmeHelloBundle表示Bundle名,而Hello则表示控制器名,所以控制器必须是HelloController.php,Controller名缀是命名约定。而至于后面的index和say则是控制器类中的方法。下面就定义了index方法,当然方法名为indexAction这个也是命名约定:

  1. // src/Acme/HelloBundle/Controller/HelloController.php 
  2.  
  3. namespace Acme\HelloBundle\Controller; 
  4. use Symfony\Component\HttpFoundation\Response; 
  5.  
  6. class HelloController 
  7.     public function indexAction($name
  8.     { 
  9.         return new Response('<html><body>Hello '.$name.'!</body></html>'); 
  10.     } 

这样,当我们在浏览器中输入

  1. http://localhost/hello/index/World 

就会显示Hello World!这样的字样。

创建模板

为了能够重用布局文件中的区块,可以使用模板来代替控制器中的HTML语句。首先创建页面布局文件:

  1. {# app/Resources/views/layout.html.twig #} 
  2. <!DOCTYPE html> 
  3. <html> 
  4.     <head> 
  5.         <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
  6.         <title>{% block title %}Hello Application{% endblock %}</title> 
  7.     </head> 
  8.     <body> 
  9.         {% block body %}{% endblock %} 
  10.     </body> 
  11. </html> 

注意,该文件位于app/Resources/views/目录中,作用范围是整个应用程序的全局模板文件。在该文件中定义了两个区块:title和body。接下来就是创建一个专用于Hello控制器的模板,如下所示:

  1. {# src/Acme/HelloBundle/Resources/views/Hello/index.html.twig #} 
  2. {% extends '::layout.html.twig' %} 
  3.  
  4. {% block body %} 
  5.     Hello {{ name }}! 
  6. {% endblock %} 

在该文件中,它继承了全局模板,并且定义了区块body,这样就覆写了全局模板中的body区块。如果系统在渲染到该模板时,会将区块body覆写全局模板的区块body,再进行渲染。

最后,将控制器中的HTML语句改成渲染上述模板即可:

  1. // src/Acme/HelloBundle/Controller/HelloController.php 
  2. namespace Acme\HelloBundle\Controller; 
  3.  
  4. use Symfony\Bundle\FrameworkBundle\Controller\Controller; 
  5.  
  6. class HelloController extends Controller 
  7.     public function indexAction($name
  8.     { 
  9.         return $this->render('AcmeHelloBundle:Hello:index.html.twig'array('name' => $name)); 
  10.     } 

打完收功!我们已经创建了一个典型的Symfony2程序。如果兄弟们有什么疑问的话可以下面的评论中直接提。