学了两年半,Yii2的内置事件知多少?

书接上回,我将代码提交到服务器后被小X经理一顿批,她是这样说的。

小X: 你丫不知道yii2自己就有登陆后的事件么?
我:不知道啊,咋的吧?
小X:改!????,然后统计个yii2预定义事件表给我。
我:哦,好的。???

好吧,算咱技术不到家,那就赶紧改吧,先回顾下上一篇我都干了啥,我是在会员登陆后触发了一个事件,既然说有内置的,那就找找吧。

我知道登陆功能是使用yiiwebUser这个类,那应该去那里去找它们。它在@app/vendor/yiisoft/yii2/web/User.php

5分钟以后~

果然,我找到了那个事件,还用了3分钟分析了如何使用,现在把我的研究成果和大家分享下。

对于yii2系统的登陆,yiiwebUser类一共提供了4个事件,如下

const EVENT_BEFORE_LOGIN = 'beforeLogin';
const EVENT_AFTER_LOGIN = 'afterLogin';
const EVENT_BEFORE_LOGOUT = 'beforeLogout';
const EVENT_AFTER_LOGOUT = 'afterLogout';

分别是登陆前后、注销前后,我要使用的是EVENT_AFTER_LOGIN事件,那么如何去使用那?

既然是登陆,还是先看下yiiwebUser中的login方法,看看是否有蛛丝马迹

public function login(IdentityInterface $identity, $duration = 0){

    if ($this->beforeLogin($identity, false, $duration)) {
        $this->switchIdentity($identity, $duration);
        $id = $identity->getId();
        $ip = Yii::$app->getRequest()->getUserIP();
        if ($this->enableSession) {
            $log = "User '$id' logged in from $ip with duration $duration.";
        } else {
            $log = "User '$id' logged in from $ip. Session not enabled.";
        }
        Yii::info($log, __METHOD__);
        $this->afterLogin($identity, false, $duration);
    }

    return !$this->getIsGuest();
}

我看到了 $this->afterLogin($identity, false, $duration),似乎这个方法是登陆后做了一些事情,那就继续看吧

protected function afterLogin($identity, $cookieBased, $duration){

    $this->trigger(self::EVENT_AFTER_LOGIN, new UserEvent([
        'identity' => $identity,
        'cookieBased' => $cookieBased,
        'duration' => $duration,
    ]));
}

OMG,真的发现了,原来这个方法触发了EVENT_AFTER_LOGIN事件,并且还很贴心的将identity等信息传递给了绑定EVENT_AFTER_LOGIN事件的每一位观察者。

于是思路来了㊙️㊙️㊙️㊙️㊙️㊙️

我只需要在login前绑定EVENT_AFTER_LOGIN事件,然后afterLogin会自动触发所有订阅者。

重构开始

use yii\web\User;
class UserController extends Controller {
    
    public function __construct(){
        //    绑定事件
        $this->on(User::EVENT_AFTER_LOGIN,['app\models\OLog','add']); 
        $this->on(User::EVENT_AFTER_LOGIN,['app\models\Admin','sendMail']); 
        $this->on(User::EVENT_AFTER_LOGIN,['app\models\User','notifyFirend']); 
    }
    
    public function actionIndex(){
        .....
        //    login                
    }
}

我之前定义的EVENT_USER_LOGIN自然可以删除了,上面看到afterLogin方法触发事件的时候已经传递了一个UserEvent,里面含有登陆的详细信息了,我上一篇自己定义的那个UserLoginEvent也就可以删除了。

使用系统自带的事件,真心省了太多代码了,感谢yii2开发团队,感谢你们八倍祖主。

对于登陆主题就重构完了,现在我还需要改下订阅者的代码,毕竟传递给订阅者的$event不一样了,拿一个订阅者举例吧

// User app\models\User.php
class User {
    static public function notifyFirend($event){
        $userId = $event->userId;
        echo "告诉了朋友们我登陆了";
    }
}

我要对其进行小手术,diu一下,手术后的样子如下

// User app\models\User.php
class User {
    static public function notifyFirend($event){
        $userId = $event->identity->id;
        echo "告诉了朋友们我登陆了";
    }
}

ok~
到此为止我们对登陆逻辑的事件处理就完成了,去掉了自定义的事件,绑定了 User::EVENT_AFTER_LOGIN 内置事件。

还没完~

是的还没完,小X经理还让我提交一个yii2预定义事件表给她,我深刻体会到这个表格的重要性,有了它,便可以通晓yii所有事件,正所谓就算成功,也不一定自宫。

但是,yii2这么大,我如何一个不落的得到它们那?

看来要借助于我们的神器PHPSTORM了。

首先我们知道yii2对于事件名的命名规则,常量大写、观察下发现内置的这些事件都是EVENT_开头的,有了这些特征,那开始吧。

方法如下:我们对vendor/yiisoft目录进行查找(find in path),找到所有const EVENT_开头的行。

学了两年半,Yii2的内置事件知多少?

是的,一共有41个。最近听说有个叫阿北的人做了一个yii速查表,我计划将这个表格分享给他也。

yii2速查表之event内置一览表 http://nai8.me/tool-sc.html

建议你背下这些事件,至少在做事件的时候查一遍速查表,能用系统的优先使用系统的。

学到了一些

很高兴完成了小x经理关于登陆事件的需求,通过这些让我对yii的事件有了一个大体了解,知道了事件是观察者模式的一种实现、知道yii2内置了很多事件,我们应该优先使用它们。

begin git。

一阵QQ震动,带着坏笑的小x经理发了一句消息给我:“来,小北同学!”

天,又咋了,下篇告诉你。

yii

相关推荐