Symfony2如何創(chuàng)建頁面-創(chuàng)新互聯(lián)

這篇文章主要介紹Symfony2如何創(chuàng)建頁面,文中介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們一定要看完!

創(chuàng)新互聯(lián)專注于網(wǎng)站建設,為客戶提供網(wǎng)站建設、成都做網(wǎng)站、網(wǎng)頁設計開發(fā)服務,多年建網(wǎng)站服務經(jīng)驗,各類網(wǎng)站都可以開發(fā),品牌網(wǎng)站制作,公司官網(wǎng),公司展示網(wǎng)站,網(wǎng)站設計,建網(wǎng)站費用,建網(wǎng)站多少錢,價格優(yōu)惠,收費合理。

具體如下:

在Symfony2中創(chuàng)建頁面只需要兩步:

1、創(chuàng)建路由:路由定義你頁面的URI(如/about)并指定要執(zhí)行的控制器(PHP函數(shù))。當傳入的請求URL匹配該路由時,Symfony2將執(zhí)行指定的控制器;

2、創(chuàng)建控制器:控制器是一個PHP函數(shù),它接受傳入的請求并將其轉換成Symfony2的Response對象。

我們喜歡這樣簡單的實現(xiàn),因為它符合Web的工作方式。每一個Web交互都是由HTTP請求開始,應用程序的任務就是簡單地解釋請求并返回相應的HTTP響應。Symfony2遵循這一原則,并為你提供工具,以保證在應用程序的用戶和復雜性增長時仍保持良好地組織性。

“Hello Symfony2” 頁

讓我們從經(jīng)典的“hello,world”程序開始,當我們完成后,用戶可以通過訪問下列URL來得到一聲問候:

http://localhost/app_dev.php/hello/Symfony

其實,你可以將Symfony換成其它的名稱來問候,要創(chuàng)建該頁,我們只需簡單地通過兩個步驟來進行:

本教程已經(jīng)假定你下載了Symfony2,并且配置好了Web服務器。上述URL假設localhost指向你新的Symfony2項目。安裝詳情參見安裝Symfony2。

創(chuàng)建Bundle

在開始之前,你需要創(chuàng)建一個Bundle。在Symfony2中,Bundle相當于插件,你應用程序中的所有代碼都需要放在Bundle中。Bundle只是一個目錄(擁有PHP的名稱空間),里面的內容都與某個特定功能相關(參見Bundle系統(tǒng))。運行下列命令,創(chuàng)建AcmeStudyBundle(本章所建的游戲之作)。

php app/console Acme/StudyBundle[/]

接下來,在app/autoloader.php文件中添加了以下語句,以確保Acme名字空間被引導(參見自動加載章節(jié)):

$loader->registerNamespaces(array(
  'Acme' => __DIR__.'/../src',
  // ...
));

最后在app/AppKernel.php文件的registerBundles()方法中初始化Bundle。

// app/AppKernel.php
public function registerBundles()
{
  $bundles = array(
    // ...
    new Acme\StudyBundle\AcmeStudyBundle(),
  );
  // ...
  return $bundles;
}

現(xiàn)在你已經(jīng)設置好你的Bundle,并可以在你Bundle中構建你的應用程序了。

創(chuàng)建路由

缺省狀態(tài)下,Symfony2的路由配置文件放置在app/config/routing.yml目錄中。在Symfony2中所有的配置文件也可以采用PHP或XML格式編寫。

# app/config/routing.yml
homepage:
  pattern: /
  defaults: { _controller: FrameworkBundle:Default:index }
hello:
  resource: "@AcmeStudyBundle/Resources/config/routing.yml"

路由配置文件的前幾行定義了用戶請求”/”(首頁)資源所調用的代碼,更有趣的是最后一部分,它導入了位于AcmeStudyBundle中的其它路由配置文件。

# src/Acme/StudyBundle/Resources/config/routing.yml
hello:
  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)建應用程序強大、靈活的URL結構方面有著許多令人驚嘆的功能,詳情請參見《Symfony2學習筆記之系統(tǒng)路由詳解》

