thinkphp5 URL和路由的功能详解与实例

最新推荐文章于 2022-02-20 16:00:55 发布
最新推荐文章于 2022-02-20 16:00:55 发布
阅读量361 收藏 1
点赞数
分类专栏： tp5糯米网课程 thinkphp5

转自：https://blog.csdn.net/weixin_39421014/article/details/82354718

文章出处：https://www.jb51.net/article/131549.htm

URL访问

ThinkPHP采用单一入口模式访问应用，对应用的所有请求都定向到应用的入口文件，系统会从URL参数中解析当前请求的模块、控制器和操作，下面是一个标准的URL访问格式：

?

1

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

其中index.php就称之为应用的入口文件（注意入口文件可以被隐藏，后面会提到）

模块在ThinkPHP中的概念其实就是应用目录下面的子目录，而官方的规范是目录名小写，因此模块全部采用小写命名，无论URL是否开启大小写转换，模块名都会强制小写

应用的index模块的Index控制器定义如下：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

<?php

namespace app\index\controller;

class Index

{

  public function index()

  {

    return 'index';

  }

  public function hello($name = 'World')

  {

    return 'Hello,' . $name . '!';

  }

}

如果直接访问入口文件的话，由于URL中没有模块、控制器和操作，因此系统会访问默认模块（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参数为可选参数，因此也可以使用

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

访问URL地址后页面输出结果为：

Hello,World!

默认情况下，URL地址中的控制器和操作名是不区分大小写的，因此下面的访问其实是等效的：

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

如果控制器是驼峰的，例如定义一个HelloWorld控制器（application/index/controller/HelloWorld.php）： 

?

1

2

3

4

5

6

7

8

9

<?php

namespace app\index\controller;

class HelloWorld

{

  public function index($name = 'World')

  {

    return 'Hello,' . $name . '!';

  }

}

正确的URL访问地址（该地址可以使用url方法生成）应该是

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

系统会自动定位到HelloWorld控制器类去操作

如果使用

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

将会报错，并提示Helloworld控制器类不存在

如果希望严格区分大小写访问（这样就可以支持驼峰法进行控制器访问），可以在应用配置文件中设置：

?

1

2

// 关闭URL自动转换（支持驼峰访问控制器）

'url_convert' => false,

关闭URL自动转换之后，必须使用下面的URL地址访问（控制器名称必须严格使用控制器类的名称，不包含控制器后缀）：

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

如果服务器环境不支持pathinfo方式的URL访问，可以使用兼容方式，例如：

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

其中变量s的名称的可以配置的

5.0不再支持普通的URL访问方式，所以下面的访问是无效的，你会发现无论输入什么，访问的都是默认的控制器和操作

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

参数传入

通过操作方法的参数绑定功能，可以实现自动获取URL的参数，仍然以上面的控制器为例，控制器代码如下：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

<?php

namespace app\index\controller;

class Index

{

  public function index()

  {

    return 'index';

  }

  public function hello($name = 'World')

  {

    return 'Hello,' . $name . '!';

  }

}

当我们访问

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

就是访问app\index\controller\Index控制器类的hello方法，因为没有传入任何参数，name参数就使用默认值World。如果传入name参数，则使用：

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

页面输出结果为：

Hello,thinkphp!

现在给hello方法增加第二个参数：

?

1

2

3

4

public function hello($name = 'World', $city = '')

  {

    return 'Hello,' . $name . '! You come from ' . $city . '.';

  }

访问地址为http://tp5.com/index.php/index/index/hello/name/thinkphp/city/shanghai

页面输出结果为：

Hello,thinkphp! You come from shanghai.

可以看到，hello方法会自动获取URL地址中的同名参数值作为方法的参数值，而且这个参数的传入顺序不受URL参数顺序的影响，例如下面的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地址做简化，前提就是我们必须明确参数的顺序代表的变量，我们更改下URL参数的获取方式，把应用配置文件中的url_param_type参数的值修改如下：

?

1

2

// 按照参数顺序获取

'url_param_type' => 1,

现在，URL的参数传值方式就变成了严格按照操作方法的变量定义顺序来传值了，也就是说我们必须使用下面的URL地址访问才能正确传入name和city参数到hello方法：http://tp5.com/index.php/index/index/hello/thinkphp/shanghai

页面输出结果为：

Hello,thinkphp! You come from shanghai.

如果改变参数顺序为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

访问也不会得到正确的结果

[注意]按顺序绑定参数的话，操作方法的参数只能使用URL pathinfo变量，而不能使用get或者post变量

隐藏入口

