Laravelのモデルイベント（creating, updating）を使う方法

1. creatingイベントで「新規保存前」に自動処理を追加する

1. creatingイベントで「新規保存前」に自動処理を追加する

Laravelでデータを新しく保存する際、「保存ボタンが押された瞬間に、自動で特定の値をセットしたい」という場面がよくあります。これを実現するのがcreatingイベントです。

例えば、プログラミング初心者の方でもイメージしやすい「会員登録システム」を考えてみましょう。ユーザー一人ひとりに、重複しない特別なID（UUID）を自動で割り振る仕組みを、モデルイベントを使って実装します。

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;

class User extends Model
{
    /**
     * モデルの起動時に呼ばれるメソッド
     */
    protected static function booted()
    {
        // 1. データを新しく作ろうとしている（creating）タイミングをキャッチ
        static::creating(function ($user) {
            // 2. 保存される直前に、uuidという項目に自動でランダムな値を代入
            $user->uuid = (string) Str::uuid();
            
            // ログを出して動きを確認（デバッグ用）
            \Log::info('新しいユーザーのUUIDを自動設定しました：' . $user->uuid);
        });
    }
}

このコードのポイントは、bootedという「モデルが準備されたときに動くメソッド」の中に処理を書くことです。

なぜこれが便利なの？
もしこれを使わないと、ユーザーを登録する全ての場所（コントローラなど）で毎回UUIDを生成するコードを書かなければなりません。モデルイベントを使えば、「ユーザーが作られるときはいつでも、自動的にこのルールを適用する」という設定が一箇所で済むため、書き忘れやミスを未然に防ぐことができます。

1. ユーザーが名前を入力して登録ボタンを押す
2. Laravelが「creatingイベント」を検知
3. 自動で UUID (例: 550e8400-e29b-41d4-a716-446655440000) が生成され、データにセットされる
4. データベースに保存完了！

2. updatingイベントで更新前に処理する

2. updatingイベントで更新前に処理する

データを更新するときに、自動でタイムスタンプを設定したい場合はupdatingイベントを使います。

protected static function booted()
{
    static::updating(function ($user) {
        $user->updated_by = auth()->id();
    });
}

ここでは、ユーザー情報が更新される前に、updated_byフィールドに現在ログインしているユーザーのIDを自動で設定しています。

3. イベントを使うメリット

3. イベントを使うメリット

モデルイベントを使うことで、コントローラやサービスクラスに同じ処理を書かずに済み、コードがすっきりします。また、データの一貫性や自動化も簡単に実現できます。

例えば、全てのユーザー登録にUUIDを設定したり、全ての更新操作に更新者IDを記録したりする処理を一箇所にまとめて書けます。これにより、ミスを減らし、保守性の高いアプリケーションが作れます。

4. 注意点とポイント

4. 注意点とポイント

モデルイベントは自動で呼ばれるため、コントローラ側で重複して同じ処理を書かないように注意しましょう。また、creatingとupdatingは保存前のイベントなので、データベースに反映される前に値を加工できます。

イベントには他にもcreatedやupdatedなど、保存後に処理するタイプもあります。まずはcreatingとupdatingを覚えて、データ保存前の自動処理を実装できるようになることが大切です。

この仕組みを理解することで、Laravelで効率的にデータ管理ができ、アプリケーションの信頼性を高めることができます。

まとめ

まとめ

今回はLaravel（ララベル）の強力な機能の一つである「モデルイベント（Eloquentイベント）」、特にデータの保存や更新のタイミングで威力を発揮する「creating」と「updating」について詳しく解説してきました。Webアプリケーションを開発していると、データベースに値を保存する直前に「特定のIDを自動付与したい」「特定のカラムを自動計算して埋めたい」といった場面が多々あります。これらをコントローラに都度書いていると、コードが煩雑になり、共通化も難しくなります。しかし、モデルイベントを活用すれば、モデル自身の責務としてこれらをスマートに一括管理できるのです。

モデルイベントを活用する実践的なメリット

Eloquentモデルイベントを利用することで、開発効率は劇的に向上します。主なメリットを整理してみましょう。

• DRY（Don't Repeat Yourself）原則の維持： 同じ処理を複数のコントローラに書く必要がなくなります。
• データの一貫性の担保： どこからデータを保存しても必ずイベントが実行されるため、値の漏れを防げます。
• コードの可読性向上： ビジネスロジックがモデルに集約され、コントローラがスッキリします。

creatingとupdatingの具体的な使い分け

改めて、今回紹介した二つのイベントの違いを復習しておきましょう。

creating： 新規レコードが作成（insert）される直前にフックされます。IDの自動生成や初期ステータスの設定に向いています。

updating： 既存のレコードが変更（update）される直前にフックされます。変更履歴の記録や、更新者のID保存に最適です。

応用：複数のイベントを組み合わせたサンプルコード

実践では、一つのモデルに対して複数のイベントを定義することが一般的です。以下のサンプルプログラムでは、新規作成時には管理用コードを生成し、更新時には最終更新ユーザーを記録する、より現場に近い形の実装を紹介します。

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;
use Illuminate\Support\Facades\Auth;

class Product extends Model
{
    /**
     * モデルの「初期起動」メソッド
     */
    protected static function booted()
    {
        // 新規作成時のみ実行される処理
        static::creating(function ($product) {
            // 商品コードをランダムな文字列で自動生成
            if (empty($product->product_code)) {
                $product->product_code = 'PRD-' . strtoupper(Str::random(8));
            }
            // ログ出力用などの初期設定
            logger('新しい商品が作成されます。');
        });

        // 更新時のみ実行される処理
        static::updating(function ($product) {
            // ログイン中であれば、更新者IDを自動保存
            if (Auth::check()) {
                $product->last_updated_by = Auth::id();
            }
            logger('商品ID:' . $product->id . ' が更新されます。');
        });
    }
}

このようにbootedメソッド内でstatic::creatingやstatic::updatingを呼び出すだけで、Laravelが裏側ですべて面倒を見てくれます。非常に強力ですね。

モデルオブザーバー（Observers）という選択肢

もし、モデル内に書くイベント処理が肥大化してしまった場合は、「Observer（オブザーバー）」クラスを作成して処理を切り出す方法もあります。これにより、モデルクラス自体を軽量に保つことができます。

php artisan make:observer UserObserver --model=User

このコマンドを実行すると、イベント専用のクラスが生成されます。小規模なうちはモデル内のbootedで十分ですが、大規模な開発ではObserverの利用も検討してみてください。

最後に

Laravelのモデルイベントは、PHPでのWeb制作を一段上のレベルに引き上げてくれる素晴らしい仕組みです。特にCRUD操作（作成、読み取り、更新、削除）が中心となるシステムでは、この自動化の仕組みを知っているかどうかで、コードの品質に大きな差が出ます。まずは、今回紹介したコードを実際に自分のプロジェクトに組み込んで、データベースに反映される動きを確認してみてください。きっとその便利さに驚くはずです。