程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> 高性能PHP框架Symfony2中文入門教程

高性能PHP框架Symfony2中文入門教程

編輯：關於PHP編程

　　最近，出於對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 "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; 
}

創建路由

　　路由可以創建在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 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!這樣的字樣。

創建模板

　　為了能夠重用布局文件中的區塊，可以使用模板來代替控制器中的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)); 
    } 
}

　　打完收功!我們已經創建了一個典型的Symfony2程序。如果兄弟們有什麼疑問的話可以下面的評論中直接提。

　　本文出自 “野火兔的窩” 博客，請務必保留此出處：http://firehare.blog.51cto.com/809276/592385