前面的話:本文將詳細介紹thinkphp5URL和路由

URL訪問

ThinkPHP采用單一入口模式訪問應用，對應用的所有請求都定向到應用的入口文件，系統(tǒng)會從URL參數(shù)中解析當前請求的模塊、控制器和操作，下面是一個標準的URL訪問格式：

http://domainName/index.php/模塊/控制器/操作

其中index.php就稱之為應用的入口文件（注意入口文件可以被隱藏，后面會提到）

模塊在ThinkPHP中的概念其實就是應用目錄下面的子目錄，而官方的規(guī)范是目錄名小寫，因此模塊全部采用小寫命名，無論URL是否開啟大小寫轉(zhuǎn)換，模塊名都會強制小寫

應用的index模塊的Index控制器定義如下:

1. namespace app/index/controller; 
2. class Index 
3. { 
4.   public function index() 
5.   { 
6.     return 'index'; 
7.   } 
8.   public function hello($name = 'World') 
9.   { 
10.     return 'Hello,' . $name . '!'; 
11.   } 
12. } 

如果直接訪問入口文件的話，由于URL中沒有模塊、控制器和操作，因此系統(tǒng)會訪問默認模塊（index）下面的默認控制器（Index）的默認操作（index），因此下面的訪問是等效的：

http://tp5.com/index.php

http://tp5.com/index.php/index/index/index

如果要訪問控制器的hello方法，則需要使用完整的URL地址

http://tp5.com/index.php/index/index/hello/name/thinkphp

訪問URL地址后頁面輸出結果為：

Hello,thinkphp!

由于name參數(shù)為可選參數(shù)，因此也可以使用

http://tp5.com/index.php/index/index/hello

訪問URL地址后頁面輸出結果為：

Hello,World!

默認情況下,URL地址中的控制器和操作名是不區(qū)分大小寫的，因此下面的訪問其實是等效的：

http://tp5.com/index.php/index/Index/Index

http://tp5.com/index.php/index/INDEX/INDEX

如果控制器是駝峰的，例如定義一個HelloWorld控制器（application/index/controller/HelloWorld.php）:

1. namespace app/index/controller; 
2. class HelloWorld 
3. { 
4.   public function index($name = 'World') 
5.   { 
6.     return 'Hello,' . $name . '!'; 
7.   } 
8. } 

正確的URL訪問地址（該地址可以使用url方法生成）應該是

http://tp5.com/index.php/index/hello_world/index

系統(tǒng)會自動定位到HelloWorld控制器類去操作

如果使用

http://tp5.com/index.php/index/HelloWorld/index

將會報錯，并提示Helloworld控制器類不存在

如果希望嚴格區(qū)分大小寫訪問（這樣就可以支持駝峰法進行控制器訪問），可以在應用配置文件中設置：

// 關閉URL自動轉(zhuǎn)換（支持駝峰訪問控制器）

'url_convert' => false,

關閉URL自動轉(zhuǎn)換之后，必須使用下面的URL地址訪問（控制器名稱必須嚴格使用控制器類的名稱，不包含控制器后綴）：

http://tp5.com/index.php/index/Index/index

http://tp5.com/index.php/index/HelloWorld/index

如果服務器環(huán)境不支持pathinfo方式的URL訪問，可以使用兼容方式，例如：

http://tp5.com/index.php?s=/index/Index/index

其中變量s的名稱的可以配置的

5.0不再支持普通的URL訪問方式，所以下面的訪問是無效的，你會發(fā)現(xiàn)無論輸入什么，訪問的都是默認的控制器和操作

http://tp5.com/index.php?m=index&c=Index&a=hello

參數(shù)傳入

通過操作方法的參數(shù)綁定功能，可以實現(xiàn)自動獲取URL的參數(shù)，仍然以上面的控制器為例，控制器代碼如下:

1. namespace app/index/controller; 
2. class Index 
3. { 
4.   public function index() 
5.   { 
6.     return 'index'; 
7.   } 
8.   public function hello($name = 'World') 
9.   { 
10.     return 'Hello,' . $name . '!'; 
11.   } 
12. } 

當我們訪問

http://tp5.com/index.php/index/index/hello

就是訪問appindexcontrollerIndex控制器類的hello方法，因為沒有傳入任何參數(shù)，name參數(shù)就使用默認值World。如果傳入name參數(shù)，則使用：

http://tp5.com/index.php/index/index/hello/name/thinkphp

頁面輸出結果為：

Hello,thinkphp!

現(xiàn)在給hello方法增加第二個參數(shù):

1. public function hello($name = 'World', $city = '') 
2.   { 
3.     return 'Hello,' . $name . '! You come from ' . $city . '.'; 
4.   } 

訪問地址為http://tp5.com/index.php/index/index/hello/name/thinkphp/city/shanghai

