Yii2.0开发初学者必看

Posted 2020-07-22 清风徐来工作室

基础总结

1.修改默认控制器/方法

yii默认是site控制器，可以在web.php中设置$config中的‘defaultRoute‘=‘xxxx‘;使用自定义默认的控制器。也可以改写Yii::$app->defaultRoute属性。

yii的默认方法是index，可以在vender/yiisoft/yii2/base/Controller.php 中进行初始设置，也可以在控制器中改写defaltAction=‘action‘。

2.添加独立模块

yii可以在modules文件夹中添加自定义模块，添加完成后在web.php中的$config中的‘modules‘=[id=..class=...]设置模块的开关。

模块一般用于一些独立的功能，像我站里的admin模块整体负责后台逻辑。

3.模型操作表设置

yii的模型有Model和ActiveRecord两种，Model类用来处理基本的业务逻辑，没有数据库相关方法，如果要操作同名数据表，请继承ActiveRecord类。

我们用一个在models文件夹中的Operation.class里Operation类来继承yii\db\ActiveRecord来操作Operation表。

如果要操作其他表，也可以重写public $tableName属性来设置。或改写其tableName方法（注意是静态方法） ： public static function tableName(){return ‘tableName‘}

4.视图层构成

yii的视图层使用.php文件，而且其内部的实现也多采用yii内置小部件的形式，如<?= LinkPager::widget([‘pagination‘=>$pagination]) ?>来表示其分页类。

而且，像input这样的小部件，用ActiveForm类来展现，yii会对每个自动加入ajax验证，其一般的小部件都放在yii\widget\里，我们还可以在此文件夹里构建自定义的小部件类。

5.布局模式

yii会默认开启布局模式，其布局模板为view中的layout中的main.php，我们可以在veder/yiisoft/yii2/web/controller.php基础类中public $layout属性修改模板文件的配置。

我们还可以设置关闭或指定特定的layout：

• 控制器内控制 public $layout=false/‘layout‘
• 控制器成员方法内控制 $this->layout=false/‘layout‘
• 视图中选择布局 $this->context->layout=false/‘layout‘

6.模型的基本设置

yii的模型是MVC的处理器，它执行对MVC逻辑的处理。 model的属性定义是其核心，由于默认定义魔术方法get/set，所以可以直接在model外调用$modle->attr=‘value‘，对模型的属性进行获取/赋值。

场景设置

yii中有对场景的定义，定义场景可以使得yii在不同的情况下返回不同的数据信息。用model的scenarios()方法来设置返回数据。

我们在使用model时传入场景名 $model=new Model([‘scenario‘=>‘login‘]);来确定场景。

规则设置

yii中对验证规则的定义，使用rules()方法可以一条定义多条规则，也可以根据不同的场景进行定义。外部验证时用$model->validate()方法来执行验证。

在安全模式下，要进行安全验证，即每一个属性都要在rules里验证，如果没有特定规则，也要添加‘safe‘验证。否则验证失败，存入数据库也会失败。

标签设置

在处理表单时，多用$model->attributes属性来表示全部的属性。其中attributeLabels方法return一个数组用来表示视图层中ActiveForm产生的各个表单项的label标签

7.引用JS/CSS文件

yii中的view也使用面向对象方式 ，所以引入CSS和JS文件要用特殊的方法。

• 使用$this->registerJsFile(‘js.js‘)来引入js文件；
• 使用$this->registerJsFile(‘js.js‘)来引入js文件；

8.分页类的使用

//在模型中计算出总数量
$count=$this->find()->where()->count();
//用总条数和设定的每页个数实例化一个yii\data\Pagination类
$page=new Pagination([totalCount‘ => $count,‘defaultPageSize‘   => 2,]);
//使用分页类的属性搜索想要的数据，并返回数据
$res=$this->find()->where()->offset($page->offset)->limit($page->limit)->all();
return [$res,$page];
//使用控制器渲染页面
$data=$model->getData();
return $this->render(‘index‘,$data);
//在视图页面中使用数据。
foreach($res as key)...
yii\widgets\LinkPager::widget([pagination=$page,prevPageLabel=‘上一页‘])。

9.创建url

use yii\helpers\Url;
Url::to([‘xxx/xxx‘]);
//或
Yii::$app->urlManager->createUrl(‘xxx.xxx‘)

10查询构建器

yii里的QUERY查询语句构造器非常简单好用，它可以用在模型和控制器中，虽然可能会造成模型与表不对应，但其构成接近sql语句，使用它可以轻易写出复杂的sql语句而不必严格遵从yii的内置规则。

方法为：

$res=(new yii\db\Query())->select()->from()->leftJoin()->where->()->all();

其中where语句较为复杂：

where(‘in‘,‘id‘,$array)或where(‘id‘=>$array)

具体可以查看http://www.yiichina.com/doc/guide/2.0/db-query-builder中对where方法的解析。

11.自定义函数

yii里面自定义函数可以在vendor/yiisoft/yii2/helpers/文件夹里，新建一个XXX.php文件，然后定义一个自定义类，再定义静态方法YYY()。

