MongoDB\Collection::drop()

定义

MongoDB\Collection::drop()

删除该集合。

function drop(array $options = []): void

参数

$options : array

指定所需选项的数组。

名称	类型	说明
comment	混合	使用户可以指定任意注释来帮助通过数据库分析器、currentOp 输出和日志来跟踪操作。 自 MongoDB 4.4 起此选项可用，如果为旧服务器版本指定，则会在执行时导致异常。 1.13版本新增。
加密字段	数组|对象	描述可查询加密的Queryable Encryption字段的文档。 如果省略，则会查阅autoEncryption驱动程序选项中的encryptedFieldsMap选项。 如果定义了encryptedFieldsMap但未指定此集合，则该库将最后一次尝试查询encryptedFields的服务器端值。 有关更多信息，请参阅 MongoDB 手册中的字段加密和可查询性。 此选项不会传递给drop命令。 该库使用它来确定除了加密集合之外还应删除的相关元数据集合。 1.13版本新增。
会话	MongoDB\Driver\Session	与操作相关联的客户端会话。 1.3版本新增。
writeConcern	MongoDB\Driver\WriteConcern	写关注用于操作。默认为集合的写关注。 无法将单个操作的写关注（write concern）指定为ACID 事务的一部分。相反，请在启动ACID 事务时设立writeConcern 选项。

错误/异常

MongoDB\Exception\UnsupportedException，如果所选服务器使用了选项但不支持选项（例如collation、readConcern、writeConcern）。

MongoDB\Exception\InvalidArgumentException 用于与参数或选项解析相关的错误。

MongoDB\ 驱动程序\Exception\RuntimeException 用于扩展级别的其他错误（例如连接错误）。

例子

以下操作会删除test数据库中的restaurantscollection：

<?php
$collection = (new MongoDB\Client)->test->restaurants;
$collection->drop();

另请参阅

• MongoDB\Database::dropCollection()

• MongoDB 手册中的drop命令参考