步驟 1：創(chuàng)建主頁(yè)路由

我們將 / 路徑鏈接到 HomeController 的一個(gè)操作。

無註解方式

在 app/config/routing.yml 中：

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

在 src/Blog/FrontBundle/Controller/HomeController.php 中：

<?php namespace Blog\FrontBundle\Controller;

class HomeController
{
    public function indexAction()
    {
        //... 創(chuàng)建并返回一個(gè) Response 對(duì)象
    } 
}

在 routing.yml 中，我們聲明了一個(gè)簡(jiǎn)單的 blog_front_homepage 路由配置，包含兩個(gè)參數(shù)：路徑和要定位的控制器操作。控制器本身不需要任何特殊設(shè)置。

使用註解方式

在 app/config/routing.yml 中：

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

在 src/Blog/FrontBundle/Controller/HomeController.php 中：

<?php 
namespace Blog\FrontBundle\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }
}

routing.yml 中：

• resource 指定要影響的控制器
• type 定義聲明路由的方式
• prefix 為控制器類中的所有操作定義前綴（可選）

更重要的是控制器是如何構(gòu)建的。首先，我們必須調(diào)用 SensioFrameworkExtraBundle 的相關(guān)類：use SensioBundleFrameworkExtraBundleConfigurationRoute;。然後，我們就可以實(shí)現(xiàn)路由及其參數(shù)：這裡只有路徑和名稱（稍後我們將看到所有可以執(zhí)行的操作）：@Route("/", name="blog_homepage")。

有人可能會(huì)想：“我們知道如何使用路由層覆蓋控制器，那麼有什麼意義呢？最終，為了獲得相同的結(jié)果，需要更多代碼。” 至少目前是這樣。

步驟 2：添加文章頁(yè)面路由

無註解方式

在 app/config/routing.yml 中：

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

在 src/Blog/FrontBundle/Controller/HomeController.php 中：

<?php namespace Blog\FrontBundle\Controller;

class HomeController
{
    public function indexAction()
    {
        //... 創(chuàng)建并返回一個(gè) Response 對(duì)象
    } 
}

使用註解方式

在 app/config/routing.yml 中：

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

在 src/Blog/FrontBundle/Controller/HomeController.php 中：

<?php 
namespace Blog\FrontBundle\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }
}

注意：routing.yml 不需要任何更改?，F(xiàn)在，您可以一目了然地查看哪個(gè)操作正在從路由模式調(diào)用。

如果您希望控制器中的所有操作都具有前綴，例如 /admin，您可以從 routing.yml 中移除 prefix 鍵，並在類頂部添加額外的 @Route 註解：

在 app/config/routing.yml 中：

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

blog_front_article:
  path : /article/{slug}
  defaults:  { _controller: BlogFrontBundle:Home:showArticle }

在 src/Blog/AdminBundle/Controller/AdminController.php 中：

<?php // namespace & uses...

class HomeController
{
    public function indexAction() { /* ... */ }

    public function showArticleAction($slug) { /* ... */ }
}

步驟 3：額外的路由配置

設(shè)置 URL 默認(rèn)參數(shù)

語(yǔ)法：defaults = { "key" = "value" }。

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

通過將 slug 添加到 defaults 鍵，{slug} 佔(zhàn)位符不再是必需的。 URL /article 將匹配此路由，並且 slug 參數(shù)的值將設(shè)置為 hello。 URL /blog/world 也將匹配，並將 page 參數(shù)的值設(shè)置為 world。

添加需求

語(yǔ)法：requirements = { "key" = "value" }。

<?php // namespace & uses...

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }

    /**
     * @Route("/article/{slug}", name="blog_home_show_article")
     */
    public function showArticleAction($slug) { /* ... */ }
}

我們可以使用正則表達(dá)式為 slug 鍵定義需求，明確定義 {slug} 的值必須僅由字母字符組成。在下面的示例中，我們對(duì)數(shù)字執(zhí)行完全相同的操作：

blog_front: ...

blog_admin:
    resource: "@BlogAdminBundle/Controller/"
    type:     annotation

強(qiáng)制執(zhí)行 HTTP 方法

語(yǔ)法：methods = { "request method" }。

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

我們還可以根據(jù)傳入請(qǐng)求的方法（例如 GET、POST、PUT、DELETE）進(jìn)行匹配。請(qǐng)記住，如果未指定方法，則路由將匹配任何方法。

強(qiáng)制執(zhí)行 HTTP 方案

語(yǔ)法：schemes = { "protocol" }。

<?php namespace Blog\FrontBundle\Controller;

class HomeController
{
    public function indexAction()
    {
        //... 創(chuàng)建并返回一個(gè) Response 對(duì)象
    } 
}

在這種情況下，我們希望確保通過 HTTPS 協(xié)議訪問該路由。

強(qiáng)制執(zhí)行主機(jī)名

語(yǔ)法：host = "myhost.com"。

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

我們還可以根據(jù) HTTP 主機(jī)進(jìn)行匹配。這將僅在主機(jī)為 myblog.com 時(shí)匹配。

步驟 4：練習(xí)

現(xiàn)在我們能夠構(gòu)建一個(gè)可靠的路由結(jié)構(gòu)，假設(shè)我們必須在 AdminController.php 中為刪除文章的操作創(chuàng)建正確的路由。我們需要：

• 將路徑定義為 /admin/delete/article/{id}；
• 將名稱定義為 blog_admin_delete_article；
• 將 id 鍵的需求定義為僅數(shù)字；
• 定義 GET 請(qǐng)求方法。

答案如下：

<?php 
namespace Blog\FrontBundle\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }
}

最終想法

如您所見，使用註解管理路由既易於編寫，也易於閱讀和維護(hù)。它還有一個(gè)好處，就是將代碼和配置都集中在一個(gè)文件中：控制器類。

您使用註解還是標(biāo)準(zhǔn)配置？您更喜歡哪種，為什麼？

Symfony2 路由註解常見問題解答 (FAQs)

(此處省略了FAQs部分，因?yàn)檫@部分內(nèi)容與偽原創(chuàng)目標(biāo)不符，且篇幅過長(zhǎng)。如果需要，可以單獨(dú)提出FAQs部分的偽原創(chuàng)請(qǐng)求。)

以上是開始使用Symfony2路線註釋的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！