メインコンテンツまでスキップ
バージョン: 8.x

Eloquent: はじめに (Eloquent: Getting Started)

導入 (Introduction)​

Laravel には、データベースとの対話を楽しくするオブジェクト リレーショナル マッパー (ORM) である Eloquent が含まれています。 Eloquent を使用する場合、各データベース テーブルには、そのテーブルと対話するために使用される対応する「モデル」があります。 Eloquent モデルでは、データベース テーブルからレコードを取得するだけでなく、テーブルからレコードを挿入、更新、削除することもできます。

{tip} 開始する前に、必ずアプリケーションの config/database.php 構成ファイルでデータベース接続を構成してください。データベースの構成の詳細については、データベース構成ドキュメント を確認してください。

モデルクラスの生成 (Generating Model Classes)​

まず、Eloquent モデルを作成しましょう。モデルは通常、app\Models ディレクトリに存在し、Illuminate\Database\Eloquent\Model クラスを拡張します。 make:model Artisan コマンド を使用して新しいモデルを生成できます。

php artisan make:model Flight

モデルの生成時に データベースの移行 を生成したい場合は、--migration または -m オプションを使用できます。

php artisan make:model Flight --migration

モデルを生成するときに、ファクトリ、シーダー、ポリシー、コントローラ、フォーム リクエストなど、他のさまざまなタイプのクラスを生成できます。さらに、これらのオプションを組み合わせて複数のクラスを一度に作成することもできます。

# Generate a model and a FlightFactory class...
php artisan make:model Flight --factory
php artisan make:model Flight -f

# Generate a model and a FlightSeeder class...
php artisan make:model Flight --seed
php artisan make:model Flight -s

# Generate a model and a FlightController class...
php artisan make:model Flight --controller
php artisan make:model Flight -c

# Generate a model, FlightController resource class, and form request classes...
php artisan make:model Flight --controller --resource --requests
php artisan make:model Flight -crR

# Generate a model and a FlightPolicy class...
php artisan make:model Flight --policy

# Generate a model and a migration, factory, seeder, and controller...
php artisan make:model Flight -mfsc

# Shortcut to generate a model, migration, factory, seeder, policy, controller, and form requests...
php artisan make:model Flight --all

# Generate a pivot model...
php artisan make:model Member --pivot

Eloquent モデルの規約 (Eloquent Model Conventions)​

make:model コマンドによって生成されたモデルは、app/Models ディレクトリに配置されます。基本的なモデル クラスを調べて、Eloquent の主要な規則のいくつかについて説明しましょう。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    //
}

テーブル名​

上記の例を見た後、どのデータベース テーブルが Flight モデルに対応するかを Eloquent に伝えていないことに気付いたかもしれません。慣例により、別の名前が明示的に指定されない限り、「スネークケース」クラスの複数名がテーブル名として使用されます。したがって、この場合、Eloquent は、Flight モデルが flights テーブルにレコードを保存するのに対し、AirTrafficController モデルは air_traffic_controllers テーブルにレコードを保存すると想定します。

モデルの対応するデータベース テーブルがこの規則に適合しない場合は、モデルで table プロパティを定義することで、モデルのテーブル名を手動で指定できます。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'my_flights';
}

主キー​

また、Eloquent は、各モデルの対応するデータベース テーブルに id という名前の主キー列があると想定します。必要に応じて、モデルで保護された $primaryKey プロパティを定義して、モデルの主キーとして機能する別の列を指定できます。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The primary key associated with the table.
     *
     * @var string
     */
    protected $primaryKey = 'flight_id';
}

さらに、Eloquent は主キーが増加する整数値であると想定します。これは、Eloquent が主キーを自動的に整数にキャストすることを意味します。非インクリメントまたは非数値の主キーを使用したい場合は、false に設定されるパブリック $incrementing プロパティをモデル上で定義する必要があります。

<?php

class Flight extends Model
{
    /**
     * Indicates if the model's ID is auto-incrementing.
     *
     * @var bool
     */
    public $incrementing = false;
}

モデルの主キーが整数でない場合は、モデルで保護された $keyType プロパティを定義する必要があります。このプロパティの値は string である必要があります。

<?php

class Flight extends Model
{
    /**
     * The data type of the auto-incrementing ID.
     *
     * @var string
     */
    protected $keyType = 'string';
}

「複合」主キー​

Eloquent では、各モデルに主キーとして機能する一意に識別できる「ID」を少なくとも 1 つ持つ必要があります。 「複合」主キーは Eloquent モデルではサポートされていません。ただし、テーブルを一意に識別する主キーに加えて、複数列の一意のインデックスをデータベース テーブルに自由に追加できます。

タイムスタンプ​

デフォルトでは、Eloquent は、モデルの対応するデータベース テーブルに created_at 列と updated_at 列が存在することを期待します。 Eloquent は、モデルの作成または更新時にこれらの列の値を自動的に設定します。これらの列を Eloquent によって自動的に管理したくない場合は、モデル上で $timestamps プロパティを false の値で定義する必要があります。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * Indicates if the model should be timestamped.
     *
     * @var bool
     */
    public $timestamps = false;
}

モデルのタイムスタンプの形式をカスタマイズする必要がある場合は、モデルで $dateFormat プロパティを設定します。このプロパティは、モデルが配列または JSON にシリアル化されるときの日付属性のデータベースへの保存方法とその形式を決定します。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The storage format of the model's date columns.
     *
     * @var string
     */
    protected $dateFormat = 'U';
}

タイムスタンプの保存に使用される列の名前をカスタマイズする必要がある場合は、モデルで CREATED_AT および UPDATED_AT 定数を定義できます。

<?php

class Flight extends Model
{
    const CREATED_AT = 'creation_date';
    const UPDATED_AT = 'updated_date';
}

データベース接続​

デフォルトでは、すべての Eloquent モデルは、アプリケーション用に設定されたデフォルトのデータベース接続を使用します。特定のモデルと対話するときに使用する別の接続を指定したい場合は、モデルで $connection プロパティを定義する必要があります。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The database connection that should be used by the model.
     *
     * @var string
     */
    protected $connection = 'sqlite';
}

