Browse Tag: php

yii2 行为

behavior 是 yii\base\Behavior 或其子类的实例, behavior，可以无须改变类继承关系即可增强一个已有的 yii\base\Component 类功能。当行为附加到组件后，它将“注入”它的方法和属性到组件，然后可以像访问组件内定义的方法和属性一样访问它们。 此外，行为通过组件能响应被触发的事件, 从而自定义或调整组件正常执行的代码。

定义行为

~/yiint/components/MyBehavior.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
<?php
/**
* 自定义行为，用于行为功能的演示
*/
 
namespace app\components;
 
use yii\base\Behavior;
 
/**
* 行为 演示
*/
class MyBehavior extends Behavior
{
    public $prop1;
 
    private $_prop2;
 
    public function getProp2()
    {
        return $this->_prop2;
    }
 
    public function setProp2($value)
    {
        $this->_prop2 = $value;
    }
 
    public function foo()
    {
        // ...
    }
}
 

以上代码定义了行为类 @app\components\MyBehavior 并为要附加行为的组件提供了两个属性 prop1 、 prop2 和一个方法 foo()。

附加行为

静态附加行为

覆写行为要附加的组件类的 yii\base\Component::behaviors() 方法, 返回行为配置列表。

每个行为配置格式:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
return [
    // 匿名行为，只有行为类名
    MyBehavior::className(),
 
    // 通过指定行为配置数组相应的键可以给行为关联一个名称, 这种行为称为命名行为
    // 命名行为，只有行为类名
    'myBehavior2' => MyBehavior::className(),
 
    // 匿名行为，配置数组
    [
        'class' => MyBehavior::className(),
        'prop1' => 'value1',
        'prop2' => 'value2',
    ],
 
    // 命名行为，配置数组
    'myBehavior4' => [
        'class' => MyBehavior::className(),
        'prop1' => 'value1',
        'prop2' => 'value2',
    ]
];
 

动态附加行为

在对应组件里调用 yii\base\Component::attachBehavior() 方法

1
2
3
4
5
6
7
8
9
10
11
12
13
// 附加行为对象
$component->attachBehavior('myBehavior1', new MyBehavior);
 
// 附加行为类
$component->attachBehavior('myBehavior2', MyBehavior::className());
 
// 附加配置数组
$component->attachBehavior('myBehavior3', [
    'class' => MyBehavior::className(),
    'prop1' => 'value1',
    'prop2' => 'value2',
]);
 

可以通过 yii\base\Component::attachBehaviors() 方法一次附加多个行为：

1
2
3
4
5
$component->attachBehaviors([
    'myBehavior1' => new MyBehavior,  // 命名行为
    MyBehavior::className(),          // 匿名行为
]);
 

使用行为

将behavior 附加到 yii\base\Component 类或其子类后就可以直接使用它。

1
2
3
4
5
6
// "prop1" 是定义在行为类的属性
echo $component->prop1;
$component->prop1 = $value;
// foo() 是定义在行为类的公共方法
$component->foo();
 

行为对象

附加行为到组件时的命名行为， 可以使用这个名称来访问行为对象

1
2
3
4
5
$behavior = $component->getBehavior('myBehavior');
 
// 获取附加到这个组件的所有行为：
$behaviors = $component->getBehaviors();
 

移除行为

要移除行为，可以调用 yii\base\Component::detachBehavior() 方法用行为相关联的名字实现：

1
2
3
4
$component->detachBehavior('myBehavior1');
// 移除全部行为：
$component->detachBehaviors();
 

使用 TimestampBehavior

yii\behaviors\TimestampBehavior 行为支持在 yii\db\ActiveRecord 存储时自动更新它的时间戳属性。

首先，附加这个行为到计划使用该行为的 yii\db\ActiveRecord 类：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
namespace app\models\User;
 
use yii\db\ActiveRecord;
use yii\behaviors\TimestampBehavior;
 
class User extends ActiveRecord
{
    // ...
 
    public function behaviors()
    {
        return [
            [
                'class' => TimestampBehavior::className(),
                'attributes' => [
                    ActiveRecord::EVENT_BEFORE_INSERT => ['created_at', 'updated_at'],
                    ActiveRecord::EVENT_BEFORE_UPDATE => ['updated_at'],
                ],
                // if you're using datetime instead of UNIX timestamp:
                // 'value' => new Expression('NOW()'),
            ],
        ];
    }
}
 

