PHP 7.0.6 Released

MongoGridFS::remove

(PECL mongo >=0.9.0)

MongoGridFS::removeRemove files and their chunks from the database

Description

public bool|array MongoGridFS::remove ([ array $criteria = array() [, array $options = array() ]] )

Parameters

criteria

The filename or criteria for which to search.

options

An array of options for the remove operations executed against the chunks and files collections. See MongoCollection::remove() for documentation on these options.

Return Values

Returns an array containing the status of the removal (with respect to the files collection) if the "w" option is set. Otherwise, returns TRUE.

Fields in the status array are described in the documentation for MongoCollection::insert().

Errors/Exceptions

Throws MongoCursorException if the "w" option is set and the write fails.

Throws MongoCursorTimeoutException if the "w" option is set to a value greater than one and the operation takes longer than MongoCursor::$timeout milliseconds to complete. This does not kill the operation on the server, it is a client-side timeout. The operation in MongoCollection::$wtimeout is milliseconds.

User Contributed Notes

fhagard at lightcube dot us
6 years ago
To ensure that a remove occurred successfully use MongoDB::lastError(). Currently MongoGridFS::remove will return even if the remove failed.
To Top