デフォルトの属性値​

デフォルトでは、新しくインスタンス化されたモデル インスタンスには属性値が含まれません。モデルの一部の属性のデフォルト値を定義したい場合は、モデルで $attributes プロパティを定義できます。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The model's default values for attributes.
     *
     * @var array
     */
    protected $attributes = [
        'delayed' => false,
    ];
}

モデルの取得 (Retrieving Models)​

モデルと 関連するデータベーステーブル を作成したら、データベースからのデータの取得を開始する準備が整います。各 Eloquent モデルは、モデルに関連付けられたデータベース テーブルにスムーズにクエリを実行できる強力な クエリビルダ と考えることができます。モデルの all メソッドは、モデルに関連付けられたデータベース テーブルからすべてのレコードを取得します。

use App\Models\Flight;

foreach (Flight::all() as $flight) {
    echo $flight->name;
}

クエリの構築​

Eloquent all メソッドは、モデルのテーブル内のすべての結果を返します。ただし、各 Eloquent モデルは クエリビルダ として機能するため、クエリに追加の制約を追加してから、get メソッドを呼び出して結果を取得することができます。

$flights = Flight::where('active', 1)
               ->orderBy('name')
               ->take(10)
               ->get();

{tip} Eloquent モデルはクエリビルダであるため、Laravel の クエリビルダ によって提供されるすべてのメソッドを確認する必要があります。 Eloquent クエリを作成するときは、これらのメソッドのいずれかを使用できます。

モデルの更新​

データベースから取得した Eloquent モデルのインスタンスがすでにある場合は、fresh メソッドと refresh メソッドを使用してモデルを「更新」できます。 fresh メソッドはデータベースからモデルを再取得します。既存のモデル インスタンスは影響を受けません。

$flight = Flight::where('number', 'FR 900')->first();

$freshFlight = $flight->fresh();

refresh メソッドは、データベースからの新しいデータを使用して既存のモデルを再ハイドレートします。さらに、読み込まれた関係もすべて更新されます。

$flight = Flight::where('number', 'FR 900')->first();

$flight->number = 'FR 456';

$flight->refresh();

$flight->number; // "FR 900"

コレクション​

これまで見てきたように、all や get などの Eloquent メソッドはデータベースから複数のレコードを取得します。ただし、これらのメソッドはプレーンな PHP 配列を返しません。代わりに、Illuminate\Database\Eloquent\Collection のインスタンスが返されます。

Eloquent Collection クラスは、Laravel の基本 Illuminate\Support\Collection クラスを拡張し、データ コレクションと対話するための さまざまな役立つ方法 を提供します。たとえば、reject メソッドは、呼び出されたクロージャの結果に基づいてコレクションからモデルを削除するために使用できます。

$flights = Flight::where('destination', 'Paris')->get();

$flights = $flights->reject(function ($flight) {
    return $flight->cancelled;
});

Laravel の基本コレクション クラスによって提供されるメソッドに加えて、Eloquent コレクション クラスは、特に Eloquent モデルのコレクションと対話することを目的とした いくつかの追加のメソッド を提供します。

Laravel のコレクションはすべて PHP の反復可能なインターフェイスを実装しているため、コレクションを配列であるかのようにループできます。

foreach ($flights as $flight) {
    echo $flight->name;
}

チャンク化の結果​

all メソッドまたは get メソッドを介して数万の Eloquent レコードをロードしようとすると、アプリケーションがメモリ不足になる可能性があります。これらのメソッドを使用する代わりに、chunk メソッドを使用して、多数のモデルをより効率的に処理できます。

chunk メソッドは Eloquent モデルのサブセットを取得し、処理のためにクロージャに渡します。一度に取得されるのは Eloquent モデルの現在のチャンクのみであるため、chunk メソッドを使用すると、多数のモデルを操作する場合にメモリ使用量が大幅に削減されます。

use App\Models\Flight;

Flight::chunk(200, function ($flights) {
    foreach ($flights as $flight) {
        //
    }
});

chunk メソッドに渡される最初の引数は、「チャンク」ごとに受信するレコードの数です。 2 番目の引数として渡されたクロージャは、データベースから取得されるチャンクごとに呼び出されます。データベース クエリが実行され、クロージャに渡されたレコードの各チャンクが取得されます。

結果の反復処理中に更新も行う列に基づいて chunk メソッドの結果をフィルター処理する場合は、chunkById メソッドを使用する必要があります。これらのシナリオで chunk メソッドを使用すると、予期しない一貫性のない結果が生じる可能性があります。内部的には、chunkById メソッドは常に、前のチャンクの最後のモデルより大きい id 列を持つモデルを取得します。

Flight::where('departed', true)
    ->chunkById(200, function ($flights) {
        $flights->each->update(['departed' => false]);
    }, $column = 'id');

結果を遅延的にストリーミングする​

lazy メソッドは、バックグラウンドでクエリをチャンク単位で実行するという意味で、chunk メソッド と同様に機能します。ただし、各チャンクをそのままコールバックに直接渡す代わりに、lazy メソッドは Eloquent モデルのフラット化された LazyCollection を返します。これにより、結果を単一のストリームとして操作できます。

use App\Models\Flight;

foreach (Flight::lazy() as $flight) {
    //
}

結果の反復処理中に更新も行う列に基づいて lazy メソッドの結果をフィルター処理する場合は、lazyById メソッドを使用する必要があります。内部的には、lazyById メソッドは常に、前のチャンクの最後のモデルより大きい id 列を持つモデルを取得します。

Flight::where('departed', true)
    ->lazyById(200, $column = 'id')
    ->each->update(['departed' => false]);

lazyByIdDesc メソッドを使用して、id の降順に基づいて結果をフィルタリングできます。

カーソル​

lazy メソッドと同様に、cursor メソッドを使用すると、数万の Eloquent モデル レコードを反復処理するときにアプリケーションのメモリ消費を大幅に削減できます。

cursor メソッドは、単一のデータベース クエリのみを実行します。ただし、個々の Eloquent モデルは、実際に反復されるまでハイドレートされません。したがって、カーソル上で反復している間、常に 1 つの Eloquent モデルだけがメモリに保持されます。

