MongoDB\Database::listCollections()
定義
パラメーター
$options
: 配列必要なオプションを指定する配列。
名前タイプ説明authorizedCollectionsブール値アクセス制御を可能にする場合に特権に基づいて返されるコレクションを決定するフラグ。 詳しくは、 listCollectionsコマンドのドキュメントを参照してください。
サーバーが 4.0 未満の場合、このオプションは無視されます。
バージョン 1.12 の新機能。
comment混合データベースプロファイラ、 currentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。
このオプションは MongoDB 4.4 以降で使用可能であり、古いサーバー バージョンで指定すると実行時に例外が発生します。
バージョン 1.13 の新機能。
フィルターarray|objectコレクションの一覧をフィルター処理するクエリ式です。
コレクション フィールドにクエリ式を指定できます(例:
name
、options
)。maxTimeMSintegerカーソルに対する情報処理操作の累積時間制限(ミリ秒単位)。 MongoDB は、次の割り込みポイントが最も近い時点で操作を中止します。
セッション操作に関連付けるクライアント セッション。
バージョン 1.3 で追加。
Return Values
MongoDB\Model\CollectionInfoIterator
MongoDB\Model\CollectionInfo
データベース内の各コレクションの オブジェクトを含むトラバース可能な 。
例
次の例では、 test
データベース内のすべてのコレクションを一覧表示します。
$database = (new MongoDB\Client)->test; foreach ($database->listCollections() as $collectionInfo) { var_dump($collectionInfo); }
出力は次のようになります。
object(MongoDB\Model\CollectionInfo)#3 (2) { ["name"]=> string(11) "restaurants" ["options"]=> array(0) { } } object(MongoDB\Model\CollectionInfo)#3 (2) { ["name"]=> string(5) "users" ["options"]=> array(0) { } } object(MongoDB\Model\CollectionInfo)#3 (2) { ["name"]=> string(6) "restos" ["options"]=> array(0) { } }
次の例では、 test
データベース内の名前が"rest"
で始まるすべてのコレクションを一覧表示します。
$database = (new MongoDB\Client)->test; $collections = $database->listCollections([ 'filter' => [ 'name' => new MongoDB\BSON\Regex('^rest.*'), ], ]); foreach ($collections as $collectionInfo) { var_dump($collectionInfo); }
出力は次のようになります。
object(MongoDB\Model\CollectionInfo)#3 (2) { ["name"]=> string(11) "restaurants" ["options"]=> array(0) { } } object(MongoDB\Model\CollectionInfo)#3 (2) { ["name"]=> string(6) "restos" ["options"]=> array(0) { } }
その他の参照
MongoDB マニュアルのlistCollectionsコマンド参照
コレクションの列挙 仕様