創(chuàng)建控制器

當象/hello/Ryan這樣的URI被應用程序處理時,hello路由被匹配,并且AcmeStudyBundle:Hello:index控制器通過Symfony2框架被執(zhí)行。創(chuàng)建頁面過程的第二步就是創(chuàng)建這個控制器

實際上控制器也不過是由你創(chuàng)建并通過Symfony2執(zhí)行的PHP函數(shù),這個定制的應用程序代碼使用請求信息去構建和準備所需資源。除了一些高級案例外,控制器最終的輸出都是相同的:一個Response對象。

// src/Acme/StudyBundle/Controller/HelloController.php
namespace 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ù)是它返回的響應內容(在本例中是個小小的HTML頁)。

恭喜你,僅僅只是在創(chuàng)建了一個路由和控制器之后,你就已經(jīng)得到了一個全功能頁!如果你的設置沒有問題的話,你的應用程序就可以跟你打招呼了:

http://localhost/app_dev.php/hello/Ryan

一個可選但卻被經(jīng)常用到的步驟就是創(chuàng)建一個模板。

在創(chuàng)建頁面時控制器是主入口和關鍵部分,更多信息可以在控制器章節(jié)找到。

創(chuàng)建模板

模板允許你把所有的展示(如HTML代碼)都放到單個文件中,并且重用頁面布局的不同區(qū)塊。下面代碼就是使用模板來替換控制器中的HTML代碼。

// src/Acme/StudyBundle/Controller/HelloController.php
namespace 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類,該類添加了一些常見任務的快捷方法。

render()方法創(chuàng)建一個Response對象,該對象使用特定的內容填充并通過模板渲染的。與其它控制器一樣,你最終得到的是一個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表示其中的內容將會替換掉名為body的block,如我們所知,它在最終渲染時將負責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”。

模板在渲染和組織頁面內容方面的功能非常強大,它可以是HTML標識語言、CSS代碼或者控制器可能需要返回的東東。模板引擎只是達到目標的手段。每個控制器的目標是返回一個Response對象,模板雖然強大,但它卻是可選的,它只是為Response對象創(chuàng)建內容的工具而已。

目錄結構

經(jīng)過前面幾段的學習,你已經(jīng)理解了在Symfony2中創(chuàng)建和渲染頁面的步驟,也開始明白了Symfony2的組織和結構,在本章的最后,你將學會在哪兒找到和放置不同類型的文件以及為什么這樣做。

雖然Symfony2的目錄結構相當靈活,但在缺省狀態(tài)下,Symfony2還是有著相同的、被推薦的基本目錄結構:

app/ : 該目錄包含應用程序配置;
src/ : 所有項目的PHP代碼都保存在該目錄下;
vendor/ : 根據(jù)約定放置所有供應商的庫文件;
web/ : 這是web根目錄,包括一些公眾可以訪問的文件。

WEB目錄

web根目錄是所有靜態(tài)的、公共文件的家目錄,包括圖像、樣式表和javascript文件,這里也是前端控制器所在的地方。

// web/app.php
require_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應用程序時執(zhí)行。它的功能就是使用內核類AppKernel,讓應用程序自舉。
使用前端控制器意味著要比使用傳統(tǒng)的純PHP程序有著更為靈活多變的URL,當使用前端控制器時,URL格式如下所示:

http://localhost/app.php/hello/Ryan

前端控制器app.php被執(zhí)行,URI(/hello/Ryan)通過路由配置被內部路由。如果使用Apache的重寫規(guī)則,你可以在不指定app.php的情況下強制執(zhí)行它:

http://localhost/hello/Ryan

雖然前端控制器在處理請求時必不可少,但你很少會去修改甚至想到它,我們只是在環(huán)境一章中簡要地提及它。

應用程序(app)目錄

正如你在前端控制器所看到的那樣,AppKernel類是整個應用程序的主入口,它負責所有的配置,它被保存在app/目錄中。