可以去掉URL地址里面的入口文件index.php，但是需要额外配置WEB服务器的重写规则。

以Apache为例，需要在入口文件的同级添加.htaccess文件（官方默认自带了该文件），内容如下

?

1

2

3

4

5

6

7

<IfModule mod_rewrite.c>

Options +FollowSymlinks -Multiviews

RewriteEngine on

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

</IfModule>

如果用的phpstudy，规则如下：

?

1

2

3

4

5

6

7

<IfModule mod_rewrite.c>

Options +FollowSymlinks -Multiviews

RewriteEngine on

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]

</IfModule>

接下来就可以使用下面的URL地址访问了

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

如果使用的apache版本使用上面的方式无法正常隐藏index.php，可以尝试使用下面的方式配置.htaccess文件：

?

1

2

3

4

5

6

7

<IfModule mod_rewrite.c>

Options +FollowSymlinks -Multiviews

RewriteEngine on

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]

</IfModule>

如果是Nginx环境的话，可以在Nginx.conf中添加：

?

1

2

3

4

5

6

location / { // …..省略部分代码

  if (!-e $request_filename) {

    rewrite ^(.*)$ /index.php?s=/$1 last;

    break;

  }

}

定义路由

URL地址里面的index模块怎么才能省略呢，默认的URL地址显得有点长，下面就来说说如何通过路由简化URL访问。

我们在路由定义文件（application/route.php）里面添加一些路由规则，如下：

?

1

2

3

4

return [

  // 添加路由规则 路由到 index控制器的hello操作方法

  'hello/:name' => 'index/index/hello',

];

该路由规则表示所有hello开头的并且带参数的访问都会路由到index控制器的hello操作方法。

路由之前的URL访问地址为：http://tp5.com/index/index/hello/name/thinkphp

定义路由后就只能访问下面的URL地址http://tp5.com/hello/thinkphp

[注意]定义路由规则后，原来的URL地址将会失效，变成非法请求。

但这里有一个小问题，如果我们只是访问http://tp5.com/hello

将发生错误

事实上这是由于路由没有正确匹配到，我们修改路由规则如下：

?

1

2

3

4

return [

  // 路由参数name为可选

  'hello/[:name]' => 'index/hello',

];

使用[]把路由规则中的变量包起来，就表示该变量为可选，接下来就可以正常访问了http://tp5.com/hello

当name参数没有传入值的时候，hello方法的name参数有默认值World，所以输出的内容为 Hello,World!

除了路由配置文件中定义之外，还可以采用动态定义路由规则的方式定义，例如在路由配置文件（application/route.php）的开头直接添加下面的方法：

?

1

2

use think\Route;

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

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

无论是配置方式还是通过Route类的方法定义路由，都统一放到路由配置文件application/route.php文件中

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

【完整匹配】

前面定义的路由是只要以hello开头就能进行匹配，如果需要完整匹配，可以使用下面的定义：

?

1

2

3

4

return [

  // 路由参数name为可选

  'hello/[:name]$' => 'index/hello',

];

当路由规则以$结尾的时候就表示当前路由规则需要完整匹配。

当我们访问下面的URL地址的时候：

http://tp5.com/hello // 正确匹配
http://tp5.com/hello/thinkphp // 正确匹配
http://tp5.com/hello/thinkphp/val/value // 不会匹配

【闭包定义】

还支持通过定义闭包为某些特殊的场景定义路由规则，例如：

?

1

2

3

4

5

6

return [

  // 定义闭包

  'hello/[:name]' => function ($name) {

    return 'Hello,' . $name . '!';

  },

];

或者

?

1

2

3

4

use think\Route;

Route::rule('hello/:name', function ($name) {

  return 'Hello,' . $name . '!';

});

[注意]闭包函数的参数就是路由规则中定义的变量

因此，当访问下面的URL地址：http://tp5.com/hello/thinkphp

会输出

Hello,thinkphp!

【设置URL分隔符】

如果需要改变URL地址中的pathinfo参数分隔符，只需要在应用配置文件（application/config.php）中设置：

?

1

2

// 设置pathinfo分隔符

'pathinfo_depr'     => '-',

路由规则定义无需做任何改变，我们就可以访问下面的地址：http://tp5.com/hello-thinkphp

【路由参数】

还可以约束路由规则的请求类型或者URL后缀之类的条件，例如：

?

1

2

3

4

return [

  // 定义路由的请求类型和后缀

  'hello/[:name]' => ['index/hello', ['method' => 'get', 'ext' => 'html']],

];