{note} cursor メソッドは一度に 1 つの Eloquent モデルのみをメモリ内に保持するため、関係を一括読み込みすることはできません。関係を一括ロードする必要がある場合は、代わりに lazy メソッド の使用を検討してください。

内部的には、cursor メソッドは PHP generators を使用してこの機能を実装します。

use App\Models\Flight;

foreach (Flight::where('destination', 'Zurich')->cursor() as $flight) {
    //
}

cursor は、Illuminate\Support\LazyCollection インスタンスを返します。 レイジーコレクション を使用すると、一度に 1 つのモデルのみをメモリにロードしながら、一般的な Laravel コレクションで利用可能な多くのコレクション メソッドを使用できます。

use App\Models\User;

$users = User::cursor()->filter(function ($user) {
    return $user->id > 500;
});

foreach ($users as $user) {
    echo $user->id;
}

cursor メソッドは、通常のクエリよりもはるかに少ないメモリを使用しますが (一度に 1 つの Eloquent モデルのみをメモリに保持するため)、それでも最終的にはメモリが不足します。 PHP の PDO ドライバが内部ですべての生のクエリ結果をバッファーにキャッシュしているためです。です。非常に多くの Eloquent レコードを扱っている場合は、代わりに lazy メソッド の使用を検討してください。

高度なサブクエリ​

サブクエリ選択​

Eloquent は、高度なサブクエリ サポートも提供しており、これにより、単一のクエリで関連テーブルから情報を取得できます。たとえば、目的地へのフライト destinations のテーブルと flights のテーブルがあると想像してみましょう。 flights テーブルには、フライトが目的地にいつ到着したかを示す arrived_at 列が含まれています。

クエリビルダの select メソッドと addSelect メソッドで利用できるサブクエリ機能を使用すると、単一のクエリを使用して、すべての destinations とその目的地に最後に到着したフライトの名前を選択できます。

use App\Models\Destination;
use App\Models\Flight;

return Destination::addSelect(['last_flight' => Flight::select('name')
    ->whereColumn('destination_id', 'destinations.id')
    ->orderByDesc('arrived_at')
    ->limit(1)
])->get();

サブクエリの順序付け​

さらに、クエリビルダの orderBy 関数はサブクエリをサポートします。引き続きフライトの例を使用します。この機能を使用して、最後のフライトが目的地に到着した時間に基づいてすべての目的地を並べ替えることができます。繰り返しますが、これは単一のデータベース クエリの実行中に行うことができます。

return Destination::orderByDesc(
    Flight::select('arrived_at')
        ->whereColumn('destination_id', 'destinations.id')
        ->orderByDesc('arrived_at')
        ->limit(1)
)->get();

単一モデル/集約の取得 (Retrieving Single Models / Aggregates)​

特定のクエリに一致するすべてのレコードを取得するだけでなく、find、first、または firstWhere メソッドを使用して単一のレコードを取得することもできます。これらのメソッドは、モデルのコレクションを返す代わりに、単一のモデル インスタンスを返します。

use App\Models\Flight;

// Retrieve a model by its primary key...
$flight = Flight::find(1);

// Retrieve the first model matching the query constraints...
$flight = Flight::where('active', 1)->first();

// Alternative to retrieving the first model matching the query constraints...
$flight = Flight::firstWhere('active', 1);

場合によっては、クエリの最初の結果を取得したり、結果が見つからない場合に他のアクションを実行したりしたい場合があります。 firstOr メソッドは、クエリに一致する最初の結果を返します。結果が見つからない場合は、指定されたクロージャを実行します。クロージャによって返される値は、firstOr メソッドの結果とみなされます。

$model = Flight::where('legs', '>', 3)->firstOr(function () {
    // ...
});

例外が見つかりませんでした​

モデルが見つからない場合に例外をスローしたい場合があります。これは、ルートまたはコントローラで特に便利です。 findOrFail メソッドと firstOrFail メソッドは、クエリの最初の結果を取得します。ただし、結果が見つからない場合は、Illuminate\Database\Eloquent\ModelNotFoundException がスローされます。

$flight = Flight::findOrFail(1);

$flight = Flight::where('legs', '>', 3)->firstOrFail();

ModelNotFoundException が捕捉されない場合、404 HTTP 応答が自動的にクライアントに返されます。

use App\Models\Flight;

Route::get('/api/flights/{id}', function ($id) {
    return Flight::findOrFail($id);
});

モデルの取得または作成​

firstOrCreate メソッドは、指定された列と値のペアを使用してデータベース レコードの検索を試みます。モデルがデータベースで見つからない場合は、最初の配列引数とオプションの 2 番目の配列引数をマージした結果の属性を持つレコードが挿入されます。

firstOrNew メソッドは、firstOrCreate と同様に、指定された属性に一致するデータベース内のレコードを検索しようとします。ただし、モデルが見つからない場合は、新しいモデル インスタンスが返されます。 firstOrNew によって返されたモデルはまだデータベースに永続化されていないことに注意してください。 save メソッドを手動で呼び出して永続化する必要があります。

use App\Models\Flight;

// Retrieve flight by name or create it if it doesn't exist...
$flight = Flight::firstOrCreate([
    'name' => 'London to Paris'
]);

// Retrieve flight by name or create it with the name, delayed, and arrival_time attributes...
$flight = Flight::firstOrCreate(
    ['name' => 'London to Paris'],
    ['delayed' => 1, 'arrival_time' => '11:30']
);

// Retrieve flight by name or instantiate a new Flight instance...
$flight = Flight::firstOrNew([
    'name' => 'London to Paris'
]);

// Retrieve flight by name or instantiate with the name, delayed, and arrival_time attributes...
$flight = Flight::firstOrNew(
    ['name' => 'Tokyo to Sydney'],
    ['delayed' => 1, 'arrival_time' => '11:30']
);

集計の取得​

Eloquent モデルを操作するときは、Laravel クエリビルダ によって提供される count、sum、max、およびその他の 集約メソッド を使用することもできます。ご想像のとおり、これらのメソッドは Eloquent モデル インスタンスの代わりにスカラー値を返します。