頁面輸出結果為:

Hello,thinkphp! You come from shanghai.

可以看到，hello方法會自動獲取URL地址中的同名參數(shù)值作為方法的參數(shù)值，而且這個參數(shù)的傳入順序不受URL參數(shù)順序的影響，例如下面的URL地址輸出的結果和上面是一樣的：

http://tp5.com/index.php/index/index/hello/city/shanghai/name/thinkphp

或者使用http://tp5.com/index.php/index/index/hello?city=shanghai&name=thinkphp

還可以進一步對URL地址做簡化，前提就是我們必須明確參數(shù)的順序代表的變量，我們更改下URL參數(shù)的獲取方式，把應用配置文件中的url_param_type參數(shù)的值修改如下：

// 按照參數(shù)順序獲取

'url_param_type' => 1,

現(xiàn)在，URL的參數(shù)傳值方式就變成了嚴格按照操作方法的變量定義順序來傳值了，也就是說我們必須使用下面的URL地址訪問才能正確傳入name和city參數(shù)到hello方法：http://tp5.com/index.php/index/index/hello/thinkphp/shanghai

頁面輸出結果為：

Hello,thinkphp! You come from shanghai.

如果改變參數(shù)順序為http://tp5.com/index.php/index/index/hello/shanghai/thinkphp

頁面輸出結果為：

Hello,shanghai! You come from thinkphp.

顯然不是我們預期的結果。

同樣，我們試圖通過http://tp5.com/index.php/index/index/hello/name/thinkphp/city/shanghai

訪問也不會得到正確的結果

[注意]按順序綁定參數(shù)的話，操作方法的參數(shù)只能使用URL pathinfo變量，而不能使用get或者post變量

隱藏入口

可以去掉URL地址里面的入口文件index.php，但是需要額外配置WEB服務器的重寫規(guī)則。

以Apache為例，需要在入口文件的同級添加.htaccess文件（官方默認自帶了該文件），內(nèi)容如下:

1. <IfModule mod_rewrite.c> 
2. Options +FollowSymlinks -Multiviews 
3. RewriteEngine on 
4. RewriteCond %{REQUEST_FILENAME} !-d 
5. RewriteCond %{REQUEST_FILENAME} !-f 
6. RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] 
7. </IfModule> 

如果用的phpstudy，規(guī)則如下:

1. <IfModule mod_rewrite.c>  
2. Options +FollowSymlinks -Multiviews  
3. RewriteEngine on  
4. RewriteCond %{REQUEST_FILENAME} !-d  
5. RewriteCond %{REQUEST_FILENAME} !-f  
6. RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]  
7. </IfModule> 

接下來就可以使用下面的URL地址訪問了

http://tp5.com/index/index/index

http://tp5.com/index/index/hello

如果使用的apache版本使用上面的方式無法正常隱藏index.php，可以嘗試使用下面的方式配置.htaccess文件：

1. <IfModule mod_rewrite.c> 
2. Options +FollowSymlinks -Multiviews 
3. RewriteEngine on 
4. RewriteCond %{REQUEST_FILENAME} !-d 
5. RewriteCond %{REQUEST_FILENAME} !-f 
6. RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L] 
7. </IfModule> 

如果是Nginx環(huán)境的話，可以在Nginx.conf中添加：

1. location / { // …..省略部分代碼 
2.   if (!-e $request_filename) { 
3.     rewrite ^(.*)$ /index.php?s=/$1 last; 
4.     break; 
5.   } 
6. } 

定義路由:

URL地址里面的index模塊怎么才能省略呢，默認的URL地址顯得有點長，下面就來說說如何通過路由簡化URL訪問。

我們在路由定義文件（application/route.php）里面添加一些路由規(guī)則，如下:

1. return [ 
2.   // 添加路由規(guī)則 路由到 index控制器的hello操作方法 
3.   'hello/:name' => 'index/index/hello', 
4. ]; 

該路由規(guī)則表示所有hello開頭的并且?guī)?shù)的訪問都會路由到index控制器的hello操作方法。

路由之前的URL訪問地址為：http://tp5.com/index/index/hello/name/thinkphp

定義路由后就只能訪問下面的URL地址http://tp5.com/hello/thinkphp

[注意]定義路由規(guī)則后，原來的URL地址將會失效，變成非法請求。

但這里有一個小問題，如果我們只是訪問http://tp5.com/hello

將發(fā)生錯誤

事實上這是由于路由沒有正確匹配到，我們修改路由規(guī)則如下：

1. return [ 
2.   // 路由參數(shù)name為可選 
3.   'hello/[:name]' => 'index/hello', 
4. ]; 

使用[]把路由規(guī)則中的變量包起來，就表示該變量為可選，接下來就可以正常訪問了http://tp5.com/hello

