The Yaf_Router class

(Yaf >=1.0.0)

簡(jiǎn)介

Yaf_Router是標(biāo)準(zhǔn)的框架路由.路由是一個(gè)拿到URI端點(diǎn)（URL中的URI的一部分）然后分解參數(shù)得到哪一個(gè)module, controller, 和action需要接受請(qǐng)求。module, controller, 和action，還有一些其他的參數(shù)是打包在一個(gè)Yaf_Request_Abstract的對(duì)象中，然后通過Yaf_Dispatcher來處理的。路由只發(fā)生一次:最初接到請(qǐng)求并且在第一個(gè)controller分發(fā)之前。 Yaf_Router 是設(shè)計(jì)來允許使用純PHP結(jié)構(gòu)的類似功能模塊的跳轉(zhuǎn)。它非常松散的基于Ruby on Rails的路由，并且不需要你提前就知道webserver URL跳轉(zhuǎn)的相關(guān)知識(shí)。它是設(shè)計(jì)來處理一個(gè)Apache 跳轉(zhuǎn)模塊的規(guī)則（一個(gè)） Yaf_Router是設(shè)計(jì)來允許mod_rewrite

示例 #1 Apache的跳轉(zhuǎn)規(guī)則

RewriteEngine on
RewriteRule !\.(js|ico|gif|jpg|png|css|html)$ index.php
or (preferred):

示例 #2 Apache的跳轉(zhuǎn)規(guī)則

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]
如果使用Lighttpd，下面的跳轉(zhuǎn)規(guī)則是有效的：

示例 #3 Lighttpd的跳轉(zhuǎn)規(guī)則

url.rewrite-once = (
  ".*\?(.*)$" => "/index.php?$1",
  ".*\.(js|ico|gif|jpg|png|css|html)$" => "$0",
  "" => "/index.php"
)
如果使用Nginx，下面的跳轉(zhuǎn)規(guī)則是有效的：

示例 #4 Nginx的跳轉(zhuǎn)規(guī)則

server {
  listen ****;
  server_name  yourdomain.com;
  root   document_root;
  index  index.php index.html;

  if (!-e $request_filename) {
    rewrite ^/(.*)  /index.php/$1 last;
  }
}

默認(rèn)路由

Yaf_Router預(yù)設(shè)了一個(gè)默認(rèn)路由，它將以controller/action的形式匹配URIs。此外，一個(gè)module的名字可以被指定為第一路徑元素，允許URIs設(shè)置為module/controller/action的形式。最后，它也會(huì)匹配一些URI中額外附加的參數(shù)，默認(rèn)形式是controller/action/var1/value1/var2/value2。

注意:

Module的名字必須要定義在配置中，就application.module="Index,Foo,Bar"而言，在這種情況下，僅僅index, foo 和 bar能被考慮作為為一個(gè)module的名稱。如果沒有在配置文件中定義，那么Yaf使用默認(rèn)的module名字“Index”。

如何匹配這些路由的一些例子：

示例 #5 Yaf_Route_Static(default route)example

// Assuming the following configure:
$conf = array(
   "application" => array(
      "modules" => "Index,Blog",
   ),
);

Controller only:
http://example/news
    controller == news
Action only(when defined yaf.action_prefer=1 in php.ini)
    action  == news
 
Invalid module maps to controller name:
http://example/foo
    controller == foo
 
Module + controller:
http://example/blog/archive
    module     == blog
    controller == archive
 
Module + controller + action:
http://example/blog/archive/list
    module     == blog
    controller == archive
    action     == list
 
Module + controller + action + params:
http://example/blog/archive/list/sort/alpha/date/desc
    module     == blog
    controller == archive
    action     == list
    sort       == alpha
    date       == desc

類摘要

class Yaf_Router {
/* 屬性 */
protected $_routes;
protected $_current;
/* 方法 */
public addConfig(Yaf_Config_Abstract $config): void
public addRoute(string $name, Yaf_Route_Abstract $route): Yaf_Router
public__construct()
public getCurrentRoute(): string
public getRoute(string $name): void
public getRoutes(): void
public route(Yaf_Request_Abstract $request): bool
}

屬性

_routes

_current

目錄