高效能PHP架構Symfony2經典入門教程_php執行個體

Symfony2是一個基於PHP語言的Web開發架構，有著開發速度快、效能高等特點。本文以一個程式樣本的實現過程詳細敘述了Symfony2架構的配置與程式開發。

一、下載

首先是下載Symfony2，到 http://symfony.com/download或者本站下載http://www.php.net/codes/187833.html。本人以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/Symfonyphp 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

三、程式樣本：

1.建立Bundle：

　　首先建立一個Bundle：

php app/console gen:bundle "AcmeHelloBundle" 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 AcmeHelloBundleAcmeHelloBundle(),  );   // ...   return $bundles; } 

2.建立路由

　　路由可以建立在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' }

3.建立控制器：

　　控制器的名字一定得是HelloController.php，原因很簡單，因為你路由已經把控制器的名字給定下來了，在上面路由檔案中的第4行和第7行中的控制器都是以AcmeHelloBundle:Hello開頭的，其中AcmeHelloBundle表示Bundle名，而Hello則表示控制器名，所以控制器必須是HelloController.php，Controller名綴是命名規範。而至於後面的index和say則是控制器類中的方法。下面就定義了index方法，當然方法名為indexAction這個也是命名規範：

// src/Acme/HelloBundle/Controller/HelloController.php namespace AcmeHelloBundleController; use SymfonyComponentHttpFoundationResponse; class HelloController {  public function indexAction($name)  {   return new Response('Hello '.$name.'!');  } } 

這樣，當我們在瀏覽器中輸入

http://localhost/hello/index/World

就會顯示Hello World!這樣的字樣。

4.建立模板：

　　為了能夠重用布局檔案中的區塊，可以使用模板來代替控制器中的HTML語句。首先建立頁面配置檔案：

{# app/Resources/views/layout.html.twig #}          {% block title %}Hello Application{% endblock %}       {% block body %}{% endblock %}    

　　注意，該檔案位於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 AcmeHelloBundleController; use SymfonyBundleFrameworkBundleControllerController; class HelloController extends Controller {  public function indexAction($name)  {   return $this->render('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name));  } }