當name參數(shù)沒有傳入值的時候，hello方法的name參數(shù)有默認值World，所以輸出的內(nèi)容為 Hello,World!

除了路由配置文件中定義之外，還可以采用動態(tài)定義路由規(guī)則的方式定義，例如在路由配置文件（application/route.php）的開頭直接添加下面的方法：

use think/Route;

Route::rule('hello/:name', 'index/hello');

完成的效果和使用配置方式定義是一樣的。

無論是配置方式還是通過Route類的方法定義路由，都統(tǒng)一放到路由配置文件application/route.php文件中

[注意]路由配置不支持在模塊配置文件中設置

【完整匹配】

前面定義的路由是只要以hello開頭就能進行匹配，如果需要完整匹配，可以使用下面的定義:

1. return [ 
2.   // 路由參數(shù)name為可選 
3.   'hello/[:name]$' => 'index/hello', 
4. ]; 

當路由規(guī)則以$結尾的時候就表示當前路由規(guī)則需要完整匹配。

當我們訪問下面的URL地址的時候：

http://tp5.com/hello // 正確匹配

http://tp5.com/hello/thinkphp // 正確匹配

http://tp5.com/hello/thinkphp/val/value // 不會匹配

【閉包定義】

還支持通過定義閉包為某些特殊的場景定義路由規(guī)則，例如：

1. return [ 
2.   // 定義閉包 
3.   'hello/[:name]' => function ($name) { 
4.     return 'Hello,' . $name . '!'; 
5.   }, 
6. ]; 

或者

1. use think/Route; 
2. Route::rule('hello/:name', function ($name) { 
3.   return 'Hello,' . $name . '!'; 
4. }); 

[注意]閉包函數(shù)的參數(shù)就是路由規(guī)則中定義的變量

因此，當訪問下面的URL地址：http://tp5.com/hello/thinkphp

會輸出

Hello,thinkphp!

【設置URL分隔符】

如果需要改變URL地址中的pathinfo參數(shù)分隔符，只需要在應用配置文件（application/config.php）中設置：

// 設置pathinfo分隔符

'pathinfo_depr'     => '-',

路由規(guī)則定義無需做任何改變，我們就可以訪問下面的地址：http://tp5.com/hello-thinkphp

【路由參數(shù)】

還可以約束路由規(guī)則的請求類型或者URL后綴之類的條件，例如：

1. return [ 
2.   // 定義路由的請求類型和后綴 
3.   'hello/[:name]' => ['index/hello', ['method' => 'get', 'ext' => 'html']], 
4. ]; 

上面定義的路由規(guī)則限制了必須是get請求，而且后綴必須是html的，所以下面的訪問地址：

http://tp5.com/hello // 無效

http://tp5.com/hello.html // 有效

http://tp5.com/hello/thinkphp // 無效

http://tp5.com/hello/thinkphp.html // 有效

【變量規(guī)則】

接下來，嘗試一些復雜的路由規(guī)則定義滿足不同的路由變量。在此之前，首先增加一個控制器類如下：

1. <?php 
2. namespace app/index/controller; 
3. class Blog 
4. { 
5.   public function get($id) 
6.   { 
7.     return '查看id=' . $id . '的內(nèi)容'; 
8.   } 
9.   public function read($name) 
10.   { 
11.     return '查看name=' . $name . '的內(nèi)容'; 
12.   } 
13.   public function archive($year, $month) 
14.   { 
15.     return '查看' . $year . '/' . $month . '的歸檔內(nèi)容'; 
16.   } 
17. } 

添加如下路由規(guī)則:

1. return [ 
2.   'blog/:year/:month' => ['blog/archive', ['method' => 'get'], ['year' => '/d{4}', 'month' => '/d{2}']], 
3.   'blog/:id'     => ['blog/get', ['method' => 'get'], ['id' => '/d+']], 
4.   'blog/:name'    => ['blog/read', ['method' => 'get'], ['name' => '/w+']], 
5. ]; 

在上面的路由規(guī)則中，我們對變量進行的規(guī)則約束，變量規(guī)則使用正則表達式進行定義。

我們看下幾種URL訪問的情況

1. // 訪問id為5的內(nèi)容 
2. http://tp5.com/blog/5  
3. // 訪問name為thinkphp的內(nèi)容 
4. http://tp5.com/blog/thinkphp  
5. // 訪問2015年5月的歸檔內(nèi)容 
6. http://tp5.com/blog/2015/05 

【路由分組】

上面的三個路由規(guī)則由于都是blog打頭，所以我們可以做如下的簡化：