上面定义的路由规则限制了必须是get请求，而且后缀必须是html的，所以下面的访问地址：

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

【变量规则】

接下来，尝试一些复杂的路由规则定义满足不同的路由变量。在此之前，首先增加一个控制器类如下：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

<?php

namespace 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 . '的归档内容';

  }

}

添加如下路由规则：

?

1

2

3

4

5

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访问的情况

// 访问id为5的内容
http://tp5.com/blog/5 
// 访问name为thinkphp的内容
http://tp5.com/blog/thinkphp 
// 访问2015年5月的归档内容
http://tp5.com/blog/2015/05

 【路由分组】

上面的三个路由规则由于都是blog打头，所以我们可以做如下的简化：

?

1

2

3

4

5

6

7

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做一些特殊的定制，例如如果要同时支持下面的访问地址

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

我们只要稍微改变路由定义规则即可：

?

1

2

3

4

5

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> 这样的非正常规范，我们需要使用<变量名>这样的变量定义方式，而不是 :变量名方式。

简单起见，我们还可以把变量规则统一定义，例如：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

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__中定义的变量规则我们称之为全局变量规则，在路由规则里面定义的变量规则我们称之为局部变量规则，如果一个变量同时定义了全局规则和局部规则的话，当前的局部规则会覆盖全局规则的，例如：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

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地址。

?

1

2

3

4

5

6

7

8

9

// 输出 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来简化

?

1

2

3

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

// 等效于

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

通常在模板文件中输出的话，可以使用助手函数，例如：

?

1

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

如果我们的路由规则发生调整，生成的URL地址会自动变化

如果你配置了url_html_suffix参数的话，生成的URL地址会带上后缀，例如：

?

1

'url_html_suffix'  => 'html',

那么生成的URL地址 类似

?

1

2

blog/thinkphp.html

blog/2015/05.html

如果你的URL地址全部采用路由方式定义，也可以直接使用路由规则来定义URL生成，例如：

?

1

2

3

url('/blog/thinkphp');

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

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

生成方法的第一个参数一定要和路由定义的路由地址保持一致，如果你的路由地址比较特殊，例如使用闭包定义的话，则需要手动给路由指定标识，例如： 

?

1

2

3

4

5

6

7

8

// 添加hello路由标识

Route::rule(['hello','hello/:name'], function($name){

  return 'Hello,'.$name;

});

// 根据路由标识快速生成URL

Url::build('hello', 'name=thinkphp');

// 或者使用

Url::build('hello', ['name' => 'thinkphp']);

