Forum PHP 2017


(PECL mongo >=0.9.0)

MongoGridFS::removeRemove files and their chunks from the database


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



The filename or criteria for which to search.


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().


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.

add a note add a note

User Contributed Notes 1 note

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