使用时应用基命名空间，use yii\helpers\XXX,然后用类来引用基静态方法XXX::YYY()

12.关联模型

yii里面的关联模型，用来在取得当前表内的一条记录时，会取出对应表的记录。如A表内每取出一条信息，也取出B表中跟A表对应有信息，在ModelA里定义一个getBtable方法

function getBtable()
{
    return $this->hasOne/hasMany(Btable::className,[‘bid‘=>‘aid‘]);
}

查询时可以使用joinWith(‘Btable‘)->find();会在查找时查找其关联对象；也可以使用$this->find()等方法结果对象

使用$res->btable来直接引用对象。

使用$res[n]->btable->attr来引用B表的对应属性。

13.使用ActiveForm创建表单

yii2中使用小部件创建view视图的步骤： 设置一个Model设置其属性

public $username;
public $password;

设置其rule或场景等

public function rules(){
    return [
            [[‘username‘, ‘password‘,‘conpass‘], ‘required‘],
            [‘conpass‘, ‘password‘,
        ];
}

设置其label

public function attributeLabels(){
        return [
            ‘username‘ => ‘管理员‘,
            ‘password‘ => ‘密码‘,
        ];
    }

然后在controller中将model的实例渲染进去：

$this->render(‘index‘,[‘model‘=>(new Model/ActiveRecord)])

最后在页面中使用ActiveForm

use yii\widgets\ActiveForm;
<?php $form = ActiveForm::begin([
    ‘action‘ => [‘log/login‘],
    ‘method‘=>‘post‘
    ]); ?>
    <?= $form->field($model, ‘username‘) ?>
    <?= $form->field($model, ‘password‘) ?>
    <div class="form-group">
        <?= html::submitButton(‘Submit‘, [‘class‘ => ‘btn btn-primary‘]) ?>
    </div>
<?php ActiveForm::end(); ?>

14.使用验证码

在controller中设置验证码的独立方法

public function actions() {
        return [
            ‘captcha‘ =>  [
                ‘class‘ => ‘yii\captcha\CaptchaAction‘,
                ‘height‘ => 50,
                ‘width‘ => 80,
                ‘minLength‘ => 4,
                ‘maxLength‘ => 4
            ],
        ];
    }

在model里设置rule和label,label同上

public function rules(){
    return [[‘verifyCode‘, ‘captcha‘,‘captchaAction‘=>‘admin/log/captcha‘],];
}

(captchaAction要设置为controller中的位置，如果自定义module要设置module) 在view中使用

use yii\captcha\Captcha;
<?= $form->field($model, ‘verifyCode‘)->widget(Captcha::className(),
    [‘captchaAction‘=>‘log/captcha‘,
        ‘imageOptions‘=>
        [‘alt‘=>‘点击换图‘, ‘style‘=>‘cursor:pointer‘]
    ]) ?>

15.视图中块的使用

块内容在$this->beginBlock([‘id‘=>xxx])和$this->endBlock()之间定义，在layout中使用$view->block[id]来引用。可以在完成向模板中导入视图数据。

也可以定义$this->var=xxx;在layout中用$this->var来引用。

16.更新和删除

更新

//查找到一条结果
$res=$this->find()->where()->one();
//对结果修改
$res->attr=‘xxx‘;
//执行更新操作
$res->update();

删除

//删除一条数据
$this->findOne($id)->delete();
//删除所有符合条件的数据
$this->deleteAll([where]);

---

注意和窍门

1.URL模块间跳转

在模块中用Url::to()方法创建URL时，会自动在前面添加模块名，导致无法跳转到其他模块，我们可以在字符串前添加‘//‘符来返回根模块，例如Url::to([‘//index/index‘])表示跳转到初始地址。

2.初始化变量

想在控制器中每一个操作前，初始化一个变量的话不要重写__construct构造函数，因为它需要传入各种变量。最好重写beforeAction()函数，它会在执行每一个action时都执行一下。

并且注意：方法的最后一定要添加return true语句。

3.在JS中使用YII的变量

若想在JS中使用YII的URL变量等，可以使用html中的script标签，将变量在第一次渲染视图时预先解析出来，将下面代码放在需要使用变量的地方之前。

<script type="text/javascript">
    var key="<?=Url::to([‘xxx/xxx‘]) ?>"
</script>

然后在JS文件中正常使用。

4.全局常量的定义

我们可以在config文件夹中的params.php中定义全局常量。

然后在脚本中用Yii::$app->params[‘key‘]来引用。

5.yii模型属性转数组

YII用toArray()方法可以将模型的属性转换为数组进行输出，可独立使用，也可以在查询时用连续操作方式使用。

6.在使用controller渲染view页面时，一定要在render前加echo或return 写作echo/return $this->render(‘view‘,$data);

7.yii中的属性，谨记！在ActiveForm中如果数据表中有了此字段，就不要再用public声明一个属性了，会导致attribute无法赋值。。。。（血泪）。