Laravel Eloquent ORM を理解する

Eloquent とは

Eloquent とは、Laravel の「ORM」、つまりオブジェクト リレーショナル マッピングである「Object Relational Mapping」です。 ORM の登場は、データベース操作をより便利にするために役立ちます。 Eloquent では、「モデル クラス」をデータベース テーブルに対応させることができ、最下層に多くの「関数」をカプセル化しているため、モデル クラスの呼び出しが非常に便利になります。すべての Eloquent モデルは IlluminateDatabaseEloquentModel を継承します。

make:model コマンドを使用して Eloquent モデルを自動的に生成します:

php artisan make:model Article -m

-m パラメーター: このモデルに対応する記事テーブルを自動的に生成します

php artisan make:migration create_articles_table --create=articles

モデルに対応するテーブルを作成します (= 後でテーブル名を指定します)

注: モデルがどのデータベース テーブルを使用するかは Eloquent には伝えません。特別な指定がない場合、デフォルトではシステムが自動的に「クラス名の小文字複数形」という名前でデータベーステーブルに対応します。したがって、上記の例では、Eloquent は Article モデルがデータを Article データベース テーブルに保存すると想定します。クラスで table 属性を定義して、対応するデータベース テーブルをカスタマイズすることもできます。

class User extends Model {    protected $table = 'your_table';}

バッチ割り当て

新しいモデルを構築するときに、ユーザー入力をモデル データに盲目的に書き込むと、重大なセキュリティ リスクが発生する可能性があります。このため、すべての Eloquent モデルでは、デフォルトでバッチ割り当てが禁止されています。

fillable 属性は、バッチ割り当てをサポートするフィールドを指定します。クラスの属性内、またはインスタンス化後に設定できます。

class Article extends Model {    protected $fillable = ['title', 'content', 'email'];}

上記の例では、バッチ割り当てを許可する属性 (テーブル内のフィールド) は 3 つだけです。

ガードは fillable の逆で、「ホワイトリスト」ではなく「ブラックリスト」として使用されます。

class Article extends Model {    protected $guarded = ['id', 'password'];}

上記の例では、id 属性とパスワード属性は使用されません。バッチで割り当てられますが、その他すべてのプロパティではバッチ割り当てが可能です。また、ガード属性を使用して、すべての属性がバッチで割り当てられるのを防ぐこともできます

hidden 属性は、どのフィールドを非表示にするかを指定し、出力されても表示されません

class Article extends Model {    protected $hidden = ['id', 'password'];}

Basic使用法

ドキュメントの詳細を参照してください

ID 2 のドキュメントを見つけて、そのタイトルを出力します

$article = Article::find(2);echo $article->title;

場合によっては、モデル データが見つからない場合は、firstOrFail メソッドを通じて例外をスローします。

$article = Article::findOrFail(100);echo $article->title;

「I am the title」というタイトルの記事を検索し、ID を出力します

$article = Article::where('title', '我是标题')->first();echo $article->id;

すべての記事をクエリし、ループですべてのタイトルを出力します

$articles = Article::all(); // 此处得到的 $articles 是一个对象集合，可以在后面加上 '->toArray()' 变成多维数组。foreach ($articles as $article) {    echo $article->title;}

ID が 10 ～ 20 のすべての記事を検索し、すべてのタイトルを出力します

$articles = Article::where('id', '>', 10)->where('id', '<', 20)->get();foreach ($articles as $article) {    echo $article->title;}

すべての記事をクエリしてループ内ですべてのタイトルを出力し、updated_at に従って逆順に並べ替えます

$articles = Article::where('id', '>', 10)->where('id', '<', 20)->orderBy('updated_at', 'desc')->get();foreach ($articles as $article) {    echo $article->title;}

キーポイントの使用

1. Eloquent を継承するすべてのクラスには 2 つの「固定使用法」 Article::find($number) Article::all() があり、前者は値を取得するオブジェクトを含むデータベースは、データベース全体を含むオブジェクトのコレクションを取得します。

2. where() orderBy() などのすべての中間メソッドは、「静的」呼び出しと「非静的チェーン」呼び出しの両方、つまり Article::where() をサポートできます。 .および記事::....->where()。

3. すべての「固定されていない使用方法」呼び出しには、最終的に「終了」するための操作が必要です。このチュートリアルには、->get() と -> という 2 つの「終了操作」があります。初め（）。