$count = Flight::where('active', 1)->count();

$max = Flight::where('active', 1)->max('price');

モデルの挿入と更新 (Inserting & Updating Models)​

インサート​

もちろん、Eloquent を使用する場合、データベースからモデルを取得するだけではありません。新しいレコードを挿入する必要もあります。ありがたいことに、Eloquent を使用するとそれが簡単になります。新しいレコードをデータベースに挿入するには、新しいモデル インスタンスをインスタンス化し、モデルに属性を設定する必要があります。次に、モデル インスタンスで save メソッドを呼び出します。

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Models\Flight;
use Illuminate\Http\Request;

class FlightController extends Controller
{
    /**
     * Store a new flight in the database.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        // Validate the request...

        $flight = new Flight;

        $flight->name = $request->name;

        $flight->save();
    }
}

この例では、受信 HTTP リクエストの name フィールドを、App\Models\Flight モデル インスタンスの name 属性に割り当てます。 save メソッドを呼び出すと、レコードがデータベースに挿入されます。モデルの created_at および updated_at タイムスタンプは、save メソッドが呼び出されるときに自動的に設定されるため、手動で設定する必要はありません。

あるいは、create メソッドを使用して、単一の PHP ステートメントを使用して新しいモデルを「保存」することもできます。挿入されたモデル インスタンスは、create メソッドによって返されます。

use App\Models\Flight;

$flight = Flight::create([
    'name' => 'London to Paris',
]);

ただし、create メソッドを使用する前に、モデル クラスで fillable または guarded プロパティを指定する必要があります。すべての Eloquent モデルはデフォルトで一括割り当ての脆弱性から保護されているため、これらのプロパティが必要です。一括割り当ての詳細については、一括割り当てのドキュメント を参照してください。

アップデート​

save メソッドは、データベースにすでに存在するモデルを更新するために使用することもできます。モデルを更新するには、モデルを取得し、更新する属性を設定する必要があります。次に、モデルの save メソッドを呼び出す必要があります。繰り返しますが、updated_at タイムスタンプは自動的に更新されるため、その値を手動で設定する必要はありません。

use App\Models\Flight;

$flight = Flight::find(1);

$flight->name = 'Paris to London';

$flight->save();

一括アップデート​

特定のクエリに一致するモデルに対して更新を実行することもできます。この例では、active で、destination が San Diego であるすべてのフライトが遅延としてマークされます。

Flight::where('active', 1)
      ->where('destination', 'San Diego')
      ->update(['delayed' => 1]);

update メソッドは、更新する必要がある列を表す列と値のペアの配列を予期します。 update メソッドは、影響を受ける行の数を返します。

{note} Eloquent 経由で一括更新を発行する場合、更新されたモデルに対して saving、saved、updating、および updated モデル イベントは起動されません。これは、一括更新を発行するときにモデルが実際には取得されないためです。

属性変更の検査​

Eloquent は、モデルの内部状態を検査し、モデルが最初に取得されたときからその属性がどのように変化したかを判断するための、isDirty、isClean、および wasChanged メソッドを提供します。

isDirty メソッドは、モデルの取得後にモデルの属性のいずれかが変更されたかどうかを判断します。特定の属性名を isDirty メソッドに渡して、特定の属性がダーティかどうかを判断できます。 isClean は、モデルが取得されてから属性が変更されていないかを判断します。このメソッドはオプションの属性引数も受け入れます。

use App\Models\User;

$user = User::create([
    'first_name' => 'Taylor',
    'last_name' => 'Otwell',
    'title' => 'Developer',
]);

$user->title = 'Painter';

$user->isDirty(); // true
$user->isDirty('title'); // true
$user->isDirty('first_name'); // false

$user->isClean(); // false
$user->isClean('title'); // false
$user->isClean('first_name'); // true

$user->save();

$user->isDirty(); // false
$user->isClean(); // true

wasChanged メソッドは、現在のリクエスト サイクル内でモデルが最後に保存されたときに属性が変更されたかどうかを判断します。必要に応じて、属性名を渡して、特定の属性が変更されたかどうかを確認できます。

$user = User::create([
    'first_name' => 'Taylor',
    'last_name' => 'Otwell',
    'title' => 'Developer',
]);

$user->title = 'Painter';

$user->save();

$user->wasChanged(); // true
$user->wasChanged('title'); // true
$user->wasChanged('first_name'); // false

getOriginal メソッドは、取得後のモデルへの変更に関係なく、モデルの元の属性を含む配列を返します。必要に応じて、特定の属性名を渡して、特定の属性の元の値を取得できます。

$user = User::find(1);

$user->name; // John
$user->email; // [email protected]

$user->name = "Jack";
$user->name; // Jack

$user->getOriginal('name'); // John
$user->getOriginal(); // Array of original attributes...

一括割り当て​

create メソッドを使用すると、単一の PHP ステートメントを使用して新しいモデルを「保存」できます。挿入されたモデル インスタンスは、次のメソッドによって返されます。

use App\Models\Flight;

$flight = Flight::create([
    'name' => 'London to Paris',
]);

ただし、create メソッドを使用する前に、モデル クラスで fillable または guarded プロパティを指定する必要があります。すべての Eloquent モデルはデフォルトで一括割り当ての脆弱性から保護されているため、これらのプロパティが必要です。

一括割り当ての脆弱性は、ユーザーが予期しない HTTP リクエスト フィールドを渡し、そのフィールドがデータベース内の予期しない列を変更した場合に発生します。たとえば、悪意のあるユーザーが HTTP リクエストを通じて is_admin パラメーターを送信し、それがモデルの create メソッドに渡されることで、ユーザーが管理者にエスカレーションできるようになります。

したがって、まず、どのモデル属性を一括割り当て可能にするかを定義する必要があります。これは、モデルの $fillable プロパティを使用して行うことができます。たとえば、Flight モデルの name 属性を一括割り当て可能にしてみましょう。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model
{
    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = ['name'];
}

どの属性を一括割り当て可能にするかを指定したら、create メソッドを使用してデータベースに新しいレコードを挿入できます。 create メソッドは、新しく作成されたモデル インスタンスを返します。

$flight = Flight::create(['name' => 'London to Paris']);

すでにモデル インスタンスがある場合は、fill メソッドを使用して属性の配列を設定できます。

$flight->fill(['name' => 'Amsterdam to Frankfurt']);

一括割り当てと JSON 列​

JSON 列を割り当てるときは、各列の一括割り当て可能キーをモデルの $fillable 配列で指定する必要があります。セキュリティのため、Laravel は、guarded プロパティを使用する場合のネストされた JSON 属性の更新をサポートしていません。

/**
 * The attributes that are mass assignable.
 *
 * @var array
 */
protected $fillable = [
    'options->enabled',
];

一括割り当ての許可​

すべての属性を一括割り当て可能にしたい場合は、モデルの $guarded プロパティを空の配列として定義できます。モデルの保護を解除することを選択した場合は、Eloquent の fill、create、および update メソッドに渡される配列を常に手動で作成するように特別な注意を払う必要があります。

/**
 * The attributes that aren't mass assignable.
 *
 * @var array
 */
protected $guarded = [];

アップサート​

場合によっては、既存のモデルを更新するか、一致するモデルが存在しない場合は新しいモデルを作成することが必要になることがあります。 firstOrCreate メソッドと同様、updateOrCreate メソッドはモデルを保持するため、save メソッドを手動で呼び出す必要はありません。

以下の例では、Oakland の departure 位置と San Diego の destination 位置を持つフライトが存在する場合、その price 列と discounted 列が更新されます。そのようなフライトが存在しない場合は、最初の引数の配列と 2 番目の引数の配列をマージした結果の属性を持つ新しいフライトが作成されます。

$flight = Flight::updateOrCreate(
    ['departure' => 'Oakland', 'destination' => 'San Diego'],
    ['price' => 99, 'discounted' => 1]
);

1 つのクエリで複数の「更新/挿入」を実行する場合は、代わりに upsert メソッドを使用する必要があります。メソッドの最初の引数は挿入または更新する値で構成され、2 番目の引数は関連するテーブル内のレコードを一意に識別する列をリストします。このメソッドの 3 番目と最後の引数は、一致するレコードがデータベースにすでに存在する場合に更新する必要がある列の配列です。モデルでタイムスタンプが有効になっている場合、upsert メソッドは、created_at および updated_at タイムスタンプを自動的に設定します。

Flight::upsert([
    ['departure' => 'Oakland', 'destination' => 'San Diego', 'price' => 99],
    ['departure' => 'Chicago', 'destination' => 'New York', 'price' => 150]
], ['departure', 'destination'], ['price']);

モデルの削除 (Deleting Models)​

モデルを削除するには、モデル インスタンスで delete メソッドを呼び出します。

use App\Models\Flight;

$flight = Flight::find(1);

$flight->delete();

truncate メソッドを呼び出して、モデルに関連付けられたすべてのデータベース レコードを削除できます。 truncate 操作は、モデルに関連付けられたテーブル上の自動インクリメント ID もリセットします。

Flight::truncate();

主キーによる既存のモデルの削除​

上の例では、delete メソッドを呼び出す前にデータベースからモデルを取得しています。ただし、モデルの主キーがわかっている場合は、destroy メソッドを呼び出して明示的に取得しなくても、モデルを削除できます。 destroy メソッドは、単一の主キーを受け入れることに加えて、複数の主キー、主キーの配列、または主キーの collection を受け入れます。

Flight::destroy(1);

Flight::destroy(1, 2, 3);

Flight::destroy([1, 2, 3]);

Flight::destroy(collect([1, 2, 3]));

{note} destroy メソッドは、各モデルを個別にロードし、delete メソッドを呼び出して、deleting および deleted イベントがモデルごとに適切にディスパッチされるようにします。

クエリを使用したモデルの削除​

もちろん、Eloquent クエリを作成して、クエリの条件に一致するすべてのモデルを削除することもできます。この例では、非アクティブとしてマークされているすべてのフライトを削除します。一括更新と同様に、一括削除では、削除されたモデルのモデル イベントは送出されません。

$deleted = Flight::where('active', 0)->delete();

{note} Eloquent 経由で一括削除ステートメントを実行する場合、削除されたモデルに対して deleting および deleted モデル イベントはディスパッチされません。これは、delete ステートメントの実行時にモデルが実際に取得されないためです。

ソフト削除​

実際にデータベースからレコードを削除するだけでなく、Eloquent はモデルを「論理的に削除」することもできます。モデルが論理的に削除されても、実際にはデータベースから削除されません。代わりに、モデルが「削除」された日時を示す deleted_at 属性がモデルに設定されます。モデルの論理的な削除を有効にするには、Illuminate\Database\Eloquent\SoftDeletes 特性をモデルに追加します。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class Flight extends Model
{
    use SoftDeletes;
}

{tip} SoftDeletes トレイトは、deleted_at 属性を DateTime / Carbon インスタンスに自動的にキャストします。

deleted_at 列もデータベース テーブルに追加する必要があります。 Laravel スキーマビルダ には、この列を作成するためのヘルパ メソッドが含まれています。

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

Schema::table('flights', function (Blueprint $table) {
    $table->softDeletes();
});

Schema::table('flights', function (Blueprint $table) {
    $table->dropSoftDeletes();
});

ここで、モデルで delete メソッドを呼び出すと、deleted_at 列が現在の日付と時刻に設定されます。ただし、モデルのデータベース レコードはテーブルに残ります。論理的な削除を使用するモデルをクエリすると、論理的に削除されたモデルはすべてのクエリ結果から自動的に除外されます。

特定のモデル インスタンスが論理的に削除されたかどうかを確認するには、trashed メソッドを使用できます。

if ($flight->trashed()) {
    //
}

論理的に削除されたモデルの復元​

場合によっては、論理的に削除されたモデルの「削除を取り消し」たい場合があります。論理的に削除されたモデルを復元するには、モデル インスタンスで restore メソッドを呼び出すことができます。 restore メソッドは、モデルの deleted_at 列を null に設定します。

$flight->restore();

クエリで restore メソッドを使用して、複数のモデルを復元することもできます。繰り返しますが、他の「一括」操作と同様に、これは復元されるモデルのモデル イベントをディスパッチしません。

Flight::withTrashed()
        ->where('airline_id', 1)
        ->restore();

restore メソッドは、relationship クエリを構築するときにも使用できます。

$flight->history()->restore();

モデルを完全に削除する​

場合によっては、データベースからモデルを完全に削除する必要がある場合があります。 forceDelete メソッドを使用して、論理的に削除されたモデルをデータベース テーブルから完全に削除できます。

$flight->forceDelete();

Eloquent リレーションシップ クエリを構築するときに、forceDelete メソッドを使用することもできます。

$flight->history()->forceDelete();

論理的に削除されたモデルのクエリ​

ソフト削除されたモデルを含む​

上で述べたように、論理的に削除されたモデルはクエリ結果から自動的に除外されます。ただし、クエリで withTrashed メソッドを呼び出すことで、論理的に削除されたモデルをクエリの結果に強制的に含めることができます。

use App\Models\Flight;

$flights = Flight::withTrashed()
                ->where('account_id', 1)
                ->get();

withTrashed メソッドは、relationship クエリを構築するときに呼び出すこともできます。

$flight->history()->withTrashed()->get();

論理的に削除されたモデルのみを取得する​

onlyTrashed メソッドは、のみ 論理的に削除されたモデルを取得します。

$flights = Flight::onlyTrashed()
                ->where('airline_id', 1)
                ->get();

モデルの枝刈り (Pruning Models)​

不要になったモデルを定期的に削除したい場合があります。これを実現するには、定期的にプルーニングしたいモデルに Illuminate\Database\Eloquent\Prunable または Illuminate\Database\Eloquent\MassPrunable 特性を追加します。特性の 1 つをモデルに追加した後、不要になったモデルを解決する Eloquent クエリビルダを返す prunable メソッドを実装します。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Prunable;

class Flight extends Model
{
    use Prunable;

