ThinkPHP5.0完全开发手册

D:\phpstudy\WWW\video\public>php -S localhost:8080 router.php

资源路由

5.0支持设置RESTFul请求的资源路由，方式如下：

Route::resource('blog','index/blog');

或者在路由配置文件中使用__rest__添加资源路由定义：

return [
    // 定义资源路由
    '__rest__'=>[
        // 指向index模块的blog控制器
        'blog'=>'index/blog',
    ],
    // 定义普通路由
    'hello/:id'=>'index/hello',
]

设置后会自动注册7个路由规则，如下：

标识	请求类型	生成路由规则	对应操作方法（默认）
index	GET	`blog`	index
create	GET	`blog/create`	create
save	POST	`blog`	save
read	GET	`blog/:id`	read
edit	GET	`blog/:id/edit`	edit
update	PUT	`blog/:id`	update
delete	DELETE	`blog/:id`	delete

读取配置参数

设置完配置参数后，就可以使用get方法读取配置了，例如：

echo Config::get('配置参数1');

系统定义了一个助手函数config，以上可以简化为：

echo config('配置参数1');

读取所有的配置参数：

dump(Config::get());
 // 或者 dump(config());

或者你需要判断是否存在某个设置参数：

Config::has('配置参数2');
// 或者 config('?配置参数2');

如果需要读取二级配置，可以使用：

echo Config::get('配置参数.二级参数');
echo config('配置参数.二级参数');

上传文件

ThinkPHP5.0对文件上传的支持更加简单。

内置的上传只是上传到本地服务器，上传到远程或者第三方平台的话需要自己扩展。

假设表单代码如下：

<form action="/index/index/upload" enctype="multipart/form-data" method="post">
<input type="file" name="image" /> <br> 
<input type="submit" value="上传" /> 
</form>

然后在控制器中添加如下的代码：

public function upload(){
    // 获取表单上传文件 例如上传了001.jpg
    $file = request()->file('image');
    
    // 移动到框架应用根目录/public/uploads/ 目录下
    if($file){
        $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
        if($info){
            // 成功上传后 获取上传信息
            // 输出 jpg
            echo $info->getExtension();
            // 输出 20160820/42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getSaveName();
            // 输出 42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getFilename(); 
        }else{
            // 上传失败获取错误信息
            echo $file->getError();
        }
    }
}
//move方法成功的话返回的是一个\think\File对象，你可以对上传后的文件进行后续操作

多文件上传

如果你使用的是多文件上传表单，例如：

<form action="/index/index/upload" enctype="multipart/form-data" method="post">
<input type="file" name="image[]" /> <br> 
<input type="file" name="image[]" /> <br> 
<input type="file" name="image[]" /> <br> 
<input type="submit" value="上传" /> 
</form>

控制器代码可以改成：

public function upload(){
    // 获取表单上传文件
    $files = request()->file('image');
    foreach($files as $file){
        // 移动到框架应用根目录/public/uploads/ 目录下
        $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
        if($info){
            // 成功上传后 获取上传信息
            // 输出 jpg
            echo $info->getExtension(); 
            // 输出 42a79759f284b767dfcb2a0197904287.jpg
            echo $info->getFilename(); 
        }else{
            // 上传失败获取错误信息
            echo $file->getError();
        }    
    }
}

上传验证

支持对上传文件的验证，包括文件大小、文件类型和后缀：

public function upload(){
    // 获取表单上传文件 例如上传了001.jpg
    $file = request()->file('image');
    // 移动到框架应用根目录/public/uploads/ 目录下
    $info = $file->validate(['size'=>15678,'ext'=>'jpg,png,gif'])->move(ROOT_PATH . 'public' . DS . 'uploads');
    if($info){
        // 成功上传后 获取上传信息
        // 输出 jpg
        echo $info->getExtension();
        // 输出 20160820/42a79759f284b767dfcb2a0197904287.jpg
        echo $info->getSaveName();
        // 输出 42a79759f284b767dfcb2a0197904287.jpg
        echo $info->getFilename(); 
    }else{
        // 上传失败获取错误信息
        echo $file->getError();
    }
}
//getSaveName方法返回的是图片的服务器文件地址，并不能直接用于图片的URL地址，尤其在windows平台上必须做转换才能正常显示图片。

