学了两年半,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_开头的行。
是的,一共有41个。最近听说有个叫阿北的人做了一个yii速查表,我计划将这个表格分享给他也。
yii2速查表之event内置一览表 http://nai8.me/tool-sc.html
建议你背下这些事件,至少在做事件的时候查一遍速查表,能用系统的优先使用系统的。
学到了一些
很高兴完成了小x经理关于登陆事件的需求,通过这些让我对yii的事件有了一个大体了解,知道了事件是观察者模式的一种实现、知道yii2内置了很多事件,我们应该优先使用它们。
begin git。
一阵QQ震动,带着坏笑的小x经理发了一句消息给我:“来,小北同学!”
天,又咋了,下篇告诉你。