ユーザー登録時や退会時など特定のイベントの時に発火させたいメソッドを管理したい時はイベントリスナーを使うと便利です。
今回は基本的なイベントとリスナーの定義の仕方についてはすっ飛ばし、一つのリスナークラスで複数のイベントを設定できるイベント購読について扱います。
まずはイベントを定義しましょう。
例として“ユーザー登録完了時”というイベントを作成することにします。
イベントクラスはartisanコマンドで生成することができます。
php artisan make:event UserRegistrationComplete
<?php
namespace App\Events;
use App\Events\Event;
use Illuminate\Queue\SerializesModels;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
class UserRegistrationComplete extends Event
{
use SerializesModels;
/**
* Create a new event instance.
*
* @return void
*/
public function __construct()
{
//
}
/**
* Get the channels the event should be broadcast on.
*
* @return array
*/
public function broadcastOn()
{
return [];
}
}
artisanコマンドを実行するとこのようなクラスが自動生成されます。
コンストラクタの中にはイベントで使用するデータを設定しておきましょう。
今回はユーザー登録に関わるイベントなので、Userモデルを呼び出しておくことにします。ここで呼び出したデータはリスナークラスで使用することができます。
/**
* Create a new event instance.
*
* @return void
*/
public function __construct(User $user)
{
$this->user = $user;
}
ちなみにbroadcastOnというのは、リアルタイムに実行したいユーザーインターフェースを実装したい時に使用するものなので今回はスルーです。
次にリスナーを定義しましょう。
リスナーもartisanコマンドで生成することができます。
php artisan make:listener UserAuthEventListenerListener --event UserRegistrationComplete
リスナーを生成するときは、eventオプションで結び付けたいイベントを設定することができます。
<?php
namespace App\Listeners;
use App\Events\UserRegistrationComplete;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
class UserAuthEventListenerListener
{
/**
* Create the event listener.
*
* @return void
*/
public function __construct()
{
//
}
/**
* Handle the event.
*
* @param UserRegistrationComplete $event
* @return void
*/
public function handle(UserRegistrationComplete $event)
{
//
}
}
イベント購読は、一つのリスナークラスに複数のイベントを設定できるので、リスナー名は複数あるイベントのカテゴリー名のような形で命名すると良いでしょう。
今回の例でいくと、“ユーザー登録完了イベントはユーザー認証のグループに属す”といったところでしょうか。
生成したリスナーでイベント発火時の処理とイベント購読の登録を行います。
<?php
namespace App\Listeners;
class UserAuthEventListener
{
// イベント発火時の処理
public function onConfirm($event)
{
// 処理
}
// 複数追加できます
public function onHogeHoge($event)
{
// 処理
}
// イベント購読の登録
public function subscribe($events)
{
$events->listen(
'App\Events\UserRegistrationComplete',
'App\Listeners\UserAuthEventListener@onConfirm'
);
}
// 複数登録できます
public function subscribe($events)
{
$events->listen(
'App\Events\UserHogeHoge',
'App\Listeners\UserAuthEventListener@onHogeHoge'
);
}
}
イベント追加したい場合は、先ほどのartisanコマンドでイベントを生成してやればOKです。
登録ばっかりでややこしいかと思いますが、これで最後です。
app\Providersにデフォルトで存在しているEventServiceProviderを使用します。
サービスプロバイダというのはアプリケーションの初期起動処理を行うクラスです。詳しくはドキュメント
<?php
namespace App\Providers;
use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
class EventServiceProvider extends ServiceProvider
{
// ここにリスナーを登録していく
protected $subscribe = [
'App\Listeners\UserAuthEventListener',
'App\Listeners\HogeHogeListener',
];
}
さて、イベント購読の登録が完了したら後は自由にイベントを発火させましょう。
イベントを発火させるには、Eventファサードとfireメソッドを使います。
fireメソッドにはイベントのインスタンスを渡してあげます。
/**
* コントローラーのとあるメソッド
*/
private function hogehoge(User $user)
{
// 登録確認イベントの発火
\Event::fire(new UserAuthRegistrationComplete($user));
}
こんな感じで登録したイベントが火を吹きます :fire:
イベント定義（データ保持）→リスナー定義（イベントで使用するメソッド管理とsubscribeメソッド実装）→イベント購読登録→:fire:
Laravel5.3からNotificationというパッケージが導入されたので今回のような通知の管理はNotificationを利用した方が楽かもしれません。
そういった意図があるのか、5.3ではEventやListener, Jobとったディレクトリがデフォルトでは存在しなくなりました。
気になる方はLaravelのリポジトリやドキュメントをご覧ください。
関連書籍