這個類必須實現(xiàn)三個方法,這些方法是Symfony2需要讓應用程序了解的。你甚至在一開始就無須擔心這些方法,因為Symfony2會智能地為你填充它們:

1、registerBundles(): 返回所有需要在應用程序中運行的bundle數(shù)組 (參見Bundle系統(tǒng) );
2、registerContainerConfiguration(): 引導應用程序的主配置資源文件 (參見應用程序配置章節(jié));
3、registerRootDir(): 返回app根目錄 (缺省是 app/)

在日常開發(fā)中,你會經(jīng)常用到app/目錄,你會在app/config/目錄中修改配置和路由文件(參見應用程序配置),也會使用app/cache/目錄做為應用程序的緩存目錄、使用app/logs/目錄做為日志目錄、使用app/Resources/目錄做為應用程序級別的資源目錄。在下面的章節(jié)中你將會學到更多關于這些目錄的內容。

自動加載

當應用程序自舉時,將包含一個特殊的文件:app/autoload.php。該文件負責自動加載src/和vender/目錄中的所有文件。

因為有自動加載器,你永遠無須為使用include或require語句擔心。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名稱空間,也可以在必要時自定義。有關自動加載器的更多情況,參見如何自動加載類。

源(src)目錄

簡而言之,src/目錄包括所有在應用程序中運行的PHP代碼。實際上在開發(fā)時,大部分工作都是在該目錄下完成的。缺省情況下,src/目錄是空的,當你開始進行開發(fā)時,你將開始填充bundle所在的目錄,該目錄包含你應用程序的代碼。
然而bundle究竟是什么呢?

Bundle系統(tǒng)

Bundle與其它軟件中的插件類似,但比它們更好。關鍵的不同點在于在Symfony2中什么都是bundle,包括框架的核心功能和你為應用程序所寫的代碼。在Symfony2中,Bundle是一類公民,這讓使用第三方Bundle的預建功能包或發(fā)布你自己的Bundle變得十分靈活。它也可以使你很容易地選擇應用程序所需功能,并用你自己的方式去優(yōu)化它們。

Bundle簡單來說就是在一個目錄里用來實現(xiàn)單一功能的結構化文件集。你可以創(chuàng)建BlogBundle、ForumBundle或用戶管理的Bundle(許多都已經(jīng)以開源Bundle的形式存在)。每個目錄都包含與功能相關的內容,如PHP文件、模板、樣式表、Javascripts、測試等。每個Bundle都包含某種功能的方方面面,而每種功能都必須在Bundle中實現(xiàn)。

應用程序由在AppKernel類中的registerBundles()方法中定義的Bundle組成:

