Readouble

Laravel 5.1 Eloquent:コレクション

イントロダクションIntroduction

getメソッドであれリレーションによるものであれ、Eloquentが複数のレコードをリターンする場合Illuminate\Database\Eloquent\Collectionオブジェクトが返されます。EloquentコレクションオブジェクトはLaravelのベースコレクションを継承しているので、Eloquentモデルの裏にある配列をスムーズに操作するために継承した多くのメソッドがもちろん使用できます。All multi-result sets returned by Eloquent are an instance of the Illuminate\Database\Eloquent\Collection object, including results retrieved via the get method or accessed via a relationship. The Eloquent collection object extends the Laravel base collection[/docs/{{version}}/collections], so it naturally inherits dozens of methods used to fluently work with the underlying array of Eloquent models.

当然ながら全コレクションはイリテーターとしても動作し、シンプルなPHP配列のようにループで取り扱うことができます。Of course, all collections also serve as iterators, allowing you to loop over them as if they were simple PHP arrays:

$users = App\User::where('active'、1)->get();

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

しかしコレクションは配列よりもパワフルで直感的なインターフェイスを使ったメソッドチェーンにより、マッピングや要素の省略操作を行うことができます。例としてアクティブでないモデルを削除し、残ったユーザーのファーストネームを集めてみましょう。However, collections are much more powerful than arrays and expose a variety of map / reduce operations using an intuitive interface. For example, let's remove all inactive models and gather the first name for each remaining user:

$users = App\User::where('active'、1)->get();

$names = $users->reject(function ($user) {
    return $user->active === false;
})
->map(function ($user) {
    return $user->name;
});

使用できるメソッドAvailable Methods

ベースのコレクションThe Base Collection

全EloquentコレクションはベースのLaravelコレクションオブジェクトを拡張しており、そのためにベースコレクションクラスが提供しているパワフルなメソッドを全部継承しています。All Eloquent collections extend the base Laravel collection[/docs/{{version}}/collections] object; therefore, they inherit all of the powerful methods provided by the base collection class:

[all](/docs/{{version}}/collections#method-all) [chunk](/docs/{{version}}/collections#method-chunk) [collapse](/docs/{{version}}/collections#method-collapse) [contains](/docs/{{version}}/collections#method-contains) [count](/docs/{{version}}/collections#method-count) [diff](/docs/{{version}}/collections#method-diff) [each](/docs/{{version}}/collections#method-each) [every](/docs/{{version}}/collections#method-every) [filter](/docs/{{version}}/collections#method-filter) [first](/docs/{{version}}/collections#method-first) [flatten](/docs/{{version}}/collections#method-flatten) [flip](/docs/{{version}}/collections#method-flip) [forget](/docs/{{version}}/collections#method-forget) [forPage](/docs/{{version}}/collections#method-forpage) [get](/docs/{{version}}/collections#method-get) [groupBy](/docs/{{version}}/collections#method-groupby) [has](/docs/{{version}}/collections#method-has) [implode](/docs/{{version}}/collections#method-implode) [intersect](/docs/{{version}}/collections#method-intersect) [isEmpty](/docs/{{version}}/collections#method-isempty) [keyBy](/docs/{{version}}/collections#method-keyby) [keys](/docs/{{version}}/collections#method-keys) [last](/docs/{{version}}/collections#method-last) [map](/docs/{{version}}/collections#method-map) [merge](/docs/{{version}}/collections#method-merge) [pluck](/docs/{{version}}/collections#method-pluck) [pop](/docs/{{version}}/collections#method-pop) [prepend](/docs/{{version}}/collections#method-prepend) [pull](/docs/{{version}}/collections#method-pull) [push](/docs/{{version}}/collections#method-push) [put](/docs/{{version}}/collections#method-put) [random](/docs/{{version}}/collections#method-random) [reduce](/docs/{{version}}/collections#method-reduce) [reject](/docs/{{version}}/collections#method-reject) [reverse](/docs/{{version}}/collections#method-reverse) [search](/docs/{{version}}/collections#method-search) [shift](/docs/{{version}}/collections#method-shift) [shuffle](/docs/{{version}}/collections#method-shuffle) [slice](/docs/{{version}}/collections#method-slice) [sort](/docs/{{version}}/collections#method-sort) [sortBy](/docs/{{version}}/collections#method-sortby) [sortByDesc](/docs/{{version}}/collections#method-sortbydesc) [splice](/docs/{{version}}/collections#method-splice) [sum](/docs/{{version}}/collections#method-sum) [take](/docs/{{version}}/collections#method-take) [toArray](/docs/{{version}}/collections#method-toarray) [toJson](/docs/{{version}}/collections#method-tojson) [transform](/docs/{{version}}/collections#method-transform) [unique](/docs/{{version}}/collections#method-unique) [values](/docs/{{version}}/collections#method-values) [where](/docs/{{version}}/collections#method-where) [whereLoose](/docs/{{version}}/collections#method-whereloose) [zip](/docs/{{version}}/collections#method-zip)

カスタムコレクションCustom Collections

自分で拡張したメソッドを含むカスタム「コレクション」オブジェクトを使いたい場合は、モデルのnewCollectionメソッドをオーバーライドしてください。If you need to use a custom Collection object with your own extension methods, you may override the newCollection method on your model:

<?php

namespace App;

use App\CustomCollection;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * 新しいEloqunetコレクションインスタンスの生成
     *
     * @param  array  $models
     * @return \Illuminate\Database\Eloquent\Collection
     */
    public function newCollection(array $models = [])
    {
        return new CustomCollection($models);
    }
}

newCollectionメソッドを定義すれば、Eloquentがそのモデルの「コレクション」インスタンスを返す場合にいつでもカスタムコレクションのインスタンスを受け取れます。アプリケーションの全モデルでカスタムコレクションを使いたい場合は、全モデルが拡張しているモデルのベースクラスでnewCollectionメソッドをオーバーライドしてください。Once you have defined a newCollection method, you will receive an instance of your custom collection anytime Eloquent returns a Collection instance of that model. If you would like to use a custom collection for every model in your application, you should override the newCollection method on a model base class that is extended by all of your models.

章選択

設定

明暗テーマ
light_mode
dark_mode
brightness_auto システム設定に合わせる
テーマ選択
photo_size_select_actual デフォルト
photo_size_select_actual モノクローム(白黒)
photo_size_select_actual Solarized風
photo_size_select_actual GitHub風(青ベース)
photo_size_select_actual Viva(黄緑ベース)
photo_size_select_actual Happy(紫ベース)
photo_size_select_actual Mint(緑ベース)
コードハイライトテーマ選択

明暗テーマごとに、コードハイライトのテーマを指定できます。

テーマ配色確認
スクリーン表示幅
640px
80%
90%
100%

768px以上の幅があるときのドキュメント部分表示幅です。

インデント
無し
1rem
2rem
3rem
原文確認
原文を全行表示
原文を一行ずつ表示
使用しない

※ 段落末のEボタンへカーソルオンで原文をPopupします。

Diff表示形式
色分けのみで区別
行頭の±で区別
削除線と追記で区別

※ [tl!…]形式の挿入削除行の表示形式です。

Pagination和文
ペジネーション
ペギネーション
ページネーション
ページ付け
Scaffold和文
スカフォールド
スキャフォールド
型枠生成
本文フォント

総称名以外はCSSと同様に、"〜"でエスケープしてください。

コードフォント

総称名以外はCSSと同様に、"〜"でエスケープしてください。

保存内容リセット

localStrageに保存してある設定項目をすべて削除し、デフォルト状態へ戻します。

ヘッダー項目移動

キーボード操作