thinkphp5 URL 및 라우팅 기능에 대한 자세한 설명과 예시

이 글에서는 thinkphp5 URL과 라우팅의 기능적 세부 사항과 예시를 주로 소개하고 참고용으로 제공합니다. 함께 살펴보겠습니다

앞서 말한 내용

이 글에서는 thinkphp5URL과 라우팅을 자세히 소개하겠습니다

URL 액세스

ThinkPHP는 단일 입력 모드를 사용하여 애플리케이션에 액세스하고 애플리케이션에 대한 모든 요청을 사용합니다. 시스템은 URL 매개변수에서 현재 요청된 모듈, 컨트롤러 및 작업을 구문 분석합니다. 다음은 표준 URL 액세스 형식입니다.

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

여기서 index.php는 항목 파일입니다. (항목 파일은 숨겨질 수 있으므로 나중에 언급할 예정입니다.)

ThinkPHP에서 모듈의 개념은 실제로 응용 프로그램 디렉터리 아래의 하위 디렉터리이며 공식 사양에서는 디렉터리 이름이 소문자이므로 모듈은 URL 대소문자 변환이 켜져 있는지 여부에 관계없이 모두 소문자로 명명되며 모듈 이름은 강제로 소문자로 지정됩니다.

응용 프로그램의 인덱스 모듈의 인덱스 컨트롤러는 다음과 같이 정의됩니다.

<?php
namespace app\index\controller;
class Index
{
  public function index()
  {
    return &#39;index&#39;;
  }
  public function hello($name = &#39;World&#39;)
  {
    return &#39;Hello,&#39; . $name . &#39;!&#39;;
  }
}

If 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

Access URL 주소 뒤의 페이지 출력은 다음과 같습니다.

Hello, thinkphp!

Since the 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 컨트롤러(애플리케이션 /index/controller/HelloWorld.php)를 정의합니다.

<?php
namespace app\index\controller;
class HelloWorld
{
  public function index($name = &#39;World&#39;)
  {
    return &#39;Hello,&#39; . $name . &#39;!&#39;;
  }
}

올바른 URL 액세스 주소(주소는 url 메소드를 사용하여 생성 가능)는

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

이어야 합니다. 시스템은 작업을 위해 HelloWorld 컨트롤러 클래스를 자동으로 찾습니다

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

를 사용하면 오류가 보고되고 HelloWorld 컨트롤러 클래스가 존재하지 않는다는 메시지가 표시됩니다.

엄격한 대소문자 구분 액세스를 원하는 경우 (컨트롤러 액세스에 카멜 케이스를 지원할 수 있도록) 애플리케이션 구성 파일에서 설정할 수 있습니다:

// 关闭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의 매개변수를 자동으로 얻을 수 있습니다. 여전히 위와 같습니다. 컨트롤러를 예로 들면 컨트롤러 코드는 다음과 같습니다.

<?php
namespace app\index\controller;
class Index
{
  public function index()
  {
    return &#39;index&#39;;
  }
  public function hello($name = &#39;World&#39;)
  {
    return &#39;Hello,&#39; . $name . &#39;!&#39;;
  }
}

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

를 방문하면 hello에 액세스합니다. appindexcontrollerIndex 컨트롤러 클래스 메소드의 매개변수가 전달되지 않으므로 name 매개변수는 기본값인 World를 사용합니다. name 매개변수가 전달되면 다음을 사용하세요.

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

페이지 출력 결과는 다음과 같습니다.

Hello, thinkphp!

Now hello 이 메소드는 두 번째 매개변수를 추가합니다:

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

페이지 출력 결과입니다. is:

Hello, thinkphp! 당신은 상하이에서 왔습니다.

hello 메소드가 메소드의 매개변수 값과 동일한 이름의 매개변수 값을 자동으로 가져오는 것을 볼 수 있습니다. 매개변수가 전달되면 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 매개변수 값은 다음과 같이 수정됩니다.

现在，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文件（官方默认自带了该文件），内容如下

<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，规则如下：

<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文件：

<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中添加：

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

定义路由

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

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

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

将发生错误

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

return [
  // 路由参数name为可选
  'hello/[:name]' => 'index/hello',
];

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

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

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

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

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

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

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

【完整匹配】

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

return [
  // 路由参数name为可选
  'hello/[:name]$' => 'index/hello',
];

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

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

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

【闭包定义】

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

return [
  // 定义闭包
  'hello/[:name]' => function ($name) {
    return 'Hello,' . $name . '!';
  },
];

或者

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）中设置：

// 设置pathinfo分隔符
'pathinfo_depr'     => '-',

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

【路由参数】

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

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 // 有效

【变量规则】

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

<?php
namespace app\index\controller;
class Blog
{
  public function get($id)
  {
    return &#39;查看id=&#39; . $id . &#39;的内容&#39;;
  }
  public function read($name)
  {
    return &#39;查看name=&#39; . $name . &#39;的内容&#39;;
  }
  public function archive($year, $month)
  {
    return &#39;查看&#39; . $year . &#39;/&#39; . $month . &#39;的归档内容&#39;;
  }
}

添加如下路由规则：

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打头，所以我们可以做如下的简化：

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

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

return [
  'blog/:id'      => ['blog/get', ['method' => 'get'], ['id' => '\d+']],
  'blog/:name'     => ['blog/read', ['method' => 'get'], ['name' => '\w+']],
  &#39;blog-<year>-<month>&#39; => [&#39;blog/archive&#39;, [&#39;method&#39; => &#39;get&#39;], [&#39;year&#39; => &#39;\d{4}&#39;, &#39;month&#39; => &#39;\d{2}&#39;]],
];

对 blog-4620f01c9fab72e23a9b679732106cc4-e43ddfe88b0c33e4d0d4a6906a4e933c 这样的非正常规范，我们需要使用e78ad71b8a45d2a3209df4d26f1fcfa6这样的变量定义方式，而不是 :变量名方式。

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

return [
  // 全局变量规则定义
  '__pattern__'     => [
    'name' => '\w+',
    'id'  => '\d+',
    'year' => '\d{4}',
    'month' => '\d{2}',
  ],
  // 路由规则定义
  'blog/:id'      => 'blog/get',
  'blog/:name'     => 'blog/read',
  &#39;blog-<year>-<month>&#39; => &#39;blog/archive&#39;,
];

在__pattern__中定义的变量规则我们称之为全局变量规则，在路由规则里面定义的变量规则我们称之为局部变量规则，如果一个变量同时定义了全局规则和局部规则的话，当前的局部规则会覆盖全局规则的，例如：

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,}']],
  &#39;blog-<year>-<month>&#39; => &#39;blog/archive&#39;,
];

URL生成

定义路由规则之后，可以通过Url类来方便的生成实际的URL地址（路由地址），针对上面的路由规则，我们可以用下面的方式生成URL地址。

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

url('blog/read', 'name=thinkphp');
// 等效于
Url::build('blog/read', 'name=thinkphp');

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

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

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

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

'url_html_suffix'  => 'html',

那么生成的URL地址 类似

blog/thinkphp.html 
blog/2015/05.html

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

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

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

// 添加hello路由标识
Route::rule(['hello','hello/:name'], function($name){
  return 'Hello,'.$name;
});
// 根据路由标识快速生成URL
Url::build('hello', 'name=thinkphp');
// 或者使用
Url::build('hello', ['name' => 'thinkphp']);

相关推荐：

PHP使用Curl实现模拟登录及抓取数据功能示例

위 내용은 thinkphp5 URL 및 라우팅 기능에 대한 자세한 설명과 예시의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!