以上指定的行为数组：

当记录插入时， 行为将当前的 UNIX 时间戳赋值给 created_at 和 updated_at 属性；

当记录更新时，行为将当前的 UNIX 时间戳赋值给 updated_at 属性。

保存 User 对象， 将会发现它的 created_at 和 updated_at 属性自动填充了当前时间戳：

1
2
3
4
5
6
7
8
$user = new User;
$user->email = 'test@example.com';
$user->save();
echo $user->created_at;  // 显示当前时间戳
yii\behaviors\TimestampBehavior 行为还提供了一个有用的方法 yii\behaviors\TimestampBehavior::touch()， 这个方法能将当前时间戳赋值给指定属性并保存到数据库：
 
$user->touch('login_time');
 

处理事件

如果要让行为响应对应组件的事件触发， 就应覆写 yii\base\Behavior::events() 方法，如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
namespace app\components;
 
use yii\db\ActiveRecord;
use yii\base\Behavior;
 
class MyBehavior extends Behavior
{
    // 其它代码
 
    public function events()
    {
        return [
            ActiveRecord::EVENT_BEFORE_VALIDATE => 'beforeValidate',
        ];
    }
 
    public function beforeValidate($event)
    {
        // 处理器方法逻辑
    }
}
 

yii\base\Behavior::events() 方法返回事件列表和相应的处理器。 上例声明了 yii\db\ActiveRecord::EVENT_BEFORE_VALIDATE 事件和它的处理器 beforeValidate()。

yii2 表单使用

准备代码文件

1
2
3
4
5
yiint/controllers/FormController.php
yiint/models/FormEntry.php
yiint/views/form/entry.php
yiint/views/form/index.php
 

form/entry.php

在视图中生成一个 HTML 表单

声明规则去验证输入的数据

创建一个模型代表用户通过表单输入的数据

表单与输入框字段

视图使用小部件 yii\widgets\ActiveForm 去生成 HTML 表单。 其中的 begin() 和 end() 分别用来渲染表单的开始和关闭标签。

yii\widgets\ActiveForm::field() 方法用于创建输入框。

1
2
3
4
5
6
7
8
9
10
11
12
<?php $form = ActiveForm::begin(); ?>
 
    <?= $form->field($model, 'name') ?>
 
    <?= $form->field($model, 'email') ?>
 
    <div class="form-group">
        <?= Html::submitButton('Submit', ['class' => 'btn btn-primary']) ?>
    </div>
 
<?php ActiveForm::end(); ?>
 

1
2
3
4
5
6
7
8
9
10
11
文本框:textInput();
密码框:passwordInput();
单选框:radio(),radioList();
复选框:checkbox(),checkboxList();
下拉框:dropDownList();
隐藏域:hiddenInput();
文本域:textarea(['rows'=>3]);
文件上传:fileInput();
提交按钮:submitButton();
重置按钮:resetButtun();
 

表单字段

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<?php
$form = ActiveForm::begin(['action' => ['test/getpost'],'method'=>'post',]); ?>
 
<? echo $form->field($model, 'username')->textInput(['maxlength' => 20]) ?>
 
<? echo $form->field($model, 'password')->passwordInput(['maxlength' => 20]) ?>
 
<? echo $form->field($model, 'sex')->radioList(['1'=>'男','0'=>'女']) ?>
 
<? echo $form->field($model, 'edu')->dropDownList(['1'=>'大学','2'=>'高中','3'=>'初中'], ['prompt'=>'请选择','style'=>'width:120px']) ?>
 
<? echo $form->field($model, 'file')->fileInput() ?>
 
<? echo $form->field($model, 'hobby')->checkboxList(['0'=>'篮球','1'=>'足球','2'=>'羽毛球','3'=>'乒乓球']) ?>
 
<? echo $form->field($model, 'info')->textarea(['rows'=>3]) ?>
 
<? echo $form->field($model, 'userid')->hiddenInput(['value'=>3]) ?>
 
<? echo Html::submitButton('提交', ['class'=>'btn btn-primary','name' =>'submit-button']) ?>
 
<? echo Html::resetButton('重置', ['class'=>'btn btn-primary','name' =>'submit-button']) ?>
 
<?php ActiveForm::end(); ?>
 

代码探析

