Docs Menu
Docs Home
/ / /
PHP ライブラリ マニュアル
/ /

MongoDB\Database::listCollections()

項目一覧

  • 定義
  • パラメーター
  • Return Values
  • その他の参照
MongoDB\Database::listCollections()

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

function listCollections(array $options = []): MongoDB\Model\CollectionInfoIterator
$options : 配列

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

名前
タイプ
説明
authorizedCollections
ブール値

アクセス制御を可能にする場合に特権に基づいて返されるコレクションを決定するフラグ。 詳しくは、 listCollectionsコマンドのドキュメントを参照してください。

サーバーが 4.0 未満の場合、このオプションは無視されます。

バージョン 1.12 の新機能

comment
混合

データベースプロファイラcurrentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。

このオプションは MongoDB 4.4 以降で使用可能であり、古いサーバー バージョンで指定すると実行時に例外が発生します。

バージョン 1.13 の新機能

フィルター
array|object

コレクションの一覧をフィルター処理するクエリ式です。

コレクション フィールドにクエリ式を指定できます(例: nameoptions )。

maxTimeMS
integer

カーソルに対する情報処理操作の累積時間制限(ミリ秒単位)。 MongoDB は、次の割り込みポイントが最も近い時点で操作を中止します。

セッション

操作に関連付けるクライアント セッション。

バージョン 1.3 で追加

MongoDB\Model\CollectionInfoIteratorMongoDB\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) {
}
}

戻る

listCollectionNames()