コレクションイントロダクションIlluminate\Support\Collectionクラスは配列データを操作するための、書きやすく使いやすいラッパーです。以下の例をご覧ください。配列から新しいコレクションインスタンスを作成するためにcollectヘルパを使用し、各要素に対しstrtoupperを実行し、それから空の要素を削除しています。empty($name);});ご覧の通り、Collectionクラスは裏にある配列をマップ操作してから要素削除するメソッドをチェーンでスムーズにつなげてくれます。元のコレクションは不変であり、すべてのCollectionメソッドは新しいCollectionインスタンスを返します。上記の通りcollectヘルパは指定された配列を元に、新しいIlluminate\Support\Collectionインスタンスを返します。コレクションの生成も同様にシンプルです。Eloquentクエリの結果は、常にCollectionインスタンスを返します。コレクションの拡張コレクションは「マクロ化可能」であり、実行時にCollectionクラスへメソッドを追加できます。Illuminate\Support\Collectionクラスのmacroメソッドは、マクロが呼び出されたときに実行するクロージャを引数に取ります。マクロクロージャは、コレクションクラスの実際のメソッドであるかのように、$thisを介してコレクションの他のメソッドにアクセスできます。次のコードは、toUpperメソッドをCollectionクラスに追加しています。'SECOND']通常、コレクションマクロはサービスプロバイダのbootメソッドで宣言する必要があります。必要に応じて、追加の引数を取るマクロを定義できます。$collection->toLocale('es');利用可能なメソッドコレクションドキュメントの残りの大部分は、Collectionクラスで使用できる各メソッドについて説明します。これらのメソッドはすべて、基になる配列をスムースに操作するためチェーン化できることを忘れないでください。ほとんどすべてのメソッドが新しいCollectionインスタンスを返すため、必要に応じて元のコレクションを保持できます。zipメソッド一覧all()allメソッドはコレクションの元の配列表現を返します。3]average()avgメソッドのエイリアスです。avg()avgメソッドは、指定したキーの平均値を返します。2chunk()chunkメソッドはコレクションを指定したサイズで複数の小さなコレクションに分割します。7]]このメソッドは、Bootstrapなどのグリッドシステムを操作するときにビューで特に役立ちます。グリッドに表示するEloquentモデルのコレクションがあるとします。</div>@endforeachchunkWhile()chunkWhileメソッドは、指定したコールバックの評価に基づいて、コレクションを複数のより小さなコレクションへ分割します。クロージャに渡された$chunk変数は、前の要素を検査するために使用できます。['D']]collapse()collapseメソッドは、配列のコレクションをフラットな一次コレクションに展開します。9]collect()collectメソッドは、コレクション中の現在のアイテムを利用した、新しいCollectionインスタンスを返します。3]collectメソッドは、レイジーコレクションを通常のCollectionインスタンスへ変換するのにとくに便利です。collectメソッドはEnumerableのインスタンスがあり、それをレイジーコレクションでなくする必要がある場合、とくに便利です。collect()はEnumerable契約の一部であり、Collectionインスタンスを取得するため安全に使用できます。combine()combineメソッドは、コレクションの値をキーとして、他の配列かコレクションの値を結合します。29]concat()concatメソッドは、指定したarrayまたはコレクションの値を別のコレクションの最後に追加します。Doe']concatメソッドは、元のコレクションに連結したアイテムのキーを数値的に再インデックスします。連想配列のコレクションでキーを保持するには、mergeメソッドを参照してください。contains()containsメソッドは、コレクションに指定したアイテムが含まれているか判定します。指定する真偽判定にマッチする要素がコレクション内に存在するかを判定するために、containsメソッドにクロージャを渡します。falseまたは、文字列をcontainsメソッドに渡して、コレクションに指定アイテム値が含まれているかどうかを判断することもできます。falseさらにcontainsメソッドにはキー/値ペアを指定することもでき、コレクション中に指定したペアが存在するかを確認できます。falsecontainsメソッドは、アイテムを「緩く」比較します。ある整数の文字列とその整数値は等値として扱います。「厳密」な比較を行いたい場合は、containsStrictメソッドを使ってください。containsの逆は、doesntContainメソッドをご覧ください。containsOneItem()containsOneItemメソッドは、コレクションに項目が1つ含まれているかを判断します。falsecontainsStrict()このメソッドは、containsメソッドと使用方法は同じです。「厳密」な値の比較を行います。Eloquentコレクションの使用時は、このメソッドの振る舞いが変わります。count()countメソッドはコレクションのアイテム数を返します。4countBy()countByメソッドは、コレクション内の値の出現をカウントします。このメソッドはデフォルトで、コレクション内の要素の特定の「タイプ」をカウントできるよう、すべての要素の出現をカウントします。1]countByメソッドにクロージャを渡して、すべてのアイテムをカスタム値でカウントします。1]crossJoin()crossJoinメソッドはコレクションの値と、指定した配列かコレクション間の値を交差接続し、可能性のある全順列の直積を返します。]*/dd()ddメソッドはコレクションアイテムをダンプし、スクリプトの実行を停止します。}*/スクリプトの実行を止めたくない場合は、dumpメソッドを代わりに使用してください。diff()diffメソッドはコレクションと、他のコレクションか一次元「配列」を値にもとづき比較します。このメソッドは指定されたコレクションに存在しない、オリジナルのコレクションの値を返します。Eloquentコレクションの使用時は、このメソッドの振る舞いは変わります。diffAssoc()diffAssocメソッドはコレクションと、他のコレクションかキー/値形式のPHP配列を比較します。このメソッドは指定したコレクションに含まれない、オリジナルコレクション中のキー/値ペアを返します。6]diffKeys()diffKeysメソッドはコレクションと、他のコレクションか一次元「配列」をキーで比較します。このメソッドは指定したコレクションに存在しない、オリジナルコレクション中のキー/値ペアを返します。50]doesntContain()doesntContainメソッドは、コレクションに指定アイテムが含まれないことを判定します。doesntContainメソッドにクロージャを渡し、指定する真理値テストに合致する要素がコレクションに存在ことを判定できます。falseあるいは、doesntContainメソッドに文字列を渡し、コレクションに指定したアイテム値が含まれていないことを判定することもできます。falseまた、doesntContainメソッドへキー/値のペアを渡し、指定ペアがコレクション内に存在しないことを判定することも可能です。truedoesntContainメソッドは、項目の値をチェックする際、「緩く」比較します。整数値を持つ文字列は同じ値の整数値と等しいとみなします。dump()dumpメソッドはコレクションアイテムをダンプします。}*/コレクションをダンプした後にスクリプトを停止したい場合は、代わりにddメソッドを使用してください。duplicates()duplicatesメソッドはコレクション中の重複値を返します。'b']コレクションが配列やオブジェクトを含む場合は、値の重複を調べたい属性のキーを渡せます。'Developer']duplicatesStrict()このメソッドの使い方はduplicatesメソッドと同じですが、すべての値に「厳密な」比較が行われます。each()eachメソッドはコレクション内のアイテムを反復処理し、各アイテムをクロージャに渡します。//});アイテムの反復を停止したい場合は、クロージャからfalseを返してください。}});eachSpread()eachSpreadメソッドはコレクションのアイテムに対し、指定したコールバックへネストしたアイテム値をそれぞれ渡し、繰り返し処理します。//});アイテムに対する繰り返しを停止したい場合は、コールバックからfalseを返します。false;});every()everyメソッドは、コレクションの全要素が、指定したテストをパスするか判定するために使用します。falseコレクションが空の場合、everyメソッドはtrueを返します。trueexcept()exceptメソッドは、キーにより指定したアイテム以外の全コレクション要素を返します。1]exceptの正反対の機能は、onlyメソッドです。Eloquentコレクションの使用時は、このメソッドの振る舞いは変わります。filter()filterメソッドは指定したコールバックでコレクションをフィルタリングします。テストでtrueを返したアイテムだけが残ります。4]コールバックを指定しない場合、コレクションの全エンティティの中で、falseとして評価されるものを削除します。3]filterの逆の動作は、rejectメソッドを見てください。first()firstメソッドは指定された真偽テストをパスしたコレクションの最初の要素を返します。3firstメソッドに引数を付けなければ、コレクションの最初の要素を取得できます。コレクションが空ならnullを返します。1firstOrFail()firstOrFailメソッドは、結果が見つからない場合にIlluminate\Support\ItemNotFoundException例外を投げる以外、firstメソッドと同じです。ItemNotFoundExceptionを投げるまた、引数なしでfirstOrFailメソッドを呼び出すと、コレクション内の最初の要素を取得できます。コレクションが空の場合、Illuminate\Support\ItemNotFoundException例外を投げます。ItemNotFoundExceptionを投げるfirstWhere()firstWhereメソッドはコレクションの中から、最初の指定したキー/値ペアの要素を返します。firstWhereメソッドを呼び出すこともできます。23]whereメソッドと同様に、firstWhereメソッドへ一つの引数を渡せます。その場合、firstWhereメソッドは、指定したアイテムキー値が「真と見なせる」最初のアイテムを返します。14]flatMap()flatMapメソッドはコレクションを反復処理し、各値を指定したクロージャに渡します。クロージャはアイテムを自由に変更して返却できるため、変更されたアイテムの新しいコレクションを形成します。それから、一次配列へフラット化します。'28'];flatten()flattenメソッドは多次元コレクションを一次元化します。'javascript'];必要に応じて、flattenメソッドに「depth」引数を渡すことができます。]*/この例では、深さを指定せずにflattenを呼び出すと、ネストした配列もフラットにし、['iPhone6S'、'Apple'、'GalaxyS7'、'Samsung']になります。深さを指定すると、ネストした配列をフラット化するレベルの数を指定できます。flip()flipメソッドはコレクションのキーと対応する値を入れ替えます。'framework']forget()forgetメソッドはキーによりコレクションのアイテムを削除します。他のコレクションメソッドとは異なり、forgetは更新された新しいコレクションを返しません。呼び出しもとのコレクションを更新します。forPage()forPageメソッドは指定されたページ番号を表すアイテムで構成された新しいコレクションを返します。このメソッドは最初の引数にページ番号、2つ目の引数としてページあたりのアイテム数を受け取ります。6]get()getメソッドは指定されたキーのアイテムを返します。キーが存在していない場合はnullを返します。taylorオプションとして第2引数にデフォルト値を指定することもできます。34メソッドのデフォルト値としてコールバックを渡すこともできます。指定したキーが存在しない場合、コールバックの結果が返されます。taylor@example.comgroupBy()groupByメソッドは指定したキーによりコレクションのアイテムをグループにまとめます。]*/文字列でkeyを指定する代わりに、コールバックを渡すことができます。コールバックはグループとしてまとめるキーの値を返す必要があります。]*/配列として、複数のグルーピング基準を指定できます。各配列要素は多次元配列の対応するレベルへ適用されます。],];*/has()hasメソッドは指定したキーがコレクションに存在しているかを調べます。falsehasAny()hasAnyメソッドは、指定したキーのいずれが、コレクション内に存在するか判定します。falseimplode()implodeメソッドはコレクション内のアイテムを結合します。その引数は、コレクション内のアイテムのタイプによって異なります。コレクションに配列またはオブジェクトが含まれている場合は、結合する属性のキーと、値の間に配置する「接着」文字列を渡す必要があります。Chairコレクションに単純な文字列または数値が含まれている場合は、メソッドへの唯一の引数として「接着」文字列を渡す必要があります。'1-2-3-4-5'結合する値をフォーマットしたい場合は、implodeメソッドへクロージャを渡してください。CHAIRintersect()intersectメソッドは、指定した「配列」かコレクションに存在していない値をオリジナルコレクションから取り除きます。結果のコレクションには、オリジナルコレクションのキーがリストされます。Eloquentコレクションの使用時は、このメソッドの振る舞いは変わります。intersectByKeys()intersectByKeysメソッドは、指定した配列またはコレクションに存在しないキーとそれに対応する値を元のコレクションから削除します。2009]isEmpty()isEmptyメソッドはコレクションが空の場合にtrueを返します。なければfalseを返します。trueisNotEmpty()isNotEmptyメソッドは、コレクションが空でない場合にtrueを返します。空であればfalseを返します。falsejoin()joinメソッドは、コレクションの値を文字列で結合します。このメソッドの2番目の引数を使用して、最後の要素を文字列に追加する方法を指定することもできます。''keyBy()keyByメソッドは指定したキーをコレクションのキーにします。複数のアイテムが同じキーを持っている場合、新しいコレクションには最後のアイテムが含まれます。]*/もしくは、コールバックをメソッドへ渡すこともできます。コールバックからコレクションのキーの値を返してください。]*/keys()keysメソッドはコレクションの全キーを返します。'prod-200']last()lastメソッドは指定したテストをパスしたコレクションの最後のアイテムを返します。2またはlastメソッドを引数無しで呼び出し、コレクションの最後の要素を取得することもできます。コレクションが空の場合、nullが返ります。4lazy()lazyメソッドは、アイテムの配列から新しいレイジーコレクションインスタンスを返します。4]このメソッドは多くのアイテムを持つ巨大なコレクション(Collection)を変換する必要がある場合に役立ちます。->count();コレクションをレイジーコレクション(LazyCollection)に変換することで、追加で大量のメモリを確保する必要がなくなります。元のコレクションはメモリ内に自身の値(its)を保持しますが、後続するフィルタは保持しません。そのため、コレクションへフィルタをかけるとき、追加のメモリが割り当てられることはありません。macro()staticのmacroメソッドで、実行時にCollectionクラスへメソッドを追加できます。詳細は、コレクションの拡張ドキュメントを参照してください。make()staticのmakeメソッドは、新しいコレクションインスタンスを生成します。コレクションの生成セクションを参照してください。map()mapメソッドコレクション全体を繰り返しで処理し、指定したコールバックから値を返します。コールバックで自由にアイテムを更新し値を返せます。更新したアイテムの新しいコレクションが作成されます。他のコレクションと同様にmapは新しいコレクションインスタンスを返します。呼び出し元のコレクションは変更しません。オリジナルコレクションを変更したい場合はtransformメソッドを使います。mapInto()mapInto()メソッドはコレクションを繰り返し処理します。指定したクラスの新しいインスタンスを生成し、コンストラクタへ値を渡します。Currency('GBP')]mapSpread()mapSpreadメソッドはコレクションのアイテムを反復処理し、ネストした各アイテム値を指定されたクロージャに渡します。クロージャはアイテムを自由に変更して返すことができるため、変更したアイテムの新しいコレクションを生成します。17]mapToGroups()mapToGroupsメソッドは、指定クロージャによってコレクションのアイテムをグループ化します。クロージャはキー/値のペアを一つ含む連想配列を返してください。これにより、値をグループ化した新しいコレクションを生成します。Doe']mapWithKeys()mapWithKeysメソッドはコレクション全体を反復処理し、指定したコールバックへ各値を渡します。コールバックからキー/値ペアを一つ含む連想配列を返してください。]*/max()maxメソッドは、指定したキーの最大値を返します。5median()medianメソッドは、指定したキーの中央値を返します。1.5merge()mergeメソッドは、指定した配列かコレクションをオリジナルコレクションへマージします。指定した配列の文字列キーが、オリジナルコレクションの文字列キーと一致する場合、オリジナルコレクションの値は指定アイテムの値でオーバーライトされます。false]指定したアイテムのキーが数値の場合、コレクションの最後に追加されます。'Door']mergeRecursive()mergeRecursiveメソッドはオリジナルのコレクションに対し、指定した配列かコレクションを再帰的にマージします。指定したアイテムの文字列キーがオリジナルコレクションのものと一致したら、それらのキーに対する値を配列へマージします。これを再帰的に行います。false]min()minメソッドは、指定したキーの最小値を返します。1mode()modeメソッドは、指定したキーの最頻値を返します。2]nth()nthメソッドは指定数値間隔で要素を含む、新しいコレクションを生成します。'e']オプションで、2番目の引数として開始オフセットを指定できます。'f']only()onlyメソッドは、コレクション中の指定したアイテムのみを返します。exceptメソッドです。Eloquentコレクションの使用時は、このメソッドの振る舞いは変わります。pad()padメソッドは、配列が指定したサイズに達するまで、指定値で配列を埋めます。PHP関数のような動作をします。先頭を埋めるためには、サイズに負数を指定します。配列サイズ以下のサイズ値を指定した場合は、埋め込みを行いません。'C']partition()partitionメソッドは、PHPの配列のデストラクションと組み合わせて、与えられた真理値テストに合格した要素とそうでない要素を分離できます。6]pipe()pipeメソッドは、コレクションを指定したクロージャに渡し、実行されたクロージャの結果を返します。6pipeInto()pipeIntoメソッドは、指定クラスの新しいインスタンスを生成し、コレクションをコンストラクターに渡します。3]pipeThrough()pipeThroughメソッドは、指定するクロージャの配列へコレクションを渡し、クロージャの実行結果を返します。15pluck()pluckメソッドは指定したキーの全コレクション値を取得します。'Chair']さらに、コレクションのキー項目も指定できます。'Chair']pluckメソッドは、「ドット」記法を使ったネストしている値の取得もサポートしています。'Joey']]重複するキーが存在している場合は、最後に一致した要素が結果のコレクションへ挿入されます。'orange']pop()popメソッドはコレクションの最後のアイテムを削除し、返します。4]コレクションの最後から複数の項目を削除して返すために、整数をpopメソッドに渡せます。2]prepend()prependメソッドはアイテムをコレクションの最初に追加します。5]2番目の引数で、先頭に追加するアイテムのキーを指定することもできます。2]pull()pullメソッドはキーによりアイテムを削除し、そのアイテムを返します。'prod-100']push()pushメソッドはコレクションの最後にアイテムを追加します。5]put()putメソッドは指定したキーと値をコレクションにセットします。100]random()randomメソッドはコレクションからランダムにアイテムを返します。(ランダムに取得)整数をrandomに渡して、ランダムに取得するアイテムの数を指定できます。受け取りたいアイテムの数を明示的に渡すと、アイテムのコレクションが常に返されます。(ランダムに取得)コレクションインスタンスのアイテム数が要求より少ない場合、randomメソッドはInvalidArgumentExceptionを投げます。randomメソッドはクロージャも引数に取ります。このクロージャは現在のコレクションインスタンスを受け取ります。randomly)range()rangeメソッドは、指定範囲の整数を含むコレクションを返します。6]reduce()reduceメソッドは繰り返しの結果を次の繰り返しに渡しながら、コレクションを単一値へ減らします。6最初の繰り返しの$carryの値はnullです。初期値を設定したい場合は、reduceの第2引数に渡してください。10また、reduceメソッドは、配列のキーを連想コレクションにして、与えられたコールバックに渡します。4264reduceSpread()reduceSpreadメソッドはコレクションを値の配列に減らし、各反復の結果を後続の反復に渡します。このメソッドはreduceメソッドと似ていますが、複数の初期値を受け入れることができます。collect());reject()rejectメソッドは、指定したクロージャを使用してコレクションをフィルタリングします。結果のコレクションからアイテムを削除する必要がある場合、クロージャでtrueを返してください。2]rejectメソッドの逆の働きについては、filterメソッドを読んでください。replace()replaceメソッドは、mergeメソッドと似た振る舞いを行います。文字列キーを持っているアイテムをオーバーライドするのは同じですが、replaceメソッドは数値キーに一致するコレクション中のアイテムもオーバーライドします。'Finn']replaceRecursive()このメソッドはreplaceと似た動作をしますが、配列を再帰的に下り、次元の低い値も同様に置換します。'Finn']]reverse()reverseメソッドはオリジナルのキーを保ったまま、コレクションのアイテムの順番を逆にします。]*/search()searchメソッドは、コレクションを検索し、指定値が見つかった場合はそのキーを返します。アイテムが見つからない場合、falseを返します。1検索は「緩い」比較で行われます。整数値を持つ文字列は、同じ値の整数に等しいと判断されます。「厳格」な比較を行いたい場合はtrueをメソッドの第2引数に渡します。falseまたは、独自のクロージャを提供して、指定するテストに合格した最初のアイテムを検索することもできます。2shift()shiftメソッドはコレクションから最初のアイテムを削除し、その値を返します。5]コレクションの先頭から複数の項目を削除して返すために、整数をshiftメソッドに渡せます。5]shuffle()shuffleメソッドはコレクションのアイテムをランダムにシャッフルします。(ランダムに生成される)skip()skipメソッドは、コレクションの先頭から指定した数の要素を削除した新しいコレクションを返します。10]skipUntil()skipUntilメソッドは、指定したコールバックがtrueを返すまでコレクションからアイテムをスキップし、コレクション内の残りのアイテムを新しいコレクションインスタンスとして返します。4]もしくはシンプルに値をskipUntilメソッドへ渡すこともでき、その場合は指定した値が見つかるまでアイテムをスキップします。指定した値が見つからないか、コールバックがtrueを返さなかった場合、skipUntilメソッドは空のコレクションを返します。skipWhile()skipWhileメソッドは、指定したコールバックがtrueを返す間、コレクションからアイテムをスキップし、コレクション内の残りのアイテムを新しいコレクションとして返します。コールバックがfalseを返さなかった場合、skipWhileメソッドは空のコレクションを返します。slice()sliceメソッドは指定したインデックスからコレクションを切り分けます。10]切り分ける数を制限したい場合は、メソッドの第2引数で指定してください。6]sliceメソッドはデフォルトでキー値を保持したまま返します。オリジナルのキーを保持したくない場合は、valuesメソッドを使えば、インデックスし直されます。sliding()slidingメソッドは、コレクション中のアイテムの「スライディングウィンドウ」ビューを表す、新しいチャンクコレクションを返します。5]]これはeachSpreadメソッドと組み合わせて使うと、特に便利です。$current->amount;});必要に応じて、それぞれのチャンクの最初の項目間にどのくらい距離を取るかを決定する2番目の「ステップ」値を渡せます。5]]sole()soleメソッドは、指定した真偽テストをパスしたアイテムが正確に1つだけの場合、コレクション内の最初の要素を返します。2キー/値のペアをsoleメソッドへ渡すこともできます。この場合、指定したペアに一致するコレクション内のアイテムが正確に1つだけの場合、それを返します。100]もしくは、要素が1つしかない場合は、引数を指定せずにsoleメソッドを呼び出すこともできます。200]コレクション内に、soleメソッドが返すべき要素がない場合、\Illuminate\Collections\ItemNotFoundException例外を投げます。返すべき要素が複数ある場合は、\Illuminate\Collections\MultipleItemsFoundExceptionを投げます。some()containsメソッドのエイリアスです。sort()sortメソッドはコレクションをソートします。ソート済みコレクションはオリジナル配列のキーを保持しますので、以下の例では、valuesメソッドにより、連続した数字のインデックスにするためリセットしています。5]より高度なソートを行いたい場合はsortにコールバックを渡し、自分のアルゴリズムを実行できます。コレクションのsortメソッドが使用しているuasortのPHPドキュメントを参照してください。ネストした配列やオブジェクトのコレクションのソートは、sortByとsortByDescメソッドを参照してください。sortBy()sortByメソッドは指定したキーでコレクションをソートします。ソート済みコレクションはオリジナル配列のキーを保持しますので、以下の例では、valuesメソッドにより、連続した数字のインデックスにするためリセットしています。]*/sortByメソッドは第2引数に、ソートフラグを受け取ります。]*/または、独自のクロージャを渡して、コレクションの値を並べ替える方法を決定することもできます。sortByメソッドに渡すことができます。各並べ替え操作は、並べ替える属性と目的の並べ替えの方向で構成される配列です。]*/コレクションを複数の属性で並べ替える場合、各並べ替え操作を定義するクロージャを指定することもできます。]*/sortByDesc()このメソッドの使い方はsortByと同じで、コレクションを逆順にソートします。sortDesc()このメソッドはsortメソッドの逆順でコレクションをソートします。1]sortとは異なり、sortDescにクロージャを渡すことはできません。代わりに、sortメソッドを使用して、比較を逆にする必要があります。sortKeys()sortKeysメソッドは、内部の連想配列のキーにより、コレクションをソートします。]*/sortKeysDesc()このメソッドは、sortKeysメソッドと使い方は同じですが、逆順にコレクションをソートします。sortKeysUsing()sortKeysUsingメソッドはコールバックを用いて、連想配列のキーでコレクションをソートします。]*/コールバックは0か、0より小さいか、0より大きい整数を返す比較関数でなければなりません。詳細については、uksortのPHPドキュメントを参照してください。この関数はsortKeysUsingメソッドが内部で利用しているPHP関数です。splice()spliceメソッドは指定したインデックスからアイテムをスライスし、削除し、返します。2]結果のコレクションの大きさを限定するために、第2引数を指定できます。5]さらに、コレクションから削除したアイテムに置き換える、新しいアイテムを第3引数に渡すこともできます。5]split()splitメソッドは、コレクションを指定数のグループへ分割します。[5]]splitIn()splitInメソッドは、コレクションを指定された数のグループに分割します。最終グループ以外を完全に埋め、残りを最終グループに割り当てます。10]]sum()sumメソッドはコレクションの全アイテムの合計を返します。15コレクションがネストした配列やオブジェクトを含んでいる場合、どの値を合計するのを決めるためにキーを指定してください。1272さらに、コレクションのどの項目を合計するのかを決めるためにクロージャを渡すこともできます。6take()takeメソッドは指定したアイテム数の新しいコレクションを返します。2]アイテム数に負の整数を指定した場合はコレクションの最後から取得します。5]takeUntil()takeUntilメソッドは、指定のコールバックがtrueを返すまでコレクションのアイテムを返します。2]takeUntilメソッドにはシンプルに値を渡すこともでき、その指定値が見つかるまでアイテムを返します。指定値が見つからない、もしくはコールバックがtrueを返さない場合、takeUntilメソッドはコレクションの全アイテムを返します。takeWhile()takeWhileメソッドは、指定のコールバックがfalseを返すまでコレクションのアイテムを返します。コールバックがfalseを返さない場合、takeWhileメソッドはコレクション中の全アイテムを返します。tap()tapメソッドは、指定されたコールバックへコレクションを渡します。コレクション自身に影響を与えることなく、その時点のコレクション内容を利用するために使用します。その後、tapメソッドはそのコレクションを返します。1times()静的timesメソッドは指定回数クロージャを呼び出すことで、新しいコレクションを生成します。90]toArray()toArrayメソッドはコレクションをPHPの「配列」へ変換します。コレクションの値がEloquentモデルの場合は、そのモデルが配列に変換されます。toArrayは、ネストしたArrayableインスタンスのオブジェクトすべてを配列へ変換します。コレクションの裏の素の配列をそのまま取得したい場合は、代わりにallメソッドを使用してください。toJson()toJsonメソッドはコレクションをシリアライズ済みのJSON文字へ変換します。'{"name":"Desk","price":200}'transform()transformメソッドはコレクションを繰り返し処理し、コレクションの各アイテムに指定したコールバックを適用します。コレクション中のアイテムはコールバックから返される値に置き換わります。他のコレクションメソッドとは異なり、transformはコレクション自身を更新します。mapメソッドを使用してください。メソッドは、「ドット」記法を用いた一次元のコレクションを多次元のコレクションへ展開します。]*/union()unionメソッドは指定した配列をコレクションへ追加します。コレクションにあるキーが、オリジナル配列に含まれている場合は、オリジナルコレクションの値が優先されます。['c']]unique()uniqueメソッドはコレクションの重複を取り除いた全アイテムを返します。ソート済みのコレクションはオリジナルの配列キーを保っています。下の例ではvaluesメソッドで連続した数字のインデックスにするためリセットしています。4]ネストした配列やオブジェクトを取り扱いたい場合は、一意であることを決めるキーを指定する必要があります。]*/独自のクロージャをuniqueメソッドに渡して、アイテムの一意性を決定する値を指定することもできます。]*/uniqueメソッドは、アイテムの判定に「緩い」比較を使用します。同じ値の文字列と整数値は等しいと判定します。「厳密」な比較でフィルタリングしたい場合は、uniqueStrictメソッドを使用してください。Eloquentコレクションの使用時は、このメソッドの振る舞いは変わります。uniqueStrict()このメソッドは、uniqueと同じ使用方法です。全値は「厳密」に比較されます。unless()unlessメソッドは最初の引数がtrueと評価されない場合、コールバックを実行します。5]2つ目のコールバックをunlessメソッドへ指定できます。2つ目のコールバックは、unlessメソッドへ渡した最初の引数がtrueと評価されたときに実行します。5]unlessの逆の動作は、whenメソッドです。unlessEmpty()whenNotEmptyメソッドのエイリアスです。unlessNotEmpty()whenEmptyメソッドのエイリアスです。unwrap()staticのunwrapメソッドは適用可能な場合、指定値からコレクションの元になっているアイテムを返します。Doe'value()valueメソッドは、コレクション内の最初の要素から、指定した値を取得します。200values()valuesメソッドはキーをリセット後、連続した整数にした新しいコレクションを返します。]*/when()whenメソッドは、メソッドの第1引数がtrueに評価される場合、コールバックを実行します。コレクションインスタンスとwhenメソッドに指定した第1引数は、クロージャへ渡されます。4]2つ目のコールバックをwhenメソッドへ指定できます。2番目のコールバックは、whenメソッドへ渡された最初の引数の評価値がfalseになったときに実行します。5]whenの逆の動作は、unlessメソッドです。whenEmpty()whenEmptyメソッドは、コレクションが空の場合に、指定したコールバックを実行します。['Adam']whenEmptyメソッドの2番目のクロージャは、コレクションが空でないときに実行されます。'Taylor']whenEmptyの逆の動作は、whenNotEmptyメソッドです。whenNotEmpty()whenNotEmptyメソッドは、コレクションが空でない場合に、指定したコールバックを実行します。[]whenNotEmptyメソッドに渡される2番目のクロージャは、コレクションが空のときに実行されます。['taylor']whenNotEmptyの逆の動作は、whenEmptyメソッドです。where()whereメソッドは指定したキー/値ペアでコレクションをフィルタリングします。]*/whereメソッドはアイテム値の確認を「緩く」比較します。同じ値の文字列と整数値は、同値と判断します。「厳格」な比較でフィルタリングしたい場合は、whereStrictメソッドを使ってください。第2引数に比較演算子をオプションとして渡すこともできます。サポートしている演算子は、'==='、'!=='、'!='、'=='、'='、'<>'、'>'、'<'、'>='、'<='です。]*/whereStrict()このメソッドの使用法は、whereメソッドと同じです。値の比較はすべて「厳格」な比較で行われます。whereBetween()whereBetweenメソッドは、指定したアイテム値が、指定範囲内にあるかどうかを判断することにより、コレクションをフィルタリングします。]*/whereIn()whereInメソッドは、指定配列中のアイテム値を持たない要素をコレクションから削除します。]*/whereInメソッドはアイテム値のチェックを「緩く」比較します。同じ値の文字列と整数値は同値と判定します。「厳密」な比較でフィルタリングしたい場合は、whereInStrictメソッドを使ってください。whereInStrict()このメソッドの使い方は、whereInメソッドと同じです。違いは全値を「厳密」に比較することです。whereInstanceOf()whereInstanceOfメソッドは、コレクションを指定したクラスタイプによりフィルタリングします。App\Models\User]whereNotBetween()whereNotBetweenメソッドは、指定アイテム値が指定範囲外にあるかどうかを判断することにより、コレクションをフィルタリングします。]*/whereNotIn()WhereNotIn`メソッドは、指定した配列内に含まれる指定項目値を持つ要素を、コレクションから削除します。]*/whereNotInメソッドは、値を「緩く」比較します。同じ値の文字列と整数は、同値と判定されます。「厳密」にフィルタリングしたい場合は、whereNotInStrictメソッドを使用します。whereNotInStrict()このメソッドは、whereNotInと使い方は同じですが、全値の比較が「厳密」に行われる点が異なります。whereNotNull()wherenotnullメソッドは、与えられたキーがnullではないアイテムをコレクションから返します。]*/whereNull()whernullメソッドは、与えられたキーがnullのアイテムをコレクションから返します。]*/wrap()staticのwrapメソッドは適用可能であれば、指定値をコレクションでラップします。Doe']zip()zipメソッドは指定した配列の値と、対応するインデックスのオリジナルコレクションの値をマージします。messages"をサポートしました。messageが使用できます。messageへは、コレクションインスタンスの動的プロパティとしてアクセスできます。messageを使用してみましょう。messageを使用できます。Laravelのレイジーコレクションを学ぶ前に、PHPジェネレータに慣れるために時間を取ってください。強力なCollectionクラスを補足するために、LazyCollectionクラスはPHPのPHPジェネレータを活用しています。巨大なデータセットをメモリ使用を抑えて利用する目的のためです。アプリケーションで数ギガバイトのログを処理する必要があり、ログを解析するためにLaravelのコレクションメソッドを活用するとしましょう。ファイル全体をメモリへ一度で読み込む代わりに、レイジーコレクションなら毎回ファイルの小さな部分だけをメモリに保持するだけで済みます。ログエントリーの処理...});もしくは、10,000個のEloquentモデルを繰り返し処理する必要があると想像してください。今までのLaravelコレクションでは、一度に10,000個のEloquentモデルすべてをメモリーにロードする必要がありました。500;});しかし、クエリビルダのcursorメソッドは、LazyCollectionインスタンスを返します。これによりデータベースに対し1つのクエリを実行するだけでなく、一度に1つのEloquentモデルをメモリにロードするだけで済みます。この例では、各ユーザーを個別に繰り返し処理するまでfilterコールバックは実行されず、大幅にメモリ使用量を減らせます。$user->id;}レイジーコレクションの生成レイジーコレクションインスタンスを生成するには、コレクションのmakeメソッドへPHPジェネレータ関数を渡します。}});Enumerable契約Collectionクラスのほとんどすべてのメソッドが、LazyCollectionクラス上でも利用できます。両クラスはIlluminate\Support\Enumerable契約を実装しており、以下のメソッドを定義しています。shift、pop、prependなどのように、コレクションを変異させるメソッドは、LazyCollectionクラスでは使用できません。レイジーコレクションメソッドEnumerable契約で定義しているメソッドに加え、LazyCollectionクラス契約は以下のメソッドを含んでいます。takeUntilTimeout()takeUntilTimeoutメソッドは、指定された時間まで値を列挙する新しいレイジーコレクションを返します。その後、コレクションは列挙を停止します。59このメソッドの使用法を理解するために、カーソルを使用してデータベースから請求書を送信するアプリケーションを想像してみてください。15分ごとに実行され、最大14分間のみ請求書を処理するスケジュール済みタスクを定義できます。$invoice->submit());tapEach()eachメソッドはコレクション中の各アイテムに対し、指定したコールバックを即時に呼び出しますが、tapEachメソッドはリストから一つずつアイテムを抜き出し、指定したコールバックを呼び出します。3remember()rememberメソッドは、すでに列挙されている値を記憶し、後続のコレクション列挙でそれらを再度取得しない新しいレイジーコレクションを返します。2022.タイポ、誤訳、フォーマットの乱れなどはGitHubのIssueかTwitterの@hirokwsまでご連絡ください。注目:アイコン:ページ内リンク設置(リンクがないヘッダーへの移動では、リンクがある以前のヘッダーのハッシュをURLへ付加します。閉じる移動クリックで即時移動します。適用ボタンクリック後に、全項目まとめて適用されます。Scaffoldスカフォールド型枠生成スカフィールドLargeスクリーン表示幅640px80%90%100%インデントなし1rem2rem3rem本文フォントコードフォントフォント適用確認フォントの指定フィールドから、フォーカスが外れると、当ブロックの内容に反映されます。EnglishのDisplayもPreviewしてください。フォント設定時、表示に不具合が出た場合、当サイトのクッキーを削除してください。バックスラッシュを含むインライン\Code\Blockの例です。以下はコードブロックの例です。}}設定を保存する前に、表示が乱れないか必ず確認してください。CSSによるフォントファミリー指定の知識がない場合は、フォントを変更しないほうが良いでしょう。