目录 搜索
基础 安装ThinkPHP5.1 开发规范 目录结构 配置基础 架构 路由 控制器 请求 架构总览 入口文件 URL访问 模块设计 命名空间 容器和依赖注入 Facade 钩子和行为 路由定义 变量规则 路由地址 闭包支持 路由参数 跨域请求 注解路由 路由分组 MISS路由 资源路由 快捷路由 路由别名 路由绑定 域名路由 URL生成 控制器定义 前置操作 跳转和重定向 空操作和空控制器 分层控制器 资源控制器 请求对象 输入变量 请求类型 HTTP头信息 伪静态 参数绑定 请求缓存 响应 响应输出 响应参数 重定向 数据库 模型 视图 连接数据库 查询数据 添加数据 更新数据 删除数据 查询表达式 链式操作 where table alias field strict limit page order group having join union distinct lock cache comment fetchSql force partition failException sequence 聚合查询 时间查询 高级查询 视图查询 JSON字段 子查询 原生查询 查询事件 事务操作 监听SQL 存储过程 数据集 分布式数据库 定义 新增 更新 删除 查询 JSON数据字段 获取器 修改器 自动时间戳 只读字段 软删除 类型转换 数据完成 查询范围 模型输出 事件 关联 一对一关联 一对多关联 远程一对多 多对多关联 多态关联 关联预载入 关联统计 关联输出 视图渲染 视图赋值 视图过滤 模板引擎 模板 变量输出 使用函数 运算符 原样输出 模板注释 模板布局 模板继承 包含文件 输出替换 标签库 内置标签 循环标签 比较标签 条件判断 资源文件加载 标签嵌套 原生PHP 定义标签 错误和日志 异常处理 日志处理 调试 验证 杂项 命令行 扩展库 安全和性能 附录 调试模式 性能调试 SQL调试 变量调试 远程调试 验证器 验证规则 错误信息 验证场景 路由验证 内置规则 独立验证 静态调用 表单令牌 缓存 Session Cookie 多语言 分页 上传 自动生成目录结构 创建类库文件 生成类库映射文件 清除缓存文件 生成配置缓存文件 生成数据表字段缓存 生成路由映射缓存 自定义指令 验证码 图像处理 Time 数据库迁移工具 Workerman MongoDb 单元测试 安全建议 优化建议 助手函数 升级指导 更新日志
文字

路由参数

路由分组及规则定义支持指定路由参数,这些参数主要完成路由匹配检测以及行为执行。5.1版本极大改进了路由参数的用法。

路由参数可以在定义路由规则的时候直接传入(批量),不过5.1采用了更加面向对象的方式进行路由参数配置,因此使用方法配置更加清晰。

