过滤器
什么是过滤器
过滤器是控制器动作执行之前或之后需要执行的代码。该代码以对象的形式执行,则应该使用类的方式定义并申明。
过滤器本质上是一种特殊的行为。
为什么使用过滤器
通常情况下,过滤器将代码绑定到所有的操作上,也就是说,每一个操作的执行,都需要先或后执行过滤器,所以,可以用来执行权限检测、缓存处理等事情
在哪里使用过滤器
在控制器中,定义:
public function behaviors(){
}
过滤器详解
==behaviors()方法返回一个数组,类似于配置文件==
数组内的每一个元素也应该是一个数组,表示一个过滤器
如:
Public function behaviors(){
Return [
[
‘class’ => ‘实现类’,
]
];
}
表示定义了一个过滤器
过滤器的位置
Yii2为开发者定义了很多的过滤器,可以直接拿过来使用。
定义过滤器
在Yii2中,自定义过滤器,需要继承 yii\base\ActionFilter 类并覆盖 yii\base\ActionFilter::beforeAction() 和/或 yii\base\ActionFilter::afterAction() 方法来创建动作的过滤器
定义在beforeAction()中的代码会在操作执行之前执行
定义在afterAction()中的代码会在操作执行之后执行
如:创建一个过滤器,记录操作执行的时间
首先应该创建一个过滤器,比如在frontend 应用中创建一个 filters目录,专门用来存储过滤器,然后创建TimeFilter.php文件过滤器通常使用Filter.php作为文件后缀,而文件中应该有一个和文件名一样的类
然后覆盖基础过滤器的 beforeAction 和 afterAction
在beforAction中,如果返回true表示放行,操作继续执行,如果返回false,表示停止,操作不再执行。
加载过滤器
需要注意的问题:
==定义过滤器内的beforeAction 和 afterAction ,必须返回父类的方法。
Return parent::beforeAction($action)==
错误处理
- 凡是非致命错误都以异常的形式抛出,是可以捕获的
- 错误处理器是以组件的形式配置在main中的
- 错误响应的格式是可以选择的,有ajax或者html或者纯文本
- 响应错误的方法是可以自己定义的
错误组件的实质类是yii\web\ErrorHandle其他的配置参数可以去该类中查看public属性
Session的使用
Cookie的使用
//获取cookie的对象
$getCookieObj = Yii::$app->request->cookies;
//设置cookie的对象
$setCookieObj = Yii::$app->response->cookies;
/**
* 添加cookie
* 注意:
* 使用add来添加add的参数必须是yii\web\Cookie对象
*/
$setCookieObj->add(new Cookie([
'name' => 'tel',
'value' => '15730436354',
'expire' => time()+20
]));
/**
* 获取值时有三种方法
*/
//获取的是cookie的值
var_dump($getCookieObj->getValue('tel', '00000'));
//获取的是对象
var_dump($getCookieObj->get('tel'));
//获取的是对象
var_dump($getCookieObj['tel']);
文件上传
在Yii里上传文件通常使用yii\web\UploadedFile类, 它把每个上传的文件封装成 UploadedFile 对象。 结合yii\widgets\ActiveForm和models,你可以轻松实现安全的上传文件机制
创建模型
和普通的文本输入框一样,创建一个models里的属性,表示一个字段,然后完善验证规则即可
创建控制器,实例化表单模型和渲染视图
视图中使用ActiveForm创建表单元素
在控制器中接收表单数据并绑定数据到表单模型
注意:要调用上传功能,需要打开 php_fileinfo 扩展
uploads目录应该在入口文件同级目录
多文件上传
Yii2支持多文件上传,只需要在上面的例子中加入一些小的修改即可
修改表单模型
在验证中加入 maxFiles 配置表示最多可以上传多少个文件
修改表单模型的upload 方法
如果是多文件上传,这里的$this->imageFile 就会是一个数组,所以可以使用foreach来进行文件保存
视图文件修改
需要传入多个文件,就需要在表单name属性加上[] 再加上multiple属性
控制器修改
控制器接收多个文件,应该使用UploadedFile 里的getInstances方法来绑定属性
验证码
Yii2中的验证码是通过扩展的操作来实现的,叫做
yii\captcha\CaptchaAction
只需要将它绑定到actions中就可以直接访问,无需任何更改:
可配置的验证码属性
由于验证码是一个公共操作,我们可以很轻松的找到它的实现类。实现类中的各种属性都可以被认为是可配置的属性
如:
public $width=120;
还可以设置:
height: 高度
backColor: 背景色
foreColor 文字颜色
minLength 最小长度(文字字数)
maxLength 最大长度
fontFile 字体文件
.....
在视图中使用验证码
使用widget()方法来调用验证码模块,并且指定显示的DOM结构
{image} 表示显示验证码图片
{input} 显示验证码输入框
验证验证码
验证码在填写完成之后,还需要使用验证机制来完成验证码的验证,在Yii2中,不需要自己去写验证,直接在表单模型的 rules 中调用 captcha 验证就可以了
['verifyCode','captcha'],
数据分页
Yii2也提供了类似于TP的数据分页类:
\yii\data\Pagination
要使用它,需要先进行实例化:
实例化的时候,需要传入数据的总条数和每页显示的条数
控制器中操作
public function actionList()
{
//获取页码,参数需和Pagination中配置的参数一致
$page=Yii::$app->request->get("page");
$page=($page-1)>0?($page-1):0;
$pageSize=5;
//设置分页配置
$config=[
'totalCount' => User::find()->count(),
'defaultPageSize' => $pageSize,
'pageParam' => 'page',
];
//实例化分页器,将配置参数传入到Pagination中
$paginationObj = new Pagination($config);
$rows =User::find()->asArray()->offset($page*$pageSize)->limit($pageSize)->all();
return $this->render('list',[
'rows'=>$rows,
'pagebar' => $paginationObj
]);
}
视图中操作
在视图中要显示分页,要使用到LinkPager 小部件
使用方法:
<?=\yii\widgets\LinkPager::widget([
'pagination' => $pagebar
]) ?>
需要传入一个 pagination 对象,也就是 $pages;