ThinkPHP5.0完全开发手册

D:phpstudyWWWvideopublic>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方法成功的话返回的是一个	hinkFile对象，你可以对上传后的文件进行后续操作

多文件上传

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

<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验证使用独立的 hinkValidate类或者验证器进行验证。

独立验证

任何时候，都可以使用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方法即可完成验证，下面是一个例子：

我们定义一个appindexvalidateUser验证器类用于User的验证。

<?php
namespace appindexvalidate;


use thinkValidate;










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:appindexehaviorCheck'

其它验证

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'