/ /

/ /

MongoDB\Database::dropCollection()

定義

MongoDB\Database::dropCollection()

現在のデータベース内のコレクションを削除します。

function dropCollection(
    string $collectionName,
    array $options = []
): void

パラメーター

$collectionName : string

削除するコレクションの名前。

$options : 配列

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

名前	タイプ	説明
comment	混合	データベースプロファイラ、 currentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。このオプションは MongoDB 4.4 以降で使用可能であり、古いサーバーバージョンで指定すると実行時に例外が発生します。バージョン1.13の新機能。
暗号化されたフィールド	array\|object	Queryable Encryption の暗号化されたフィールドを説明するドキュメント。省略した場合、 `autoEncryption`ドライバーオプション内の`encryptedFieldsMap`オプションが参照されます。 `encryptedFieldsMap`が定義されていたが、このコレクションを指定していない場合、ライブラリは`encryptedFields`のサーバー側値を参照する最後の試行を行います。詳細については、MongoDB マニュアルの「フィールドの暗号化とクエリ可能性」を参照してください。このオプションはdropコマンドに渡されません。ライブラリはそれを使用して、暗号化されたコレクションに加えて削除する必要がある関連メタデータコレクションを決定します。バージョン1.13の新機能。
セッション	MongoDB\Driver\Session	操作に関連付けるクライアントセッション。バージョン1.3の新機能。
typeMap	配列	The type map to apply to cursors, which determines how BSON documents are converted to PHP values. Defaults to the database's type map. これは返されたコマンドの結果ドキュメントに使用されます。
writeConcern	MongoDB\Driver\WriteConcern	操作に使用する書込み保証 ( write concern )。データベースの書込み保証 (write concern) のデフォルト。

エラーと例外

MongoDB\Exception\UnsupportedExceptionオプションが使用され、選択したサーバーでサポートされていない場合（例: collation 、 readConcern 、 writeConcern ）。

MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合はです。

MongoDB$Driver\Exception\RuntimeException は、拡張レベルの他のエラーの場合（例:）。

例

次の例では、 testデータベース内のusersコレクションを削除します。

<?php
$db = (new MongoDB\Client)->test;
$db->dropCollection('users');

その他の参照

MongoDB\Collection::drop()
MongoDB マニュアルの削除コマンド参照

戻る

drop()

getCollection()