router-php:用于简单项目PHP的简单路由器
05-13
BulveyzRouter 非常基本但功能正常的路由器。 它对简单的项目很有用，将有助于快速实现路由系统，因为它非常容易且快速，您可以单独使用它，也可以将其与其他类或模式结合使用。 通过作曲家安装 composer require bulveyz/router-php 使用例 use BulveyzRouter \ Route ; use BulveyzRouter \ Router ; Route :: get ( '/home' , function () { echo "Home" ; }); Route :: any ( '/user/{id}' , function ( $ param ) { echo "User" . $ param -> id ; }); Route :: post ( '/create/post' , 'PostController@store
thinkphp5框架路由原理与用法详解
12-20
本文实例讲述了thinkphp5框架路由原理与用法。分享给大家供大家参考，具体如下： 路由理解 概括的说：路由就是网络请求的url与thinkphp应用层的逻辑处理地址的对应关系。 通俗的说：路由就是把url的请求优雅的对应到...
php 配置路由,路由配置
weixin_29826879的博客
03-26 1301
路由配置在哪里配置位置一：项目配置文件config.php比如：app/web/config.php位置二：公共配置文件config/common.config.php配置格式'router' => array('space' => 'space/index','archive/read' => 'article/index','search' => 'index/sear...
PHP 路由配置
wuxinwudai的专栏
05-06 1158
一、Apache 的路由配置 1、Apache 配置文件httpd.conf 修改目录重写 “AllowOverrideAll”，开启 Apache 模块rewrite_module(mod_rewrite.so) 2、Apache 虚拟主机Vhost开启，即开启 Apache 模块 alias_module(mod_vhost_alias.so),配置 httpd-vhost
PHP的配置路由控制器
凡凡的博客
05-11 911
读取配置参数 echo config（‘配置参数’）； dump(config()); 使用set方法动态设置参数 config ：：set（‘配置参数’，‘配置值’）； 使用路由功能的前提是URL支持PATH_INIFO,并且在项目文件中开启路由。 URL_ROUTE_ON  =>  true  //开启路由 路由的作用是简化URL访问地址。 ‘url_rou
ThinkPHP5 URL与路由详解：入门与实战实例
ThinkPHP 5是一款流行的PHP框架，它提供了...ThinkPHP 5的URL和路由功能使得网站的开发更加高效和灵活，能够有效地组织代码结构，并提供友好的用户访问体验。理解这些核心概念对于使用ThinkPHP构建Web应用至关重要。
thinkPHP5.0框架URL访问方法详解
01-20
本文实例讲述了thinkPHP5.0框架URL访问方法。分享给大家供大家参考，具体如下： URL设计 ThinkPHP5.0在没有启用路由的情况下典型的URL访问规则是： http://serverName/index.php（或者其它应用入口文件）/模块/控制...
php 各种路由分析_php路由与控制器分析
weixin_28801659的博客
03-08 473
php路由与控制器分析路由是指分组从源到目的地时，决定端到端路径的网络范围的进程。下面是小编分享的php路由与控制器分析，一起来看一下吧。我们为什么要使用路由？原因1：一个更漂亮的URI1.URI的改进刚刚开始学PHP时，我们一定写过blog.php?id=1之类的URI，使用GET方式获取参数。这样的URI有两个缺点，一是容易被SQL注射攻击，二是维护性可读性差，大家可以比较下面两种URI哪一种...
PHP-路由（Thinkphp 5）
害怕也得前进
02-20 2095
路由（Thinkphp 5）
php设置路由,windows下设置路由
weixin_35902800的博客
03-21 182
操作网络路由表。ROUTE [-f] [-p] [-4|-6] command [destination][MASK netmask] [gateway] [METRIC metric] [IF interface]-f 清除所有网关项的路由表。如果与某个命令结合使用，在运行该命令前，应清除路由表。-p 与 ADD 命令结合使用时，将路由设置为在系统引导...
php各个框架的路由配置总结
东哥的博客
09-24 993
一、Yii框架的路由配置 首先，取消index.php 这两种方法都是在自动添加index.php 方法一：使用.htaccess 添加.htaccess文件 与index.php同级 RewriteEngine on # if a directory or a file exists, use the request directly RewriteCond %{REQUEST_FILENAM...
PHP路由
InsZVA的专栏
07-09 1340
打造php路由器 1.url重写 apache服务器： 目录下放置.htaccess文件，内容类似下面这样： RewriteEngineOn RewriteRule^(.*)$ index.php?$1 [L] RewriteRule的语法：RewriteRule正则表达式 替换后的内容（这里用$1$2来获得正则匹配的内容）[L]的意义为，匹配改写后不再向下继续匹
php配置路由规则,yaf路由配置规则_PHP教程
weixin_39876856的博客
03-12 173
使用框架的默认路由来访问的时候，会遇到一些困扰，这部分无法查看源代码，只能通过猜测来分析。如果项目有多个模块，显然使用yaf的默认的静态路由是无法满足需求的。yaf默认的配置是着这样的：application.baseUri=”/======Index依次说明一下作用application.baseUri=”/” 这个是说明我们的domain后面就是要解析的内容，如果我们的application是...
php路由原理_PHP路由设置原理
weixin_32259697的博客
03-09 265
0x00 路由实现原理用户通过指定的URL范式对后台进行访问，URL路由处理类进行处理后，转发到逻辑处理类，逻辑处理类将请求结果返回给用户。约定URL范式和规则约定一套自己喜欢的，对搜索引擎友好，对用户友好的URL规则URL处理类对用户请求的URL进行解析处理，获取到用户请求的类，方法，以及Query参数等，并将请求转发给逻辑处理类。逻辑处理类处理网站的真实业务逻辑。0x01 URL范式约定目前来...
ThinkPHP5 ---基础篇(URL和路由)
热门推荐
donglingjiu的博客
06-12 2万+
ThinkPHP5 ---基础篇(URL和路由)  一、入口文件i. 单入口文件:应用程序的所有http请求都由某一个文件接受并有这个文件转发到功能代码中 【public/index.php 传入不同的参数跳转到不同的控制器执行不同的方法实现不同的功能】ii. 优势:1. 只需要在入口文件做安全检测  多入口文件多次检测2. 在入口文件 过滤掉无效请求   多入口文件多次过滤iii. public...
thinkphp 路由
weixin_34375233的博客
05-30 268
路由定义文件 route 定义下的所有的路由文件都是有效的 定义路由必须使用 use think\facade\Route; 复制代码 控制器定义 <?php namespace app\admin\controller; class Index { public function Index($number){ echo $number; } } 复制代...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值