1. return [ 
2.   '[blog]' => [ 
3.     ':year/:month' => ['blog/archive', ['method' => 'get'], ['year' => '/d{4}', 'month' => '/d{2}']],   
4.     ':id'     => ['blog/get', ['method' => 'get'], ['id' => '/d+']], 
5.     ':name'    => ['blog/read', ['method' => 'get'], ['name' => '/w+']], 
6.   ], 
7. ]; 

對于這種定義方式，我們稱之為路由分組，路由分組一定程度上可以提高路由檢測的效率

【復雜路由】

有時候，還需要對URL做一些特殊的定制，例如如果要同時支持下面的訪問地址

http://tp5.com/blog/thinkphp

http://tp5.com/blog-2015-05

我們只要稍微改變路由定義規(guī)則即可:

1. return [ 
2.   'blog/:id'      => ['blog/get', ['method' => 'get'], ['id' => '/d+']], 
3.   'blog/:name'     => ['blog/read', ['method' => 'get'], ['name' => '/w+']], 
4.   'blog-<year>-<month>' => ['blog/archive', ['method' => 'get'], ['year' => '/d{4}', 'month' => '/d{2}']], 
5. ]; 

對 blog-<year>-<month> 這樣的非正常規(guī)范，我們需要使用<變量名>這樣的變量定義方式，而不是 :變量名方式。

簡單起見，我們還可以把變量規(guī)則統(tǒng)一定義，例如：

1. return [ 
2.   // 全局變量規(guī)則定義 
3.   '__pattern__'     => [ 
4.     'name' => '/w+', 
5.     'id'  => '/d+', 
6.     'year' => '/d{4}', 
7.     'month' => '/d{2}', 
8.   ], 
9.   // 路由規(guī)則定義 
10.   'blog/:id'      => 'blog/get', 
11.   'blog/:name'     => 'blog/read', 
12.   'blog-<year>-<month>' => 'blog/archive', 
13. ]; 

在__pattern__中定義的變量規(guī)則我們稱之為全局變量規(guī)則，在路由規(guī)則里面定義的變量規(guī)則我們稱之為局部變量規(guī)則，如果一個變量同時定義了全局規(guī)則和局部規(guī)則的話，當前的局部規(guī)則會覆蓋全局規(guī)則的，例如:

1. return [ 
2.   // 全局變量規(guī)則 
3.   '__pattern__'     => [ 
4.     'name' => '/w+', 
5.     'id'  => '/d+', 
6.     'year' => '/d{4}', 
7.     'month' => '/d{2}', 
8.   ], 
9.  
10.   'blog/:id'      => 'blog/get', 
11.   // 定義了局部變量規(guī)則 
12.   'blog/:name'     => ['blog/read', ['method' => 'get'], ['name' => '/w{5,}']], 
13.   'blog-<year>-<month>' => 'blog/archive', 
14. ]; 

URL生成

定義路由規(guī)則之后，可以通過Url類來方便的生成實際的URL地址（路由地址），針對上面的路由規(guī)則，我們可以用下面的方式生成URL地址。

1. // 輸出 blog/thinkphp 
2. Url::build('blog/read', 'name=thinkphp'); 
3. Url::build('blog/read', ['name' => 'thinkphp']); 
4. // 輸出 blog/5 
5. Url::build('blog/get', 'id=5'); 
6. Url::build('blog/get', ['id' => 5]); 
7. // 輸出 blog/2015/05 
8. Url::build('blog/archive', 'year=2015&month=05'); 
9. Url::build('blog/archive', ['year' => '2015', 'month' => '05']); 

[注意]build方法的第一個參數(shù)使用路由定義中的完整路由地址

還可以使用系統(tǒng)提供的助手函數(shù)url來簡化

url('blog/read', 'name=thinkphp');

// 等效于

Url::build('blog/read', 'name=thinkphp');

通常在模板文件中輸出的話，可以使用助手函數(shù)，例如：

{:url('blog/read', 'name=thinkphp')}

如果我們的路由規(guī)則發(fā)生調(diào)整，生成的URL地址會自動變化

如果你配置了url_html_suffix參數(shù)的話，生成的URL地址會帶上后綴，例如：

'url_html_suffix'  => 'html',

那么生成的URL地址 類似

blog/thinkphp.html

blog/2015/05.html

url('/blog/thinkphp');

Url::build('/blog/8');

Url::build('/blog/archive/2015/05');

生成方法的第一個參數(shù)一定要和路由定義的路由地址保持一致，如果你的路由地址比較特殊，例如使用閉包定義的話，則需要手動給路由指定標識,例如:

1. // 添加hello路由標識 
2. Route::rule(['hello','hello/:name'], function($name){ 
3.   return 'Hello,'.$name; 
4. }); 
5. // 根據(jù)路由標識快速生成URL 
6. Url::build('hello', 'name=thinkphp'); 
7. // 或者使用 
8. Url::build('hello', ['name' => 'thinkphp']);