    /**
     * Get the prunable model query.
     *
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function prunable()
    {
        return static::where('created_at', '<=', now()->subMonth());
    }
}

モデルを Prunable としてマークする場合、モデルに pruning メソッドを定義することもできます。このメソッドは、モデルが削除される前に呼び出されます。このメソッドは、モデルがデータベースから完全に削除される前に、保存されたファイルなど、モデルに関連付けられた追加のリソースを削除する場合に役立ちます。

/**
 * Prepare the model for pruning.
 *
 * @return void
 */
protected function pruning()
{
    //
}

プルーナブル モデルを構成した後、アプリケーションの App\Console\Kernel クラスで model:prune Artisan コマンドをスケジュールする必要があります。このコマンドを実行する適切な間隔を自由に選択できます。

/**
 * Define the application's command schedule.
 *
 * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
 * @return void
 */
protected function schedule(Schedule $schedule)
{
    $schedule->command('model:prune')->daily();
}

バックグラウンドで、model:prune コマンドは、アプリケーションの app/Models ディレクトリ内の「Prunable」モデルを自動的に検出します。モデルが別の場所にある場合は、--model オプションを使用してモデル クラス名を指定できます。

$schedule->command('model:prune', [
    '--model' => [Address::class, Flight::class],
])->daily();

検出された他のすべてのモデルをプルーニングする一方で、特定のモデルをプルーニングから除外したい場合は、--except オプションを使用できます。

$schedule->command('model:prune', [
    '--except' => [Address::class, Flight::class],
])->daily();

--pretend オプションを指定して model:prune コマンドを実行することで、prunable クエリをテストできます。ふりをするとき、model:prune コマンドは、コマンドが実際に実行された場合にプルーニングされるレコードの数を単純に報告します。

php artisan model:prune --pretend

{note} 論理的な削除モデルは、削除可能なクエリに一致する場合、完全に削除されます (forceDelete)。

大量剪定​

モデルが Illuminate\Database\Eloquent\MassPrunable 特性でマークされている場合、モデルは一括削除クエリを使用してデータベースから削除されます。したがって、pruning メソッドは呼び出されず、deleting および deleted モデル イベントも送出されません。これは、削除前にモデルが実際に取得されることがないため、プルーニング プロセスがはるかに効率的になるためです。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\MassPrunable;

class Flight extends Model
{
    use MassPrunable;