3~$T)A[59D{X(@I3Q]_J(LG.png

ext和deny_ext参数允许设置为空,分别表示不允许任何后缀以及必须使用后缀访问。

用法举例:

Route::get('new/:id','News/read',['ext'=>'html','https'=>true]);

和使用方法设置(新版推荐的设置方式)等效

Route::get('new/:id', 'News/read')
    ->ext('html')
    ->https();

显然第二种方式更加直观,而且便于IDE的自动提示。

这些路由参数可以混合使用,只要有任何一条参数检查不通过,当前路由就不会生效,继续检测后面的路由规则。

URL后缀

// 定义GET请求路由规则 并设置URL后缀为html的时候有效
Route::get('new/:id', 'News/read')
    ->ext('html');

支持匹配多个后缀,例如:

Route::get('new/:id', 'News/read')
    ->ext('shtml|html');

如果ext方法不传入任何值,表示不允许使用任何后缀访问。

可以设置禁止访问的URL后缀,例如:

// 定义GET请求路由规则 并设置禁止URL后缀为png、jpg和gif的访问
Route::get('new/:id', 'News/read')    
    ->denyExt('jpg|png|gif');

如果denyExt方法不传入任何值,表示必须使用后缀访问。

域名检测

支持使用完整域名或者子域名进行检测,例如:

// 完整域名检测 只在news.thinkphp.cn访问时路由有效
Route::get('new/:id', 'News/read')
    ->domain('news.thinkphp.cn');
// 子域名检测
Route::get('new/:id', 'News/read')
    ->domain('news');

如果需要给子域名定义批量的路由规则,建议使用domain方法进行路由定义。

HTTPS检测

支持检测当前是否HTTPS访问

// 必须使用HTTPS访问
Route::get('new/:id', 'News/read')
    ->https();
    
// 必须使用HTTP访问    
Route::get('new/:id', 'News/read')
    ->https(false);

前置行为检测

支持使用行为对路由进行检测是否匹配,如果行为方法返回false表示当前路由规则无效。

Route::get('user/:id', 'index/User/read')
    ->before(['\app\index\behavior\UserCheck']);

行为类定义如下:

<?php
namespace app\index\behavior;

class UserCheck
{
    public function run()
    {
        if ('user/0' == request()->url()) {
            return false;
        }
    }
}

可以同时使用多个行为进行检测,并且支持使用闭包。

因为前置行为的特殊性,在路由参数的有效性检查后,无论是否最终匹配该路由,都会进行前置行为检查(路由分组的话 会在匹配改分组后 再检查)。

后置行为执行

可以为某个路由或者某个分组路由定义后置行为执行,表示当路由匹配成功后,执行的行为,例如:

Route::get('user/:id', 'User/read')
    ->after(['\app\index\behavior\ReadInfo']);

其中ReadInfo行为类定义如下:

<?php

namespace app\index\behavior;

use app\index\model\User;

class ReadInfo
{
    public function run()
    {
        $id             = request()->route('id');
        app()->user = User::get($id);
    }
}

如果成功匹配到new/:id路由后,就会执行行为类的run方法,参数是路由地址,可以动态改变。同样,后置行为也支持传入闭包。

合并额外参数

通常用于完整匹配的情况,如果有额外的参数则合并作为变量值,例如:

Route::get('new/:name$', 'News/read')
    ->mergeExtraVars();
http://serverName/new/thinkphp/hello

会被匹配到,并且name变量的值为 thinkphp/hello。

路由绑定模型

路由规则和分组支持绑定模型数据,例如:

Route::get('hello/:id', 'index/index/hello')
    ->model('id', '\app\index\model\User');

会自动给当前路由绑定 id为 当前路由变量值的User模型数据。

默认情况下,如果没有查询到模型数据,则会抛出异常,如果不希望抛出异常,可以使用

Route::rule('hello/:id', 'index/index/hello')
    ->model('id', '\app\index\model\User', false);

可以定义模型数据的查询条件,例如:

Route::rule('hello/:name/:id', 'index/index/hello')
    ->model('id&name', '\app\index\model\User');

表示查询id和name的值等于当前路由变量的模型数据。

也可以使用闭包来自定义返回需要的模型对象

Route::rule('hello/:id', 'index/index/hello')
    ->model(function ($param) {
        $model = new \app\index\model\User;
        return $model->where($param)->find();
    });

闭包函数的参数就是当前请求的URL变量信息。

绑定的模型可以直接在控制器的架构方法或者操作方法中自动注入,具体可以参考请求章节的依赖注入。

缓存路由请求

可以对当前的路由请求进行缓存处理,例如:

Route::get('new/:name$', 'News/read')
    ->cache(3600);

表示对当前路由请求缓存3600秒,更多内容可以参考请求缓存一节。

设置Header信息

Route::get('new/:name$', 'News/read')
    ->header('Access-Control-Allow-Origin','*');

header方法支持多次调用。

或者使用数组方式批量设置

Route::get('new/:name$', 'News/read')
    ->header([
    	'Access-Control-Allow-Origin'=>'*',
        'Access-Control-Allow-Methods' => 'GET, POST, PATCH, PUT, DELETE',
    ]);

当路由匹配后,会自动设置本次请求的Response响应对象的Header信息。

响应输出设置

可以调用response方法给路由或者分组绑定响应输出参数,例如:

Route::get('hello/:id', 'index/index/hello')->response([
    '\app\index\behavior\Json',
]);

行为类定义如下:

namespace app\index\behavior;

class Json 
{
    public function run($response)
    {
    	// 调用Response类的方法进行设置
    	$response->contentType('application/json');
    }
}

如果不希望使用行为,可以直接使用闭包

Route::get('hello/:id', 'index/index/hello')->response(function($response){
    	$response->contentType('application/json');
});

如果要给某个路由返回单独的响应对象,也可以使用

Route::get('hello/:id', function () {
    return json('hello,world!');
});

全局路由参数

可以直接进行全局的路由参数设置,例如在路由定义文件中使用

Route::option('ext','html')->option('cache', 600);

表示全局路由都使用html后缀以及600秒的请求缓存。

动态参数

如果你需要额外自定义一些路由参数,可以使用下面的方式:

Route::get('new/:name$', 'News/read')
    ->option('rule','admin');

或者使用动态方法

Route::get('new/:name$', 'News/read')
    ->rule('admin');

在后续的路由行为后可以调用该路由的rule参数来进行权限检查。


上一篇: 下一篇: