异常类
本页内容
- MongoDB\Exception\BadMethodCallException
- MongoDB\Exception\CreateEncryptedCollectionException
- MongoDB\Exception\InvalidArgumentException
- MongoDB\Exception\UnexpectedValueException
- MongoDB\Exception\UnsupportedException
- MongoDB\GridFS\Exception\CorruptFileException
- MongoDB\GridFS\Exception\FileNotFoundException
- MongoDB\Exception\Exception
- MongoDB\Exception\RuntimeException
MongoDB异常\BadMethodCallException
MongoDB\Exception\BadMethodCallException
当在对象上调用不支持的方法时,将抛出此异常。
例如,使用未确认的写关注与
MongoDB\Collection::insertMany()
将返回一个MongoDB\InsertManyResult
对象。调用MongoDB\InsertManyResult::getInsertedCount()
是逻辑错误,因为插入的文档数量只能从已确认的写操作的响应中确定。此类扩展PHP的BadMethodCallException类并实现了库的
Exception
接口。
抛出 MongoDB\Exception\CreateEncryptedCollectionException
异常,如果在创建数据密钥或创建集合时遇到任何错误。可以通过 getPrevious()
和 getEncryptedFields()
方法分别访问原始异常和修改后的 encryptedFields
选项。
MongoDB\Exception\CreateEncryptedCollectionException
当在创建数据密钥或创建集合时遇到任何错误时,由
MongoDB\Database::createEncryptedCollection()
抛出。可以通过getPrevious()
和getEncryptedFields()
方法分别访问原始异常和修改后的encryptedFields
选项。此类扩展了库的
RuntimeException
类。
抛出 MongoDB\Exception\InvalidArgumentException
异常。
MongoDB\Exception\InvalidArgumentException
用于抛出库中参数或选项解析相关的错误。
此类继承自扩展的InvalidArgumentException类,并实现了库的
Exception
接口。
MongoDB\Exception\UnexpectedValueException
MongoDB\Exception\UnexpectedValueException
当从服务器收到的命令响应格式不正确或不是库所期望的内容时,会抛出此异常。此异常表示某些操作中的断言失败,这些操作抽象了数据库命令。这可能表明BSON响应已损坏或服务器或驱动程序中存在错误。
此类扩展了扩展的 UnexpectedValueException 类,并实现了库的
Exception
接口。
MongoDB\Exception\UnsupportedException
MongoDB\Exception\UnsupportedException
当使用的选项不支持所选服务器时,将抛出此异常。它在使用可能引起意外行为的不支持选项时谨慎使用。
此类扩展了库的
RuntimeException
类。注意
与在构造过程中解析操作参数和选项时可能抛出的
InvalidArgumentException
不同,所选服务器是在执行操作后才知的。
MongoDB\GridFS\Exception\CorruptFileException
MongoDB\GridFS\Exception\CorruptFileException
如果GridFS文件的元数据或块文档包含意外或无效数据,将抛出此异常。
在选择GridFS文件时,如果元数据字段的类型不正确或其值超出范围(例如,负
长度
),则可能会抛出此异常。在读取GridFS文件时,如果块的索引顺序不正确或其二进制数据的长度超出范围,则可能会抛出此异常。此类扩展了库的
RuntimeException
类。
MongoDB\GridFS\Exception\FileNotFoundException
MongoDB\GridFS\Exception\FileNotFoundException
如果没有找到满足选择条件的GridFS文件(例如,
id
、filename
),则会抛出此异常。此类扩展了库的
RuntimeException
类。
MongoDB\Exception\Exception
MongoDB\Exception\Exception
此接口扩展了扩展的 Exception 接口,并由库中所有的异常类实现。
MongoDB\Exception\RuntimeException
MongoDB\Exception\RuntimeException
该类扩展了扩展的 RuntimeException 类,该类又继承自 PHP 的 RuntimeException 类。