    /**
     * Get the prunable model query.
     *
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function prunable()
    {
        return static::where('created_at', '<=', now()->subMonth());
    }
}

モデルの複製 (Replicating Models)​

replicate メソッドを使用して、既存のモデル インスタンスの保存されていないコピーを作成できます。この方法は、同じ属性を多く共有するモデル インスタンスがある場合に特に便利です。

use App\Models\Address;

$shipping = Address::create([
    'type' => 'shipping',
    'line_1' => '123 Example Street',
    'city' => 'Victorville',
    'state' => 'CA',
    'postcode' => '90001',
]);

$billing = $shipping->replicate()->fill([
    'type' => 'billing'
]);

$billing->save();

新しいモデルへのレプリケートから 1 つ以上の属性を除外するには、配列を replicate メソッドに渡すことができます。

$flight = Flight::create([
    'destination' => 'LAX',
    'origin' => 'LHR',
    'last_flown' => '2020-03-04 11:00:00',
    'last_pilot_id' => 747,
]);

$flight = $flight->replicate([
    'last_flown',
    'last_pilot_id'
]);

クエリのスコープ (Query Scopes)​

グローバルスコープ​

グローバル スコープを使用すると、特定のモデルのすべてのクエリに制約を追加できます。 Laravel 独自の ソフトデリート 機能は、グローバル スコープを利用して、データベースから「削除されていない」モデルのみを取得します。独自のグローバル スコープを作成すると、特定のモデルに対するすべてのクエリが特定の制約を受けるようにする便利で簡単な方法が提供されます。

グローバル スコープの作成​

グローバル スコープの記述は簡単です。まず、Illuminate\Database\Eloquent\Scope インターフェイスを実装するクラスを定義します。 Laravel にはスコープクラスを配置する従来の場所がないため、このクラスを任意のディレクトリに自由に配置できます。

Scope インターフェイスでは、apply という 1 つのメソッドを実装する必要があります。 apply メソッドは、必要に応じて、where 制約または他のタイプの句をクエリに追加できます。

<?php

namespace App\Scopes;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;

class AncientScope implements Scope
{
    /**
     * Apply the scope to a given Eloquent query builder.
     *
     * @param  \Illuminate\Database\Eloquent\Builder  $builder
     * @param  \Illuminate\Database\Eloquent\Model  $model
     * @return void
     */
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('created_at', '<', now()->subYears(2000));
    }
}

{tip} グローバル スコープがクエリの select 句に列を追加している場合は、select の代わりに addSelect メソッドを使用する必要があります。これにより、クエリの既存の select 句が意図せず置換されるのを防ぎます。

グローバル スコープの適用​

グローバル スコープをモデルに割り当てるには、モデルの booted メソッドをオーバーライドし、モデルの addGlobalScope メソッドを呼び出す必要があります。 addGlobalScope メソッドは、スコープのインスタンスを唯一の引数として受け入れます。

<?php

namespace App\Models;

use App\Scopes\AncientScope;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * The "booted" method of the model.
     *
     * @return void
     */
    protected static function booted()
    {
        static::addGlobalScope(new AncientScope);
    }
}

