/ /

/ /

MongoDB\Database::listCollections()

定義

MongoDB\Database::listCollections()

このデータベース内のすべてのコレクションの情報を返します。

function listCollections(array $options = []): Iterator

パラメーター

$options : 配列

必要なオプションを指定する配列。

名前	タイプ	説明
authorizedCollections	ブール値	アクセス制御を可能にする場合に特権に基づいて返されるコレクションを決定するフラグ。詳しくは、 listCollectionsコマンドのドキュメントを参照してください。バージョン 1.12 の新機能。
comment	混合	データベースプロファイラ、 currentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。このオプションは MongoDB 4.4 以降で使用可能であり、古いサーバーバージョンで指定すると実行時に例外が発生します。バージョン 1.13 の新機能。
フィルター	array\|object	コレクションの一覧をフィルター処理するクエリ式です。コレクションフィールドにクエリ式を指定できます（例: `name` 、 `options` ）。
maxTimeMS	integer	カーソルに対する情報処理操作の累積時間制限（ミリ秒単位）。 MongoDB は、次の割り込みポイントが最も近い時点で操作を中止します。
セッション	MongoDB\Driver\Session	操作に関連付けるクライアントセッション。バージョン 1.3 で追加。

Return Values

イテレータインスタンス。データベース内の各コレクションに対してMongoDB\Model\CollectionInfoオブジェクトを提供します。

例

次の例では、 testデータベース内のすべてのコレクションを一覧表示します。

<?php
$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"で始まるすべてのコレクションを一覧表示します。

<?php
$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\Database::listCollectionNames()
MongoDB マニュアルのlistCollectionsコマンド参照
コレクションの列挙の仕様

戻る

listCollectionNames()

ifyCollection()