//如果上传文件验证不通过，则move方法返回false。

路由模式

二、混合模式

开启路由，并使用路由定义+默认PATH_INFO方式的混合：

'url_route_on'  =>  true,
'url_route_must'=>  false,

该方式下面，只需要对需要定义路由规则的访问地址定义路由规则，其它的仍然按照第一种普通模式的PATH_INFO模式访问URL。

三、强制模式

开启路由，并设置必须定义路由才能访问：

'url_route_on'  		=>  true,
'url_route_must'		=>  true,

这种方式下面必须严格给每一个访问地址定义路由规则（包括首页），否则将抛出异常。

首页的路由规则采用/定义即可，例如下面把网站首页路由输出Hello,world!

Route::get('/',function(){
    return 'Hello,world!';
});

验证

概述

ThinkPHP5.0验证使用独立的\think\Validate类或者验证器进行验证。

独立验证

任何时候，都可以使用Validate类进行独立的验证操作，例如：

$validate = new Validate([
    'name'  => 'require|max:25',
    'email' => 'email'
]);
$data = [
    'name'  => 'thinkphp',
    'email' => 'thinkphp@qq.com'
];
if (!$validate->check($data)) {
    dump($validate->getError());
}

验证器

这是5.0推荐的验证方式，为具体的验证场景或者数据表定义好验证器类，直接调用验证类的check方法即可完成验证，下面是一个例子：

我们定义一个\app\index\validate\User验证器类用于User的验证。

<?php

namespace app\index\validate;

use think\Validate;

class User extends Validate

