Symfony2是一個基於PHP語言的Web開發框架,有著開發速度快、性能高等特點。本文以一個程序示例的實現過程詳細敘述了Symfony2框架的配置與程序開發。
一、下載
首先是下載Symfony2,到 http://symfony.com/download或者本站下載http://www.jb51.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/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
三、程序示例:
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('<html><body>Hello '.$name.'!</body></html>'); } }
這樣,當我們在浏覽器中輸入
http://localhost/hello/index/World
就會顯示Hello World!這樣的字樣。
4.創建模板:
為了能夠重用布局文件中的區塊,可以使用模板來代替控制器中的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 AcmeHelloBundleController; use SymfonyBundleFrameworkBundleControllerController; class HelloController extends Controller { public function indexAction($name) { return $this->render('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name)); } }