MongoGridFS::findOne

Returns a single file matching the criteria

&reftitle.description; public `MongoGridFSFile` `MongoGridFS::findOne` `mixed` `query` array() `mixed` `fields` array()
&reftitle.parameters;

`query`

- The filename or criteria for which to search.

&reftitle.returnvalues;

Returns a `MongoGridFSFile` or &null;.

&reftitle.examples;

### `MongoGridFS::findOne` example

Example demonstrating how to find a single file from the MongoGridFS.

    <?php

    $downloads = $mongo->my_db->getGridFS('downloads');

    $downloads->storeFile('filename.tgz');

    $download = $downloads->findOne('filename.tgz'); // instance of MongoGridFSFile

    print_r($download);
    ?>

See `MongoGridFSFile` for more information about how to work with files.

&example.outputs.similar;

    MongoGridFSFile Object
    (
        [file] => Array
            (
                [_id] => MongoId Object
                    (
                    )

                [filename] => filename.tgz
                [uploadDate] => MongoDate Object
                    (
                        [sec] => 1274288014
                        [usec] => 467000
                    )

                [chunkSize] => 262144
                [md5] => d41d8cd98f00b204e9800998ecf8427e
            )

        [gridfs:protected] => MongoGridFS Object
            (
                [chunks] => MongoCollection Object
                    (
                    )

                [filesName:protected] => downloads.files
                [chunksName:protected] => downloads.chunks
            )

    )