{

　　protected $rule = [

'name' => 'checkName:thinkphp',

'age' => 'number|between:1,120',

'email' => 'email',

];

protected $message = [

'name.require' => '名称必须',

'name.max' => '名称最多不能超过25个字符',

'age.number' => '年龄必须是数字',

'age.between' => '年龄只能在1-120之间',

'email' => '邮箱格式错误',

];

　　protected $scene = [

'index' =>['start_time','end_time'],//表示验证index场景（该场景定义只需要验证start_time和end_time字段） //然后再需要验证的地方直接使用 scene 方法验证 $result = $validate->scene('index')->check($data);

'save' => ['status', 'customer_id' , 'bill_date', 'depot_id', 'cargoes'],

'update' => ['status', 'customer_id', 'bill_date', 'depot_id', 'cargoes'],

];

// 自定义验证规则

//验证方法可以传入的参数共有5个（后面三个根据情况选用），依次为：

//验证数据当前字段的值

//验证规则

//全部数据（数组）

//字段名

//字段描述

protected function checkName($value,$rule,$data)

{

return $rule == $value ? true : '名称错误';

}

//在需要进行User验证的地方，添加如下代码即可：

$data = [

'name'=>'thinkphp',

'email'=>'thinkphp@qq.com'

];

//$validate = Loader::validate('User');

//或者使用助手函数实例化验证器

$validate = validate('User');

if(!$validate->check($data)){

　　dump($validate->getError());

}

静态调用验证

如果需要使用内置的规则验证单个数据，可以使用静态调用的方式。

// 日期格式验证
Validate::dateFormat('2016-03-09','Y-m-d'); // true
// 验证是否有效的日期
Validate::is('2016-06-03','date'); // true
// 验证是否有效邮箱地址
Validate::is('thinkphp@qq.com','email'); // true
// 验证是否在某个范围
Validate::in('a',['a','b','c']); // true
// 验证是否大于某个值
Validate::gt(10,8); // true
// 正则验证
Validate::regex(100,'\d+'); // true

系统内置的验证规则如下：

格式验证类

require

验证某个字段必须，例如：

'name'=>'require'

number 或者 integer

验证某个字段的值是否为数字（采用filter_var验证），例如：

'num'=>'number'

float

验证某个字段的值是否为浮点数字（采用filter_var验证），例如：

'num'=>'float'

boolean

验证某个字段的值是否为布尔值（采用filter_var验证），例如：

'num'=>'boolean'

email

验证某个字段的值是否为email地址（采用filter_var验证），例如：

'email'=>'email'

array

验证某个字段的值是否为数组，例如：

'info'=>'array'

accepted

验证某个字段是否为为 yes, on, 或是 1。这在确认"服务条款"是否同意时很有用，例如：

'accept'=>'accepted'

date

验证值是否为有效的日期，例如：

'date'=>'date'

会对日期值进行strtotime后进行判断。

alpha

验证某个字段的值是否为字母，例如：

'name'=>'alpha'

alphaNum

验证某个字段的值是否为字母和数字，例如：

'name'=>'alphaNum'

alphaDash

验证某个字段的值是否为字母和数字，下划线_及破折号-，例如：

'name'=>'alphaDash'

chs

验证某个字段的值只能是汉字，例如：

'name'=>'chs'

chsAlpha

验证某个字段的值只能是汉字、字母，例如：

'name'=>'chsAlpha'

chsAlphaNum

验证某个字段的值只能是汉字、字母和数字，例如：

'name'=>'chsAlphaNum'

chsDash

验证某个字段的值只能是汉字、字母、数字和下划线_及破折号-，例如：

'name'=>'chsDash'

activeUrl

验证某个字段的值是否为有效的域名或者IP，例如：

'host'=>'activeUrl'

url

验证某个字段的值是否为有效的URL地址（采用filter_var验证），例如：

'url'=>'url'

ip

验证某个字段的值是否为有效的IP地址（采用filter_var验证），例如：

'ip'=>'ip'

支持验证ipv4和ipv6格式的IP地址。

dateFormat:format

验证某个字段的值是否为指定格式的日期，例如：

'create_time'=>'dateFormat:y-m-d'

长度和区间验证类

in

验证某个字段的值是否在某个范围，例如：

'num'=>'in:1,2,3'

notIn

验证某个字段的值不在某个范围，例如：

'num'=>'notIn:1,2,3'

between

验证某个字段的值是否在某个区间，例如：

'num'=>'between:1,10'

notBetween

验证某个字段的值不在某个范围，例如：

'num'=>'notBetween:1,10'

length:num1,num2

验证某个字段的值的长度是否在某个范围，例如：

'name'=>'length:4,25'

或者指定长度

'name'=>'length:4'

如果验证的数据是数组，则判断数组的长度。
如果验证的数据是File对象，则判断文件的大小。

max:number

验证某个字段的值的最大长度，例如：

'name'=>'max:25'

如果验证的数据是数组，则判断数组的长度。
如果验证的数据是File对象，则判断文件的大小。

min:number

验证某个字段的值的最小长度，例如：

'name'=>'min:5'

如果验证的数据是数组，则判断数组的长度。
如果验证的数据是File对象，则判断文件的大小。

after:日期

验证某个字段的值是否在某个日期之后，例如：

'begin_time' => 'after:2016-3-18',

before:日期

验证某个字段的值是否在某个日期之前，例如：

'end_time'   => 'before:2016-10-01',

expire:开始时间,结束时间

验证当前操作（注意不是某个值）是否在某个有效日期之内，例如：

'expire_time'   => 'expire:2016-2-1,2016-10-01',

allowIp:allow1,allow2,...

验证当前请求的IP是否在某个范围，例如：

'name'   => 'allowIp:114.45.4.55',

该规则可以用于某个后台的访问权限

denyIp:allow1,allow2,...

验证当前请求的IP是否禁止访问，例如：

'name'   => 'denyIp:114.45.4.55',

字段比较类

confirm

验证某个字段是否和另外一个字段的值一致，例如：

'repassword'=>'require|confirm:password'

5.0.4+版本开始，增加了字段自动匹配验证规则，如password和password_confirm是自动相互验证的，只需要使用

'password'=>'require|confirm'

会自动验证和password_confirm进行字段比较是否一致，反之亦然。

different

验证某个字段是否和另外一个字段的值不一致，例如：

'name'=>'require|different:account'

eq 或者 = 或者 same

验证是否等于某个值，例如：

'score'=>'eq:100'
'num'=>'=:100'
'num'=>'same:100'

egt 或者 >=

验证是否大于等于某个值，例如：

'score'=>'egt:60'
'num'=>'>=:100'

gt 或者 >

验证是否大于某个值，例如：

'score'=>'gt:60'
'num'=>'>:100'

elt 或者 <=

验证是否小于等于某个值，例如：

'score'=>'elt:100'
'num'=>'<=:100'

lt 或者 <

验证是否小于某个值，例如：

'score'=>'lt:100'
'num'=>'<:100'

验证字段比较支持对比其他字段（V5.0.8+）

验证对比其他字段大小（数值大小对比），例如：

'price'=>'lt:market_price'
'price'=>'<:market_price'

filter验证

支持使用filter_var进行验证，例如：

'ip'=>'filter:validate_ip'

正则验证

支持直接使用正则验证，例如：

'zip'=>'\d{6}',
// 或者
'zip'=>'regex:\d{6}',

如果你的正则表达式中包含有|符号的话，必须使用数组方式定义。

'accepted'=>['regex'=>'/^(yes|on|1)$/i'],

也可以实现预定义正则表达式后直接调用，例如在验证器类中定义regex属性