上の例のスコープを App\Models\User モデルに追加した後、User::all() メソッドの呼び出しによって次の SQL クエリが実行されます。

select * from `users` where `created_at` < 0021-02-18 00:00:00

匿名グローバルスコープ​

Eloquent では、クロージャを使用してグローバル スコープを定義することもできます。これは、独自の別のクラスを保証しない単純なスコープに特に役立ちます。クロージャを使用してグローバル スコープを定義する場合は、addGlobalScope メソッドの最初の引数として独自に選択したスコープ名を指定する必要があります。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * The "booted" method of the model.
     *
     * @return void
     */
    protected static function booted()
    {
        static::addGlobalScope('ancient', function (Builder $builder) {
            $builder->where('created_at', '<', now()->subYears(2000));
        });
    }
}

グローバル スコープの削除​

特定のクエリのグローバル スコープを削除したい場合は、withoutGlobalScope メソッドを使用できます。このメソッドは、グローバル スコープのクラス名を唯一の引数として受け入れます。

User::withoutGlobalScope(AncientScope::class)->get();

または、クロージャを使用してグローバル スコープを定義した場合は、グローバル スコープに割り当てた文字列名を渡す必要があります。

User::withoutGlobalScope('ancient')->get();

クエリのグローバル スコープの一部またはすべてを削除したい場合は、withoutGlobalScopes メソッドを使用できます。

// Remove all of the global scopes...
User::withoutGlobalScopes()->get();

// Remove some of the global scopes...
User::withoutGlobalScopes([
    FirstScope::class, SecondScope::class
])->get();

ローカルスコープ​

ローカル スコープを使用すると、アプリケーション全体で簡単に再利用できるクエリ制約の共通セットを定義できます。たとえば、「人気がある」と考えられるすべてのユーザーを頻繁に取得する必要がある場合があります。スコープを定義するには、Eloquent モデル メソッドの前に scope を付けます。

スコープは常に同じクエリビルダ インスタンスまたは void を返す必要があります。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * Scope a query to only include popular users.
     *
     * @param  \Illuminate\Database\Eloquent\Builder  $query
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopePopular($query)
    {
        return $query->where('votes', '>', 100);
    }

    /**
     * Scope a query to only include active users.
     *
     * @param  \Illuminate\Database\Eloquent\Builder  $query
     * @return void
     */
    public function scopeActive($query)
    {
        $query->where('active', 1);
    }
}

ローカルスコープの利用​

スコープを定義したら、モデルをクエリするときにスコープ メソッドを呼び出すことができます。ただし、メソッドを呼び出すときに scope プレフィックスを含めないでください。呼び出しをさまざまなスコープにチェーンすることもできます。

use App\Models\User;

$users = User::popular()->active()->orderBy('created_at')->get();

or クエリ演算子を介して複数の Eloquent モデル スコープを結合するには、正しい 論理グループ化 を実現するためにクロージャーの使用が必要になる場合があります。

$users = User::popular()->orWhere(function (Builder $query) {
    $query->active();
})->get();

ただし、これは面倒になる可能性があるため、Laravel では、クロージャを使用せずにスコープをスムーズにチェーンできる「高次」の orWhere メソッドを提供しています。

$users = App\Models\User::popular()->orWhere->active()->get();

ダイナミックスコープ​

パラメータを受け入れるスコープを定義したい場合があります。まず、追加のパラメーターをスコープ メソッドのシグネチャに追加するだけです。スコープ パラメーターは、$query パラメーターの後に定義する必要があります。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * Scope a query to only include users of a given type.
     *
     * @param  \Illuminate\Database\Eloquent\Builder  $query
     * @param  mixed  $type
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function scopeOfType($query, $type)
    {
        return $query->where('type', $type);
    }
}

期待される引数がスコープ メソッドのシグネチャに追加されたら、スコープを呼び出すときに引数を渡すことができます。

$users = User::ofType('admin')->get();

モデルの比較 (Comparing Models)​

場合によっては、2 つのモデルが「同じ」かどうかを判断する必要がある場合があります。 is メソッドと isNot メソッドを使用すると、2 つのモデルに同じ主キー、テーブル、データベース接続があるかどうかを迅速に検証できます。

if ($post->is($anotherPost)) {
    //
}

if ($post->isNot($anotherPost)) {
    //
}

is および isNot メソッドは、belongsTo、hasOne、morphTo、および morphOne relationships を使用する場合にも使用できます。この方法は、モデルを取得するためのクエリを発行せずに関連モデルを比較したい場合に特に役立ちます。

if ($post->author()->is($user)) {
    //
}

イベント (Events)​

