本文實例講述了Symfony2創(chuàng)建頁面的方法。分享給大家供大家參考，具體如下：
在Symfony2中創(chuàng)建頁面只需要兩步：
1、創(chuàng)建路由：路由定義你頁面的URI（如/about）并指定要執(zhí)行的控制器（PHP函數(shù)）。當(dāng)傳入的請求URL匹配該路由時，Symfony2將執(zhí)行指定的控制器；
2、創(chuàng)建控制器：控制器是一個PHP函數(shù)，它接受傳入的請求并將其轉(zhuǎn)換成Symfony2的Response對象。
我們喜歡這樣簡單的實現(xiàn)，因為它符合Web的工作方式。每一個Web交互都是由HTTP請求開始，應(yīng)用程序的任務(wù)就是簡單地解釋請求并返回相應(yīng)的HTTP響應(yīng)。Symfony2遵循這一原則，并為你提供工具，以保證在應(yīng)用程序的用戶和復(fù)雜性增長時仍保持良好地組織性。
“Hello Symfony2” 頁
讓我們從經(jīng)典的“hello,world”程序開始，當(dāng)我們完成后，用戶可以通過訪問下列URL來得到一聲問候：
http://localhost/app_dev.php/hello/Symfony
其實，你可以將Symfony換成其它的名稱來問候，要創(chuàng)建該頁，我們只需簡單地通過兩個步驟來進(jìn)行：
本教程已經(jīng)假定你下載了Symfony2，并且配置好了Web服務(wù)器。上述URL假設(shè)localhost指向你新的Symfony2項目。安裝詳情參見安裝Symfony2。
創(chuàng)建Bundle
在開始之前，你需要創(chuàng)建一個Bundle。在Symfony2中，Bundle相當(dāng)于插件，你應(yīng)用程序中的所有代碼都需要放在Bundle中。Bundle只是一個目錄（擁有PHP的名稱空間），里面的內(nèi)容都與某個特定功能相關(guān)（參見Bundle系統(tǒng)）。運行下列命令，創(chuàng)建AcmeStudyBundle（本章所建的游戲之作）。
php app/console Acme/StudyBundle[/]
接下來，在app/autoloader.php文件中添加了以下語句，以確保Acme名字空間被引導(dǎo)（參見自動加載章節(jié)）：
$loader->registerNamespaces(array( 'Acme' => __DIR__.'/../src', // ...));
最后在app/AppKernel.php文件的registerBundles()方法中初始化Bundle。
// app/AppKernel.phppublic function registerBundles(){ $bundles = array( // ... new Acme/StudyBundle/AcmeStudyBundle(), ); // ... return $bundles;} 現(xiàn)在你已經(jīng)設(shè)置好你的Bundle，并可以在你Bundle中構(gòu)建你的應(yīng)用程序了。
創(chuàng)建路由
缺省狀態(tài)下，Symfony2的路由配置文件放置在app/config/routing.yml目錄中。在Symfony2中所有的配置文件也可以采用PHP或XML格式編寫。
# app/config/routing.ymlhomepage: pattern: / defaults: { _controller: FrameworkBundle:Default:index }hello: resource: "@AcmeStudyBundle/Resources/config/routing.yml" 路由配置文件的前幾行定義了用戶請求”/”（首頁）資源所調(diào)用的代碼，更有趣的是最后一部分，它導(dǎo)入了位于AcmeStudyBundle中的其它路由配置文件。
# src/Acme/StudyBundle/Resources/config/routing.ymlhello: pattern: /hello/{name} defaults: { _controller: AcmeStudyBundle:Hello:index } 路由由兩個基本部分組成，pattern（模式）確定哪個URI匹配本路由，defaults數(shù)組指定要運行的控制器。在pattern中的占位符{name}是個通配符，它表示諸如/hello/Ryan, /hello/Fabien或其他相似的URI匹配該路由。{name}占位參數(shù)也被發(fā)送到控制器，以便我們可以使用它的值去問候用戶。
路由系統(tǒng)在創(chuàng)建應(yīng)用程序強大、靈活的URL結(jié)構(gòu)方面有著許多令人驚嘆的功能，詳情請參見《Symfony2學(xué)習(xí)筆記之系統(tǒng)路由詳解》
創(chuàng)建控制器
當(dāng)象/hello/Ryan這樣的URI被應(yīng)用程序處理時，hello路由被匹配，并且AcmeStudyBundle:Hello:index控制器通過Symfony2框架被執(zhí)行。創(chuàng)建頁面過程的第二步就是創(chuàng)建這個控制器
實際上控制器也不過是由你創(chuàng)建并通過Symfony2執(zhí)行的PHP函數(shù)，這個定制的應(yīng)用程序代碼使用請求信息去構(gòu)建和準(zhǔn)備所需資源。除了一些高級案例外，控制器最終的輸出都是相同的：一個Response對象。
// src/Acme/StudyBundle/Controller/HelloController.phpnamespace Acme/StudyBundle/Controller;use Symfony/Component/HttpFoundation/Response;class HelloController{ public function indexAction($name) { return new Response('<html><body>Hello '.$name.'!</body></html>'); }} 控制器很簡單，它創(chuàng)建一個新的Response對象，該對象的第一個參數(shù)是它返回的響應(yīng)內(nèi)容（在本例中是個小小的HTML頁）。
恭喜你，僅僅只是在創(chuàng)建了一個路由和控制器之后，你就已經(jīng)得到了一個全功能頁！如果你的設(shè)置沒有問題的話，你的應(yīng)用程序就可以跟你打招呼了：
http://localhost/app_dev.php/hello/Ryan
一個可選但卻被經(jīng)常用到的步驟就是創(chuàng)建一個模板。
在創(chuàng)建頁面時控制器是主入口和關(guān)鍵部分，更多信息可以在控制器章節(jié)找到。
創(chuàng)建模板
模板允許你把所有的展示（如HTML代碼）都放到單個文件中，并且重用頁面布局的不同區(qū)塊。下面代碼就是使用模板來替換控制器中的HTML代碼。
// src/Acme/StudyBundle/Controller/HelloController.phpnamespace Acme/StudyBundle/Controller;use Symfony/Bundle/FrameworkBundle/Controller/Controller;class HelloController extends Controller{ public function indexAction($name) { return $this->render('AcmeStudyBundle:Hello:index.html.twig', array('name' => $name)); // 渲染PHP模板 // return $this->render('AcmeStudyBundle:Hello:index.html.php', array('name' => $name)); }} 為了使用render()方法，你必須繼承Controller類，該類添加了一些常見任務(wù)的快捷方法。
render()方法創(chuàng)建一個Response對象，該對象使用特定的內(nèi)容填充并通過模板渲染的。與其它控制器一樣，你最終得到的是一個Response對象。
注意，這里有兩種不同渲染模板的例子，缺省情況下，Symfony2支持兩種渲染模板的方式：傳統(tǒng)的PHP模板和簡潔強大的Twig模板。你可以隨意選擇使用其中的一種，也可以在同一項目中混用它們，這都不成問題。
控制器渲染AcmeStudyBundle:Hello:index.html.twig模板，該模板使用以下命名約定：
Bundle名:Controller名:Template名
在本例中，AcmeStudyBundle是Bundle名，Hello是控制器，index.html.twig是模板名。
{# src/Acme/StudyBundle/Resources/views/Hello/index.html.twig #}{% extends '::layout.html.twig' %}{% block body %} Hello {{ name }}!{% endblock %} 讓我們一行行地來：
第2行：extends定義了一個父模板，模板明確定義了一個將被替換的布局文件；
第4行：block表示其中的內(nèi)容將會替換掉名為body的block，如我們所知，它在最終渲染時將負(fù)責(zé)layout.html.twig中名為body的block的渲染。
父模板::layout.html.twig省略了它的bundle名和控制器名（所以用兩個冒號::代替），這意味著該模板在bundle外面，在app目錄中。
{# 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> 基本模板文件定義了HTML布局，并用我們在index.html.twig模板中定義的名為body的區(qū)塊渲染。這里還定義了一個名為title的區(qū)塊，我們也可以選擇在index.html.twig模板中定義。由于我們沒有在子模板中定義title區(qū)塊，所以它還是使用缺省值”Hello Application”。
模板在渲染和組織頁面內(nèi)容方面的功能非常強大，它可以是HTML標(biāo)識語言、CSS代碼或者控制器可能需要返回的東東。模板引擎只是達(dá)到目標(biāo)的手段。每個控制器的目標(biāo)是返回一個Response對象，模板雖然強大，但它卻是可選的，它只是為Response對象創(chuàng)建內(nèi)容的工具而已。
目錄結(jié)構(gòu)
經(jīng)過前面幾段的學(xué)習(xí)，你已經(jīng)理解了在Symfony2中創(chuàng)建和渲染頁面的步驟，也開始明白了Symfony2的組織和結(jié)構(gòu)，在本章的最后，你將學(xué)會在哪兒找到和放置不同類型的文件以及為什么這樣做。
雖然Symfony2的目錄結(jié)構(gòu)相當(dāng)靈活，但在缺省狀態(tài)下，Symfony2還是有著相同的、被推薦的基本目錄結(jié)構(gòu)：
app/ : 該目錄包含應(yīng)用程序配置；
src/ : 所有項目的PHP代碼都保存在該目錄下；
vendor/ : 根據(jù)約定放置所有供應(yīng)商的庫文件；
web/ : 這是web根目錄，包括一些公眾可以訪問的文件。
WEB目錄
web根目錄是所有靜態(tài)的、公共文件的家目錄，包括圖像、樣式表和javascript文件，這里也是前端控制器所在的地方。
// web/app.phprequire_once __DIR__.'/../app/bootstrap.php';require_once __DIR__.'/../app/AppKernel.php';use Symfony/Component/HttpFoundation/Request;$kernel = new AppKernel('prod', false);$kernel->handle(Request::createFromGlobals())->send(); 前端控制器（在這里是app.php）其實是一個PHP文件，在使用Symfony2應(yīng)用程序時執(zhí)行。它的功能就是使用內(nèi)核類AppKernel，讓應(yīng)用程序自舉。
使用前端控制器意味著要比使用傳統(tǒng)的純PHP程序有著更為靈活多變的URL，當(dāng)使用前端控制器時，URL格式如下所示：
http://localhost/app.php/hello/Ryan
前端控制器app.php被執(zhí)行，URI（/hello/Ryan）通過路由配置被內(nèi)部路由。如果使用Apache的重寫規(guī)則，你可以在不指定app.php的情況下強制執(zhí)行它：
http://localhost/hello/Ryan
雖然前端控制器在處理請求時必不可少，但你很少會去修改甚至想到它，我們只是在環(huán)境一章中簡要地提及它。
應(yīng)用程序（app）目錄
正如你在前端控制器所看到的那樣，AppKernel類是整個應(yīng)用程序的主入口，它負(fù)責(zé)所有的配置，它被保存在app/目錄中。
這個類必須實現(xiàn)三個方法，這些方法是Symfony2需要讓應(yīng)用程序了解的。你甚至在一開始就無須擔(dān)心這些方法，因為Symfony2會智能地為你填充它們：
1、registerBundles(): 返回所有需要在應(yīng)用程序中運行的bundle數(shù)組 (參見Bundle系統(tǒng) )；
2、registerContainerConfiguration(): 引導(dǎo)應(yīng)用程序的主配置資源文件 (參見應(yīng)用程序配置章節(jié))；
3、registerRootDir(): 返回app根目錄 (缺省是 app/)
在日常開發(fā)中，你會經(jīng)常用到app/目錄，你會在app/config/目錄中修改配置和路由文件（參見應(yīng)用程序配置），也會使用app/cache/目錄做為應(yīng)用程序的緩存目錄、使用app/logs/目錄做為日志目錄、使用app/Resources/目錄做為應(yīng)用程序級別的資源目錄。在下面的章節(jié)中你將會學(xué)到更多關(guān)于這些目錄的內(nèi)容。
自動加載
當(dāng)應(yīng)用程序自舉時，將包含一個特殊的文件：app/autoload.php。該文件負(fù)責(zé)自動加載src/和vender/目錄中的所有文件。
因為有自動加載器，你永遠(yuǎn)無須為使用include或require語句擔(dān)心。Symfony2利用類的名稱空間確定它的位置，并自動加載包含你所需的類文件。
$loader->registerNamespaces(array( 'Acme' => __DIR__.'/../src', // ...));
在這個配置中，Symfony2將查找src/目錄下Acme名稱空間（假想公司的名稱空間）的所有類。為了能夠自動加載，Class Name文件和Path必須遵循同一模式：
Class Name:
Acme/StudyBundle/Controller/HelloController
Path:
src/Acme/StudyBundle/Controller/HelloController.php
app/autoload.php配置自動加載器在不同的目錄查找不同的PHP名稱空間，也可以在必要時自定義。有關(guān)自動加載器的更多情況，參見如何自動加載類。
源（src）目錄
簡而言之，src/目錄包括所有在應(yīng)用程序中運行的PHP代碼。實際上在開發(fā)時，大部分工作都是在該目錄下完成的。缺省情況下，src/目錄是空的，當(dāng)你開始進(jìn)行開發(fā)時，你將開始填充bundle所在的目錄，該目錄包含你應(yīng)用程序的代碼。
然而bundle究竟是什么呢？
Bundle系統(tǒng)
Bundle與其它軟件中的插件類似，但比它們更好。關(guān)鍵的不同點在于在Symfony2中什么都是bundle，包括框架的核心功能和你為應(yīng)用程序所寫的代碼。在Symfony2中，Bundle是一類公民，這讓使用第三方Bundle的預(yù)建功能包或發(fā)布你自己的Bundle變得十分靈活。它也可以使你很容易地選擇應(yīng)用程序所需功能，并用你自己的方式去優(yōu)化它們。
Bundle簡單來說就是在一個目錄里用來實現(xiàn)單一功能的結(jié)構(gòu)化文件集。你可以創(chuàng)建BlogBundle、ForumBundle或用戶管理的Bundle（許多都已經(jīng)以開源Bundle的形式存在）。每個目錄都包含與功能相關(guān)的內(nèi)容，如PHP文件、模板、樣式表、Javascripts、測試等。每個Bundle都包含某種功能的方方面面，而每種功能都必須在Bundle中實現(xiàn)。
應(yīng)用程序由在AppKernel類中的registerBundles()方法中定義的Bundle組成：
// app/AppKernel.phppublic function registerBundles(){ $bundles = array( new Symfony/Bundle/FrameworkBundle/FrameworkBundle(), new Symfony/Bundle/SecurityBundle/SecurityBundle(), new Symfony/Bundle/TwigBundle/TwigBundle(), new Symfony/Bundle/MonologBundle/MonologBundle(), new Symfony/Bundle/SwiftmailerBundle/SwiftmailerBundle(), new Symfony/Bundle/DoctrineBundle/DoctrineBundle(), new Symfony/Bundle/AsseticBundle/AsseticBundle(), new Sensio/Bundle/FrameworkExtraBundle/SensioFrameworkExtraBundle(), new JMS/SecurityExtraBundle/JMSSecurityExtraBundle(), // register your bundles new Acme/StudyBundle/AcmeStudyBundle(), ); if (in_array($this->getEnvironment(), array('dev', 'test'))) { $bundles[] = new Symfony/Bundle/WebProfilerBundle/WebProfilerBundle(); } return $bundles;} 通過registerBundles()方法，你就擁有了應(yīng)用程序所有Bundles的全部控制權(quán)（包含Symfony2的核心Bundle）
無論Bundle在什么地方，它都可以被Symfony2自動加載。舉個例子，如果AcmeStudyBundle放在src/Acme目錄中，請確保Acme的名稱空間被添加到app/autoload.php文件中，并映射到src/目錄，這樣它就可以被Symfony2自動加載了。
創(chuàng)建Bundle
為了向你展示Bundle系統(tǒng)是如何之簡單，讓我們創(chuàng)建一個名為AcmeTestBundle的新Bundle，并激活它。
首先，創(chuàng)建一個src/Acme/TestBundle/ 目錄，并添加一個名為AcmeTestBundle.php的新文件：
// src/Acme/TestBundle/AcmeTestBundle.phpnamespace Acme/TestBundle;use Symfony/Component/HttpKernel/Bundle/Bundle;class AcmeTestBundle extends Bundle{} AcmeTestBundle遵循Bundle命名約定
這個空類僅僅只是我們需要創(chuàng)建新Bundle的一部分。雖然是空的，但這個類已經(jīng)足夠強大，并能夠用來自定義Bundle的行為。
現(xiàn)在我們已經(jīng)創(chuàng)建了我們的Bundle，我們需要通過Appkernel類激活它：
// app/AppKernel.phppublic function registerBundles(){ $bundles = array( // ... // register your bundles new Acme/TestBundle/AcmeTestBundle(), ); // ... return $bundles;} 雖然目前它還不能做任何事情，但AcmeTestBundle現(xiàn)在已經(jīng)可以使用了。
同樣方便的是，Symfony也提供命令行接口去生成Bundle的基本框架
php app/console init:bundle "Acme/TestBundle" src
生成的Bundle框架包括一個基本控制器、模板和可自定義的路由資源。接下來我們將會討論更多的Symfony2命令行工具。
無論何時，創(chuàng)建一個新的Bundle或使用第三方Bundle，都是需要確保該Bundle在registerBundles()中被激活。
Bundle的目錄結(jié)構(gòu)
Bundle的目錄結(jié)構(gòu)是簡單而靈活的。缺省狀態(tài)下，Bundle系統(tǒng)遵循Symfony2所有Bundle之間保持代碼一致性的約定集。讓我們看看AcmeStudyoverBundle，因為它包含了Bundle的大多數(shù)元素：
1、Controller/目錄：包含該Bundle的控制器（如：HelloController.php）；
2、Resources/config/目錄：配置目錄，包括路由配置（如：routing.yml）；
3、Resources/views/目錄：通過控制器名組織的模板（如：Hello/index.html.twig）；
4、Resources/public/目錄：包含web資源（圖片、樣式表等），并被拷貝或軟鏈接到項目的web/目錄；
5、Tests/目錄：存放該Bundle的所有測試。
根據(jù)Bundle實現(xiàn)的功能，它可小可大，它只包含你所需要的文件。
你在本書中還將學(xué)習(xí)到如何持久化對象到數(shù)據(jù)庫、創(chuàng)建和驗證表單、翻譯你的應(yīng)用程序和編寫測試等等，它們在Bundle中都有自己的位置和所扮演的角色。
應(yīng)用程序配置
應(yīng)用程序由代表應(yīng)用程序所有功能和特征的Bundle集構(gòu)成。每個Bundle都可以通過YAML、XML或PHP編寫的配置文件來自定義。缺省情況下，主配置文件放置在app/config/目錄中，被命名為config.yml、config.xml或config.php，這取決于你所使用的格式：
# app/config/config.ymlframework: charset: UTF-8 secret: xxxxxxxxxx form: true csrf_protection: true router: { resource: "%kernel.root_dir%/config/routing.yml" } validation: { annotations: true } templating: { engines: ['twig'] } #assets_version: SomeVersionScheme session: default_locale: en lifetime: 3600 auto_start: true# Twig Configurationtwig: debug: %kernel.debug% strict_variables: %kernel.debug% 我們將在下一節(jié)環(huán)境中展示如何準(zhǔn)確地選擇要引導(dǎo)的文件/格式。
每一個頂級條目，如framework或twig都被配置成一個特定的Bundle。例如，framework被配置成Symfony2的核心FrameworkBundle，并包含路由、模板和其它核心系統(tǒng)的配置。
現(xiàn)在別擔(dān)心配置文件中各段中的特定配置選項，配置文件缺省值都是合理的。當(dāng)你瀏覽Symfony2的各部分時，你將學(xué)到每個部分的特定配置選項。
配置格式
縱觀整個章節(jié)，所有的配置示例都用三種格式（YAML、XML和PHP）展示。它們每個都有自己的優(yōu)缺點，以下是三種格式的說明：
1、YAML：簡單、干凈和易讀
2、XML：有時比YAML更強大且支持IDE的自動完成
3、PHP：非常強大，但與標(biāo)準(zhǔn)配置格式相比易讀性差
環(huán)境
應(yīng)用程序可以在不同的環(huán)境中運行。不同的環(huán)境共享相同的PHP代碼（由前端控制 器區(qū)分），但卻有著完全不同的配置。開發(fā)環(huán)境記錄警告和錯誤，而生產(chǎn)環(huán)境只記錄錯誤。在開發(fā)環(huán)境中一些文件在每次請求之后被重構(gòu)，而在生產(chǎn)環(huán)境中卻被緩存 。所有的環(huán)境都在同一機制中生活。
雖然創(chuàng)建新的環(huán)境是容易的，但Symfony2項目通常會從三個環(huán)境開始（開發(fā)、測試和生產(chǎn)）。通過在你瀏覽器中改變前端控制器，你可以很方便地讓應(yīng)用程序在不同的環(huán)境中切換。要將應(yīng)用程序切換到開發(fā)環(huán)境，只需要通過開發(fā)前端控制器去訪問應(yīng)用程序即可。
http://localhost/app_dev.php/hello/Ryan
如果你想看看你的應(yīng)用程序在生產(chǎn)環(huán)境中的表現(xiàn) ，可以調(diào)用生產(chǎn)前端控制器：
http://localhost/app.php/hello/Ryan
如果你打開 web/app.php文件，你將發(fā)現(xiàn)它已經(jīng)很明確地被配置成使用生產(chǎn)環(huán)境：
$kernel = new AppCache(new AppKernel('prod', false)); 你可以為一個新的環(huán)境創(chuàng)建一個新的前端控制器，只需要拷貝該文件，并將prod修改成其它值。
因為生產(chǎn)環(huán)境是為速度優(yōu)化的，配置、路由和Twig模板都被編譯成純的PHP類，同時被緩存 。在生產(chǎn)環(huán)境中改變視圖時，你需要清除這些緩存文件，從而讓它們重構(gòu)：
rm -rf app/cache/*
當(dāng)進(jìn)行自動測試時使用測試環(huán)境，它并不能從瀏覽器直接訪問。參見測試章節(jié)以得到更多細(xì)節(jié)。
環(huán)境配置
AppKernel類負(fù)責(zé)加載你所選的配置文件：
// app/AppKernel.phppublic function registerContainerConfiguration(LoaderInterface $loader){ $loader->load(__DIR__.'/config/config_'.$this->getEnvironment().'.yml');} 我們已經(jīng)知道.yml擴展名可以轉(zhuǎn)換成.xml或.php，只要你喜歡使用XML或PHP來寫配置。注意每種環(huán)境也可以加載它們自己的配置文件。下面是為生產(chǎn)環(huán)境準(zhǔn)備的配置文件。
# app/config/config_dev.ymlimports: - { resource: config.yml }framework: router: { resource: "%kernel.root_dir%/config/routing_dev.yml" } profiler: { only_exceptions: false }web_profiler: toolbar: true intercept_redirects: truezend: logger: priority: debug path: %kernel.logs_dir%/%kernel.environment%.log import關(guān)鍵詞與PHP格式中include語句一樣，都是首先引導(dǎo)主配置文件（config.yml），文件的其它部分是為了增長的日志和其它有利于開發(fā)環(huán)境的設(shè)置而對缺省配置進(jìn)行的調(diào)整。
在生產(chǎn)環(huán)境和測試環(huán)境都遵循同樣一個模型：每個環(huán)境導(dǎo)入基本配置文件，然后修改它們的配置值去適應(yīng)特殊環(huán)境的需要。
小結(jié)
恭喜你，你現(xiàn)在已經(jīng)明白了Symfony2的基本原理，并驚喜地發(fā)現(xiàn)它是那樣的方便靈活。盡管有許多的功能，但我們可以牢記以下幾個基本點：
1、創(chuàng)建頁面需要三個步驟，包括路由、控制器和模板（可選）；
2、每個應(yīng)用程序都應(yīng)該包含四個目錄：web/（web資源和前端控制器）、app/（配置）、src/（你的Bundle）和vendor/（第三方代碼）；
3、Symfony2的每個功能（包括Symfony2框架核心）都被組織進(jìn)一個Bundle，Bundle是該功能的結(jié)構(gòu)化文件集；
4、每個Bundle的配置都存放在app/config目錄中，可以使用YAML、XML和PHP編寫；
5、通過不同的前端控制器（如：app.php或app_dev.php）和配置文件，每種環(huán)境都可以被訪問。
希望本文所述對大家基于Symfony框架的PHP程序設(shè)計有所幫助。