    protected $regex = [ 'zip' => '\d{6}'];

然后就可以使用

'zip'	=>	'regex:zip',

上传验证

file

验证是否是一个上传文件

image:width,height,type

验证是否是一个图像文件，width height和type都是可选，width和height必须同时定义。

fileExt:允许的文件后缀

验证上传文件后缀

fileMime:允许的文件类型

验证上传文件类型

fileSize:允许的文件字节大小

验证上传文件大小

行为验证

使用行为验证数据，例如：

'data'=>'behavior:\app\index\behavior\Check'

其它验证

unique:table,field,except,pk

版本	调整功能
5.0.5	支持指定完整模型类并且默认会优先检测模型类是否存在不存在则检测数据表

验证当前请求的字段值是否为唯一的，例如：

// 表示验证name字段的值是否在user表（不包含前缀）中唯一
'name'   => 'unique:user',
// 验证其他字段
'name'   => 'unique:user,account',
// 排除某个主键值
'name'   => 'unique:user,account,10',
// 指定某个主键值排除
'name'   => 'unique:user,account,10,user_id',

如果需要对复杂的条件验证唯一，可以使用下面的方式：

// 多个字段验证唯一验证条件
'name'   => 'unique:user,status^account',
// 复杂验证条件
'name'   => 'unique:user,status=1&account='.$data['account'],

requireIf:field,value

验证某个字段的值等于某个值的时候必须，例如：

// 当account的值等于1的时候 password必须
'password'=>'requireIf:account,1'

requireWith:field

验证某个字段有值的时候必须，例如：

// 当account有值的时候password字段必须
'password'=>'requireWith:account'

posted @ 2020-03-11 10:20 xiondun 阅读(2059) 评论(0) 编辑收藏举报

刷新页面返回顶部

xiondun

ThinkPHP5.0完全开发手册

D:\phpstudy\WWW\video\public>php -S localhost:8080 router.php

资源路由

读取配置参数

上传文件

多文件上传

上传验证

路由模式

二、混合模式

三、强制模式

验证

概述

独立验证

验证器

静态调用验证

系统内置的验证规则如下：

格式验证类

require

number 或者 integer

float

boolean

email

array

accepted

date

alpha

alphaNum

alphaDash

chs

chsAlpha

chsAlphaNum

chsDash

activeUrl

url

ip

dateFormat:format

长度和区间验证类

in

notIn

between

notBetween

length:num1,num2

max:number

min:number

after:日期

before:日期

expire:开始时间,结束时间

allowIp:allow1,allow2,...

denyIp:allow1,allow2,...

字段比较类

confirm

different

eq 或者 = 或者 same

egt 或者 >=

gt 或者 >

elt 或者 <=

lt 或者 <

验证字段比较支持对比其他字段（V5.0.8+）

filter验证

正则验证

上传验证

file

image:width,height,type

fileExt:允许的文件后缀

fileMime:允许的文件类型

fileSize:允许的文件字节大小

行为验证

其它验证

unique:table,field,except,pk

requireIf:field,value

requireWith:field

公告