{tip} Eloquent イベントをクライアント側アプリケーションに直接ブロードキャストしたいですか? Laravel の モデルイベント放送 をチェックしてください。

Eloquent モデルはいくつかのイベントをディスパッチし、モデルのライフサイクルの次の瞬間にフックできるようにします: retrieved、creating、created、updating、updated、saving、saved、deleting、 deleted、restoring、restored、および replicating。

retrieved イベントは、既存のモデルがデータベースから取得されるときに送出されます。新しいモデルが初めて保存されると、creating および created イベントが送出されます。 updating / updated イベントは、既存のモデルが変更され、save メソッドが呼び出されたときに送出されます。 saving / saved イベントは、モデルの属性が変更されていない場合でも、モデルが作成または更新されるときに送出されます。 -ing で終わるイベント名はモデルへの変更が永続化される前に送出されますが、-ed で終わるイベントはモデルへの変更が永続化された後に送出されます。

モデル イベントのリスニングを開始するには、Eloquent モデルで $dispatchesEvents プロパティを定義します。このプロパティは、Eloquent モデルのライフサイクルのさまざまなポイントを独自の イベントクラス にマップします。各モデル イベント クラスは、コンストラクターを介して影響を受けるモデルのインスタンスを受け取ることを期待する必要があります。

<?php

namespace App\Models;

use App\Events\UserDeleted;
use App\Events\UserSaved;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * The event map for the model.
     *
     * @var array
     */
    protected $dispatchesEvents = [
        'saved' => UserSaved::class,
        'deleted' => UserDeleted::class,
    ];
}

Eloquent イベントを定義してマッピングした後、イベントリスナ を使用してイベントを処理できます。

{note} Eloquent 経由で一括更新または削除クエリを発行する場合、saved、updated、deleting、および deleted モデル イベントは、影響を受けるモデルに対して送出されません。これは、一括更新または削除を実行するときにモデルが実際には取得されないためです。

クロージャの使用​

カスタム イベント クラスを使用する代わりに、さまざまなモデル イベントがディスパッチされたときに実行されるクロージャを登録できます。通常、これらのクロージャはモデルの booted メソッドに登録する必要があります。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * The "booted" method of the model.
     *
     * @return void
     */
    protected static function booted()
    {
        static::created(function ($user) {
            //
        });
    }
}

必要に応じて、モデル イベントを登録するときに キュー可能な匿名イベント リスナ を利用できます。これにより、アプリケーションの queue を使用してバックグラウンドでモデル イベント リスナを実行するように Laravel に指示されます。

use function Illuminate\Events\queueable;

static::created(queueable(function ($user) {
    //
}));

オブザーバ​

オブザーバの定義​

特定のモデルで多くのイベントをリッスンしている場合は、オブザーバを使用してすべてのリスナを 1 つのクラスにグループ化できます。 Observer クラスには、リッスンしたい Eloquent イベントを反映するメソッド名が付いています。これらの各メソッドは、影響を受けるモデルを唯一の引数として受け取ります。 make:observer Artisan コマンドは、新しいオブザーバ クラスを作成する最も簡単な方法です。

php artisan make:observer UserObserver --model=User

このコマンドは、新しいオブザーバを App/Observers ディレクトリに配置します。このディレクトリが存在しない場合は、Artisan が作成します。新しいオブザーバは次のようになります。

<?php

namespace App\Observers;

use App\Models\User;

class UserObserver
{
    /**
     * Handle the User "created" event.
     *
     * @param  \App\Models\User  $user
     * @return void
     */
    public function created(User $user)
    {
        //
    }

    /**
     * Handle the User "updated" event.
     *
     * @param  \App\Models\User  $user
     * @return void
     */
    public function updated(User $user)
    {
        //
    }

    /**
     * Handle the User "deleted" event.
     *
     * @param  \App\Models\User  $user
     * @return void
     */
    public function deleted(User $user)
    {
        //
    }

    /**
     * Handle the User "forceDeleted" event.
     *
     * @param  \App\Models\User  $user
     * @return void
     */
    public function forceDeleted(User $user)
    {
        //
    }
}

オブザーバを登録するには、監視するモデルで observe メソッドを呼び出す必要があります。アプリケーションの App\Providers\EventServiceProvider サービスプロバイダの boot メソッドでオブザーバを登録できます。

use App\Models\User;
use App\Observers\UserObserver;

/**
 * Register any events for your application.
 *
 * @return void
 */
public function boot()
{
    User::observe(UserObserver::class);
}

{tip} saving や retrieved など、オブザーバがリッスンできる追加のイベントがあります。これらのイベントについては、events ドキュメント内で説明されています。

オブザーバとデータベーストランザクション​

データベース トランザクション内でモデルが作成されている場合、データベース トランザクションがコミットされた後にのみイベント ハンドラーを実行するようにオブザーバに指示することができます。これを実現するには、オブザーバで $afterCommit プロパティを定義します。データベース トランザクションが進行中でない場合、イベント ハンドラーはすぐに実行されます。

<?php

namespace App\Observers;

use App\Models\User;

class UserObserver
{
    /**
     * Handle events after all transactions are committed.
     *
     * @var bool
     */
    public $afterCommit = true;

    /**
     * Handle the User "created" event.
     *
     * @param  \App\Models\User  $user
     * @return void
     */
    public function created(User $user)
    {
        //
    }
}

イベントのミュート​

場合によっては、モデルによって起動されるすべてのイベントを一時的に「ミュート」する必要がある場合があります。これは、withoutEvents メソッドを使用して実現できます。 withoutEvents メソッドは、唯一の引数としてクロージャを受け入れます。このクロージャ内で実行されるコードはモデル イベントをディスパッチせず、クロージャによって返される値は withoutEvents メソッドによって返されます。

use App\Models\User;

$user = User::withoutEvents(function () use () {
    User::findOrFail(1)->delete();

    return User::find(2);
});

イベントなしの単一モデルの保存​

場合によっては、イベントを送出せずに特定のモデルを「保存」したい場合があります。これは、saveQuietly メソッドを使用して実行できます。

$user = User::findOrFail(1);

$user->name = 'Victoria Faith';

$user->saveQuietly();