1
2
3
4
5
6
7
8
9
10
11
12
<br /><?php $form = ActiveForm::begin(); ?>
 
    <?= $form->field($model, 'name') ?>
 
    <?= $form->field($model, 'email') ?>
 
    <div class="form-group">
        <?= Html::submitButton('Submit', ['class' => 'btn btn-primary']) ?>
    </div>
 
<?php ActiveForm::end(); ?>
 

ActiveForm 类图与代码解析

是的，其实数据首先由客户端 JavaScript 脚本验证，然后才会提交给服务器通过 PHP 验证。 yii\widgets\ActiveForm 足够智能到把你在 EntryForm 模型中声明的验证规则转化成客户端 JavaScript 脚本去执行验证。 如果用户浏览器禁用了 JavaScript， 服务器端仍然会像 actionEntry() 方法里这样验证一遍数据。 这保证了任何情况下用户提交的数据都是有效的。

输入框的文字标签是 field() 方法生成的，内容就是模型中该数据的属性名。 例如模型中的 name 属性生成的标签就是 Name。

输入验证

FormController.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/**
* yii\base\Model::validate() 方法进行数据验证
*
* 验证失败， 将把 yii\base\Model::hasErrors 属性设为 ture
* 具体错误通过调用 yii\base\Model::getErrors 获取
*/
public function actionValidate()
{
    $model = new FormEntry();
    $model->name = 'xiaoming';
    $model->email = '123@163.com';
    if ($model->validate()) {
        return '验证成功';
    } else {
        var_dump($model->hasErrors(), $model->getErrors());
        return '验证失败';
    }
}
 

yii2 从控制器到展示

新建 Controller

1> 手动添加

在yii项目 controllers 目录下添加 controller 文件。

app\controllers\NoteController.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?php
namespace app\controllers;
 
// yii 框架基础辅助类, 包含框架级的属性和方法
use Yii;
 
/**
* 手动创建controller
*/
class NoteController extends \yii\web\Controller
{
    /**
     * 控制器中可以被直接访问的方法需要以 action 为前缀
     *
     * 访问链接 http://yiint.local.com/index.php?r=note 页面将会显示当前文件名
     */
    public function actionIndex()
    {
        echo __FILE__;
    }
}
 
 

2> web gii 生成

http://yiint.local.com/index.php?r=gii

Controller Class 栏中填入控制器路径，如下:

1
2
app\controllers\WebgiiController
 

点击 Preview，确认无误后点击 Generate，会显示生成结果。如果生成失败，应该是php-fpm 对 app\controllers 路径没有写权限，将 app\controllers 改为 777 权限后重试即可。最后进入新生成的控制器页面。

app\controllers\WebgiiController.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<?php
 
namespace app\controllers;
 
/**
* web gii 生成的控制器
*/
class WebgiiController extends \yii\web\Controller
{
    public function actionIndex()
    {
        return $this->render('index');
    }
 
}
 

3> 终端 yii gii 生成

项目目录下，使用yii 命令生成控制器

1
2
php yii gii/controller --controllerClass="app\controllers\ConsolegiiController"
 

新建 action

app\controllers\NoteController.php

1
2
3
4
5
6
7
8
9
10
11
/**
* 增加一个action
* 控制器中可以被直接访问的方法需要以 action 为前缀
*
* @param  string $name name
*/
public function actionHello($name = 'yii')
{
    return $this->render('hello', ['name' => $name]);
}
 

Yii 使用 action 前缀区分普通方法和可被web 使用的操作。 action 前缀后面的名称为操作请求参数。

操作命名

Yii 中操作名总是以小写处理，如果一个操作 ID 由多个单词组成， 单词之间将由连字符连接，如：

1
2
3
hello --> actionHello
hello-world --> actionHelloWorld
 

新建 view

yiint/views/note/hello.php

1
2
3
4
<h1>note/hello</h1>
 
<p>hello <?= $name ?></p>
 

视图内容应该保存在 views/控制器名/视图名.php 文件中。通过控制器的 render() 方法加载视图文件。

打开页面 http://yiint.local.com/index.php?r=note/hello&name=world

路径

http://yiint.local.com/index.php?r=note/hello&name=world

路由格式是 ?r=控制器名/操作名&参数名=参数值

应用接受请求的时候会检查参数， 使用控制其名确定哪个控制器应该被用来处理请求。 然后相应控制器将使用操作名去确定哪个操作方法将被用来做具体工作。

这个链接中，路由 note/hello 将被解析至 NoteController 控制器中的 actionHello()。

参考

  • 1
  • 2