// app/AppKernel.php
public 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()方法,你就擁有了應用程序所有Bundles的全部控制權(包含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.php
namespace 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.php
public 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的目錄結構

Bundle的目錄結構是簡單而靈活的。缺省狀態(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)的功能,它可小可大,它只包含你所需要的文件。

你在本書中還將學習到如何持久化對象到數(shù)據(jù)庫、創(chuàng)建和驗證表單、翻譯你的應用程序和編寫測試等等,它們在Bundle中都有自己的位置和所扮演的角色。

應用程序配置

應用程序由代表應用程序所有功能和特征的Bundle集構成。每個Bundle都可以通過YAML、XML或PHP編寫的配置文件來自定義。缺省情況下,主配置文件放置在app/config/目錄中,被命名為config.yml、config.xml或config.php,這取決于你所使用的格式:

# app/config/config.yml
framework:
  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 Configuration
twig:
  debug:      %kernel.debug%
  strict_variables: %kernel.debug%

我們將在下一節(jié)環(huán)境中展示如何準確地選擇要引導的文件/格式。

每一個頂級條目,如framework或twig都被配置成一個特定的Bundle。例如,framework被配置成Symfony2的核心FrameworkBundle,并包含路由、模板和其它核心系統(tǒng)的配置。

現(xiàn)在別擔心配置文件中各段中的特定配置選項,配置文件缺省值都是合理的。當你瀏覽Symfony2的各部分時,你將學到每個部分的特定配置選項。

配置格式

縱觀整個章節(jié),所有的配置示例都用三種格式(YAML、XML和PHP)展示。它們每個都有自己的優(yōu)缺點,以下是三種格式的說明:

1、YAML:簡單、干凈和易讀
2、XML:有時比YAML更強大且支持IDE的自動完成
3、PHP:非常強大,但與標準配置格式相比易讀性差

環(huán)境

應用程序可以在不同的環(huán)境中運行。不同的環(huán)境共享相同的PHP代碼(由前端控制 器區(qū)分),但卻有著完全不同的配置。開發(fā)環(huán)境記錄警告和錯誤,而生產(chǎn)環(huán)境只記錄錯誤。在開發(fā)環(huán)境中一些文件在每次請求之后被重構,而在生產(chǎn)環(huán)境中卻被緩存 。所有的環(huán)境都在同一機制中生活。

雖然創(chuàng)建新的環(huán)境是容易的,但Symfony2項目通常會從三個環(huán)境開始(開發(fā)、測試和生產(chǎn))。通過在你瀏覽器中改變前端控制器,你可以很方便地讓應用程序在不同的環(huán)境中切換。要將應用程序切換到開發(fā)環(huán)境,只需要通過開發(fā)前端控制器去訪問應用程序即可。

http://localhost/app_dev.php/hello/Ryan

如果你想看看你的應用程序在生產(chǎn)環(huán)境中的表現(xiàn) ,可以調用生產(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)境中改變視圖時,你需要清除這些緩存文件,從而讓它們重構:

rm -rf app/cache/*

當進行自動測試時使用測試環(huán)境,它并不能從瀏覽器直接訪問。參見測試章節(jié)以得到更多細節(jié)。

環(huán)境配置

AppKernel類負責加載你所選的配置文件:

// app/AppKernel.php
public function registerContainerConfiguration(LoaderInterface $loader)
{
  $loader->load(__DIR__.'/config/config_'.$this->getEnvironment().'.yml');
}

我們已經(jīng)知道.yml擴展名可以轉換成.xml或.php,只要你喜歡使用XML或PHP來寫配置。注意每種環(huán)境也可以加載它們自己的配置文件。下面是為生產(chǎn)環(huán)境準備的配置文件。

# app/config/config_dev.yml
imports:
  - { resource: config.yml }
framework:
  router:  { resource: "%kernel.root_dir%/config/routing_dev.yml" }
  profiler: { only_exceptions: false }
web_profiler:
  toolbar: true
  intercept_redirects: true
zend:
  logger:
    priority: debug
    path:   %kernel.logs_dir%/%kernel.environment%.log

import關鍵詞與PHP格式中include語句一樣,都是首先引導主配置文件(config.yml),文件的其它部分是為了增長的日志和其它有利于開發(fā)環(huán)境的設置而對缺省配置進行的調整。

在生產(chǎn)環(huán)境和測試環(huán)境都遵循同樣一個模型:每個環(huán)境導入基本配置文件,然后修改它們的配置值去適應特殊環(huán)境的需要。

以上是“Symfony2如何創(chuàng)建頁面”這篇文章的所有內容,感謝各位的閱讀!希望分享的內容對大家有幫助,更多相關知識,歡迎關注創(chuàng)新互聯(lián)行業(yè)資訊頻道!

本文標題:Symfony2如何創(chuàng)建頁面-創(chuàng)新互聯(lián)
標題URL:http://muchs.cn/article2/iojic.html

成都網(wǎng)站建設公司_創(chuàng)新互聯(lián),為您提供手機網(wǎng)站建設、靜態(tài)網(wǎng)站、做網(wǎng)站定制開發(fā)、企業(yè)網(wǎng)站制作、App設計

廣告

聲明:本網(wǎng)站發(fā)布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經(jīng)允許不得轉載,或轉載時需注明來源: 創(chuàng)新互聯(lián)

外貿網(wǎng)站制作