露镁隆垄URL潞脥脗路脫脡 · tp5文档

# 快速入门（二）：URL和路由本章讲解`URL`访问和路由的使用，主要包含： - - [URL访问](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#url-) - [参数传入](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u53C2u6570u4F20u5165) - [隐藏index.php](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#-index-php) - [定义路由](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u5B9Au4E49u8DEFu7531) - [完整匹配](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u5B8Cu6574u5339u914D) - [闭包定义](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u95EDu5305u5B9Au4E49) - [设置URL分隔符](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#-url--1) - [路由参数](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u8DEFu7531u53C2u6570) - [变量规则](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u53D8u91CFu89C4u5219) - [路由分组](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u8DEFu7531u5206u7EC4) - [复杂路由](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u590Du6742u8DEFu7531) - [生成URL地址](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#-url--2) - [总结](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/145250#u603Bu7ED3) ## URL访问 `ThinkPHP`采用单一入口模式访问应用，对应用的所有请求都定向到应用的入口文件，系统会从`URL`参数中解析当前请求的模块、控制器和操作，下面是一个标准的`URL`访问格式： ``` <pre class="calibre18"> ``` http: //serverName/index.php/模块/控制器/操作 ``` ``` > #### 提示： > > - - - - - - > > 模块在ThinkPHP中的概念其实就是应用目录下面的子目录，而官方的规范是目录名小写，因此模块全部采用小写命名，无论URL是否开启大小写转换，模块名都会强制小写。应用的`index`模块的`Index`控制器定义如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; class Index{ public function index(){ return 'index'; } public function hello($name = 'World'){ return 'Hello,' . $name . '!'; } } ``` ``` 如果我们直接访问入口文件的话，由于URL中没有模块、控制器和操作，因此系统会访问默认模块（index）下面的默认控制器（Index）的默认操作（index），因此下面的访问是等效的： ``` <pre class="calibre18"> ``` http://tp5.com/index.php http://tp5.com/index.php/index/index/index ``` ``` 如果要访问控制器的hello方法，则需要使用完整的URL地址 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/name/thinkphp ``` ``` 访问URL地址后页面输出结果为： ``` <pre class="calibre18"> ``` Hello,thinkphp! ``` ``` 由于`name`参数为可选参数，因此也可以使用 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello ``` ``` 访问URL地址后页面输出结果为： ``` <pre class="calibre18"> ``` Hello,World! ``` ``` 默认情况下，URL地址中的控制器和操作名是不区分大小写的，因此下面的访问其实是等效的： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/Index/Index http://tp5.com/index.php/index/INDEX/INDEX ``` ``` 如果你的控制器是驼峰的，例如定义一个HelloWorld控制器（`application/index/controller/HelloWorld.php`）： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; class HelloWorld{ public function index($name = 'World'){ return 'Hello,' . $name . '!'; } } ``` ``` 正确的URL访问地址（该地址可以使用url方法生成）应该是： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/hello_world/index ``` ``` 系统会自动定位到`HelloWorld`控制器类去操作。如果使用 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/HelloWorld/index ``` ``` 将会报错，并提示`Helloworld`控制器类不存在。如果希望严格区分大小写访问（或者要支持驼峰法进行控制器访问），可以在应用配置文件中设置： ``` <pre class="calibre18"> ``` // 关闭URL自动转换（支持驼峰访问控制器）'url_convert' => false, ``` ``` 关闭URL自动转换之后，必须使用下面的URL地址访问（控制器名称必须严格使用控制器类的名称，不包含控制器后缀）： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/Index/index http://tp5.com/index.php/index/HelloWorld/index ``` ``` > #### 提示： > > - - - - - - > > 操作方法的访问本身不会受URL自动转换的影响，但会影响默认的模板渲染输出。如果你的服务器环境不支持`pathinfo`方式的URL访问，可以使用兼容方式，例如： ``` <pre class="calibre18"> ``` http://tp5.com/index.php?s=/index/Index/index ``` ``` 其中变量`s`的名称的可以配置的。 > 5.0不再支持普通的URL访问方式，所以下面的访问是无效的，你会发现无论输入什么，访问的都是默认的控制器和操作^\_^ ``` <pre class="calibre18"> ``` http: //tp5.com/index.php?m=index&c=Index&a=hello ``` ``` ## 参数传入通过操作方法的参数绑定功能，可以实现自动获取URL的参数，仍然以上面的控制器为例，控制器代码如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; class Index{ public function index(){ return 'index'; } public function hello($name = 'World'){ return 'Hello,' . $name . '!'; } } ``` ``` 当我们访问 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello ``` ``` 就是访问`app\index\controller\Index`控制器类的`hello`方法，因为没有传入任何参数，`name`参数就使用默认值`World`。如果传入name参数，则使用： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/name/thinkphp ``` ``` 页面输出结果为： ``` <pre class="calibre18"> ``` Hello,thinkphp! ``` ``` 现在给hello方法增加第二个参数： ``` <pre class="calibre18"> ``` public function hello($name = 'World', $city = ''){ return 'Hello,' . $name . '! You come from ' . $city . '.'; } ``` ``` 访问地址为 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/name/thinkphp/city/shanghai ``` ``` 页面输出结果为： ``` <pre class="calibre18"> ``` Hello,thinkphp! You come from shanghai. ``` ``` 可以看到，`hello`方法会自动获取URL地址中的同名参数值作为方法的参数值，而且这个参数的传入顺序不受URL参数顺序的影响，例如下面的URL地址输出的结果和上面是一样的： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/city/shanghai/name/thinkphp ``` ``` 或者使用 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello?city=shanghai&name=thinkphp ``` ``` 还可以进一步对URL地址做简化，前提就是我们必须明确参数的顺序代表的变量，我们更改下URL参数的获取方式，把应用配置文件中的`url_param_type`参数的值修改如下： ``` <pre class="calibre18"> ``` // 按照参数顺序获取'url_param_type' => 1, ``` ``` 现在，URL的参数传值方式就变成了严格按照操作方法的变量定义顺序来传值了，也就是说我们必须使用下面的URL地址访问才能正确传入`name`和`city`参数到`hello`方法： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/thinkphp/shanghai ``` ``` 页面输出结果为： ``` <pre class="calibre18"> ``` Hello,thinkphp! You come from shanghai. ``` ``` 如果改变参数顺序为 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/shanghai/thinkphp ``` ``` 页面输出结果为： ``` <pre class="calibre18"> ``` Hello,shanghai! You come from thinkphp. ``` ``` 显然不是我们预期的结果。同样，我们试图通过 ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello/name/thinkphp/city/shanghai ``` ``` 访问也不会得到正确的结果。但下面的方式仍然可以得到正确的结果： ``` <pre class="calibre18"> ``` http://tp5.com/index.php/index/index/hello?name=thinkphp&city=shanghai ``` ``` > #### 注意 > > - - - - - - > > 按顺序绑定参数的话，操作方法的参数只能使用URL pathinfo变量，而不能使用get或者post变量。 ## 隐藏index.php 可以去掉URL地址里面的入口文件`index.php`，但是需要额外配置WEB服务器的重写规则。以`Apache`为例，需要在入口文件的同级添加`.htaccess`文件（官方默认自带了该文件），内容如下： ``` <pre class="calibre18"> ``` <IfModule mod_rewrite.c>Options +FollowSymlinks -Multiviews RewriteEngine onRewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]</IfModule> ``` ``` 如果用的`phpstudy`，规则如下： ``` <pre class="calibre18"> ``` <IfModule mod_rewrite.c>Options +FollowSymlinks -Multiviews RewriteEngine onRewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1] </IfModule> ``` ``` 接下来就可以使用下面的URL地址访问了 ``` <pre class="calibre18"> ``` http://tp5.com/index/index/index http://tp5.com/index/index/hello ``` ``` 如果你使用的`apache`版本使用上面的方式无法正常隐藏`index.php`，可以尝试使用下面的方式配置`.htaccess`文件： ``` <pre class="calibre18"> ``` <IfModule mod_rewrite.c>Options +FollowSymlinks -Multiviews RewriteEngine onRewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]</IfModule> ``` ``` 如果是`Nginx`环境的话，可以在`Nginx.conf`中添加： ``` <pre class="calibre18"> ``` location / { // …..省略部分代码 if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=/$1 last; break; } } ``` ``` > #### 提示： > > - - - - - - > > 后面的示例访问地址，我们都假设配置了隐藏`index.php`。 ## 定义路由 URL地址里面的`index`模块怎么才能省略呢，默认的URL地址显得有点长，下面就来说说如何通过路由简化URL访问。我们在路由定义文件（`application/route.php`）里面添加一些路由规则，如下： ``` <pre class="calibre18"> ``` return [ // 添加路由规则路由到 index控制器的hello操作方法'hello/:name' => 'index/index/hello', ]; ``` ``` 该路由规则表示所有`hello`开头的并且带参数的访问都会路由到`index`控制器的`hello`操作方法。路由之前的URL访问地址为： ``` <pre class="calibre18"> ``` http://tp5.com/index/index/hello/name/thinkphp ``` ``` 定义路由后就只能访问下面的URL地址 ``` <pre class="calibre18"> ``` http: //tp5.com/hello/thinkphp ``` ``` > #### 注意 > > - - - - - - > > 定义路由规则后，原来的URL地址将会失效，变成非法请求。 ![](https://img.kancloud.cn/09/79/097906eadffa5e3cee8ba09c28759ede_721x309.png) 但这里有一个小问题，如果我们只是访问 ``` <pre class="calibre18"> ``` http: //tp5.com/hello ``` ``` 将发生错误， ![](https://img.kancloud.cn/6e/e0/6ee0cf0e051014518f53c53433048c20_874x540.png) 事实上这是由于路由没有正确匹配到，我们修改路由规则如下： ``` <pre class="calibre18"> ``` return [ // 路由参数name为可选'hello/[:name]' => 'index/hello', ]; ``` ``` 使用`[]`把路由规则中的变量包起来，就表示该变量为可选，接下来就可以正常访问了。 ``` <pre class="calibre18"> ``` http: //tp5.com/hello ``` ``` 当`name`参数没有传入值的时候，`hello`方法的`name`参数有默认值`World`，所以输出的内容为 `Hello,World!` 除了路由配置文件中定义之外，还可以采用动态定义路由规则的方式定义，例如在路由配置文件（`application/route.php`）的开头直接添加下面的方法： ``` <pre class="calibre18"> ``` use think\Route; Route::rule('hello/:name', 'index/hello'); ``` ``` 完成的效果和使用配置方式定义是一样的。无论是配置方式还是通过Route类的方法定义路由，都统一放到路由配置文件`application/route.php`文件中，具体原因后面会揭晓。 > #### 提示： > > - - - - - - > > 注意路由配置不支持在模块配置文件中设置。 ## 完整匹配前面定义的路由是只要以hello开头就能进行匹配，如果需要完整匹配，可以使用下面的定义： ``` <pre class="calibre18"> ``` return [ // 路由参数name为可选'hello/[:name]$' => 'index/hello', ]; ``` ``` 当路由规则以`$`结尾的时候就表示当前路由规则需要完整匹配。当我们访问下面的URL地址的时候： ``` <pre class="calibre18"> ``` http: //tp5.com/hello // 正确匹配 http: //tp5.com/hello/thinkphp // 正确匹配 http: //tp5.com/hello/thinkphp/val/value // 不会匹配 ``` ``` ## 闭包定义还支持通过定义闭包为某些特殊的场景定义路由规则，例如： ``` <pre class="calibre18"> ``` return [ // 定义闭包'hello/[:name]' => function ($name) { return 'Hello,' . $name . '!'; }, ]; ``` ``` 或者 ``` <pre class="calibre18"> ``` use think\Route; Route::rule('hello/:name', function ($name) { return 'Hello,' . $name . '!'; }); ``` ``` > #### 提示： > > - - - - - - > > 闭包函数的参数就是路由规则中定义的变量。因此，当访问下面的URL地址： ``` <pre class="calibre18"> ``` http: //tp5.com/hello/thinkphp ``` ``` 会输出 ``` <pre class="calibre18"> ``` Hello,thinkphp! ``` ``` ## 设置URL分隔符如果需要改变URL地址中的`pathinfo`参数分隔符，只需要在应用配置文件（`application/config.php`）中设置： ``` <pre class="calibre18"> ``` // 设置pathinfo分隔符'pathinfo_depr' => '-', ``` ``` 路由规则定义无需做任何改变，我们就可以访问下面的地址： ``` <pre class="calibre18"> ``` http: //tp5.com/hello-thinkphp ``` ``` ## 路由参数我们还可以约束路由规则的请求类型或者URL后缀之类的条件，例如： ``` <pre class="calibre18"> ``` return [ // 定义路由的请求类型和后缀'hello/[:name]' => ['index/hello', ['method' => 'get', 'ext' => 'html']], ]; ``` ``` 上面定义的路由规则限制了必须是`get`请求，而且后缀必须是`html`的，所以下面的访问地址： ``` <pre class="calibre18"> ``` http: //tp5.com/hello // 无效 http: //tp5.com/hello.html // 有效 http: //tp5.com/hello/thinkphp // 无效 http: //tp5.com/hello/thinkphp.html // 有效 ``` ``` > 更多的路由参数请参考完全开发手册的路由参数一节。 ## 变量规则接下来，我们来尝试一些复杂的路由规则定义满足不同的路由变量。在此之前，首先增加一个控制器类如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; class Blog{ public function get($id){ return '查看id=' . $id . '的内容'; } public function read($name){ return '查看name=' . $name . '的内容'; } public function archive($year, $month){ return '查看' . $year . '/' . $month . '的归档内容'; } } ``` ``` 添加如下路由规则： ``` <pre class="calibre18"> ``` return [ 'blog/:year/:month' => ['blog/archive', ['method' => 'get'], ['year' => '\d{4}', 'month' => '\d{2}']], 'blog/:id' => ['blog/get', ['method' => 'get'], ['id' => '\d+']], 'blog/:name' => ['blog/read', ['method' => 'get'], ['name' => '\w+']], ]; ``` ``` 在上面的路由规则中，我们对变量进行的规则约束，变量规则使用正则表达式进行定义。我们看下几种URL访问的情况 ``` <pre class="calibre18"> ``` // 访问id为5的内容 http: //tp5.com/blog/5 // 访问name为thinkphp的内容 http: //tp5.com/blog/thinkphp // 访问2015年5月的归档内容 http: //tp5.com/blog/2015/05 ``` ``` ## 路由分组上面的三个路由规则由于都是`blog`打头，所以我们可以做如下的简化： ``` <pre class="calibre18"> ``` return [ '[blog]' => [ ':year/:month' => ['blog/archive', ['method' => 'get'], ['year' => '\d{4}', 'month' => '\d{2}']], ':id' => ['blog/get', ['method' => 'get'], ['id' => '\d+']], ':name' => ['blog/read', ['method' => 'get'], ['name' => '\w+']], ], ]; ``` ``` 对于这种定义方式，我们称之为路由分组，路由分组一定程度上可以提高路由检测的效率。 ## 复杂路由有时候，我们还需要对URL做一些特殊的定制，例如如果要同时支持下面的访问地址 ``` <pre class="calibre18"> ``` http: //tp5.com/blog/thinkphp http: //tp5.com/blog-2015-05 ``` ``` 我们只要稍微改变路由定义规则即可： ``` <pre class="calibre18"> ``` return [ 'blog/:id' => ['blog/get', ['method' => 'get'], ['id' => '\d+']], 'blog/:name' => ['blog/read', ['method' => 'get'], ['name' => '\w+']], 'blog-<year>-<month>' => ['blog/archive', ['method' => 'get'], ['year' => '\d{4}', 'month' => '\d{2}']], ]; ``` ``` 对 `blog-<year>-<month>` 这样的非正常规范，我们需要使用`<变量名>`这样的变量定义方式，而不是 `:变量名`方式。简单起见，我们还可以把变量规则统一定义，例如： ``` <pre class="calibre18"> ``` return [ // 全局变量规则定义'__pattern__' => [ 'name' => '\w+', 'id' => '\d+', 'year' => '\d{4}', 'month' => '\d{2}', ], // 路由规则定义'blog/:id' => 'blog/get', 'blog/:name' => 'blog/read', 'blog-<year>-<month>' => 'blog/archive', ]; ``` ``` 在`__pattern__`中定义的变量规则我们称之为全局变量规则，在路由规则里面定义的变量规则我们称之为局部变量规则，如果一个变量同时定义了全局规则和局部规则的话，当前的局部规则会覆盖全局规则的，例如： ``` <pre class="calibre18"> ``` return [ // 全局变量规则'__pattern__' => [ 'name' => '\w+', 'id' => '\d+', 'year' => '\d{4}', 'month' => '\d{2}', ], 'blog/:id' => 'blog/get', // 定义了局部变量规则'blog/:name' => ['blog/read', ['method' => 'get'], ['name' => '\w{5,}']], 'blog-<year>-<month>' => 'blog/archive', ]; ``` ``` ## 生成URL地址定义路由规则之后，我们可以通过Url类来方便的生成实际的URL地址（路由地址），针对上面的路由规则，我们可以用下面的方式生成URL地址。 ``` <pre class="calibre18"> ``` // 输出 blog/thinkphp Url::build('blog/read', 'name=thinkphp'); Url::build('blog/read', ['name' => 'thinkphp']); // 输出 blog/5 Url::build('blog/get', 'id=5'); Url::build('blog/get', ['id' => 5]); // 输出 blog/2015/05 Url::build('blog/archive', 'year=2015&month=05'); Url::build('blog/archive', ['year' => '2015', 'month' => '05']); ``` ``` > #### 提示： > > - - - - - - > > build方法的第一个参数使用路由定义中的完整路由地址。我们还可以使用系统提供的助手函数url来简化 ``` <pre class="calibre18"> ``` url('blog/read', 'name=thinkphp'); // 等效于Url::build('blog/read', 'name=thinkphp'); ``` ``` > 如果我们的路由规则发生调整，生成的URL地址会自动变化。如果你配置了`url_html_suffix`参数的话，生成的URL地址会带上后缀，例如： ``` <pre class="calibre18"> ``` 'url_html_suffix' => 'html', ``` ``` 那么生成的URL地址类似 ``` <pre class="calibre18"> ``` blog/thinkphp.html blog/2015/05.html ``` ``` 如果你的URL地址全部采用路由方式定义，也可以直接使用路由规则来定义URL生成，例如： ``` <pre class="calibre18"> ``` url('/blog/thinkphp'); Url::build('/blog/8'); Url::build('/blog/archive/2015/05'); ``` ``` 生成方法的第一个参数一定要和路由定义的路由地址保持一致，如果你的路由地址比较特殊，例如使用闭包定义的话，则需要手动给路由指定标识，例如： ``` <pre class="calibre18"> ``` // 添加hello路由标识 Route::rule(['hello','hello/:name'], function($name){ return 'Hello,'.$name; }); // 根据路由标识快速生成URL Url::build('hello', 'name=thinkphp'); // 或者使用 Url::build('hello', ['name' => 'thinkphp']); ``` ``` 目前为止，我们掌握的路由功能还只是ThinkPHP`5.0`路由功能的冰山一角，以后我们还会通过更多的专题来讲解路由。 ## 总结看完本篇内容后，你应该了解如下的知识： - URL访问规范 - 路由定义 - URL地址生成