PHP Class MongoGridFS

Inheritance: extends MongoCollection
Exibir arquivo Open project: alcaeus/mongo-php-adapter Class Usage Examples

Public Properties

Property Type Description
$chunks MongoCollection

Protected Properties

Property Type Description
$chunksName string
$filesName string

Public Methods

Method Description
__construct ( MongoDB $db, string $prefix = "fs", mixed $chunks = null ) Files as stored across two collections, the first containing file meta information, the second containing chunks of the actual file. By default, fs.files and fs.chunks are the collection names used.
__sleep ( ) : array
delete ( mixed $id ) : boolean Delete a file from the database
drop ( ) : array Drops the files and chunks collections
find ( array $query = [], array $fields = [] ) : MongoGridFSCursor
findOne ( mixed $query = [], array $fields = [], array $options = [] ) : MongoGridFSFile | null Returns a single file matching the criteria
get ( mixed $id ) : MongoGridFSFile | null Retrieve a file from the database
put ( string $filename, array $extra = [], array $options = [] ) : mixed Stores a file in the database
remove ( array $criteria = [], array $options = [] ) : boolean Removes files from the collections
storeBytes ( string $bytes, array $extra = [], array $options = [] ) : mixed Chunkifies and stores bytes in the database
storeFile ( string $filename, array $extra = [], array $options = [] ) : mixed Stores a file in the database
storeUpload ( string $name, array $metadata = [] ) : mixed Saves an uploaded file directly from a POST to the database

Private Methods

Method Description
createChunksIndex ( ) Creates the index on the chunks collection
insertChunk ( mixed $fileId, string $data, integer $chunkNumber ) : array | boolean Inserts a single chunk into the database
insertChunksFromBytes ( string $bytes, array $record ) Splits a string into chunks and writes them to the database
insertChunksFromFile ( resource $handle, array $record, string &$md5 ) : integer Reads chunks from a file and writes them to the database
insertFile ( $record, array $options = [] ) : array Writes a file record to the database
isOKResult ( $result )

Method Details

__construct() public method

Files as stored across two collections, the first containing file meta information, the second containing chunks of the actual file. By default, fs.files and fs.chunks are the collection names used.
public __construct ( MongoDB $db, string $prefix = "fs", mixed $chunks = null )
$db MongoDB Database
$prefix string [optional]

Optional collection name prefix.

$chunks mixed [optional]

__sleep() public method

public __sleep ( ) : array
return array

delete() public method

Delete a file from the database
public delete ( mixed $id ) : boolean
$id mixed _id of the file to remove
return boolean Returns true if the remove was successfully sent to the database.

drop() public method

Drops the files and chunks collections
public drop ( ) : array
return array The database response

find() public method

public find ( array $query = [], array $fields = [] ) : MongoGridFSCursor
$query array The query
$fields array Fields to return
return MongoGridFSCursor A MongoGridFSCursor

findOne() public method

Returns a single file matching the criteria
public findOne ( mixed $query = [], array $fields = [], array $options = [] ) : MongoGridFSFile | null
$query mixed The fields for which to search or a filename to search for.
$fields array Fields of the results to return.
$options array Options for the find command
return MongoGridFSFile | null

get() public method

Retrieve a file from the database
public get ( mixed $id ) : MongoGridFSFile | null
$id mixed _id of the file to find.
return MongoGridFSFile | null

put() public method

Stores a file in the database
public put ( string $filename, array $extra = [], array $options = [] ) : mixed
$filename string The name of the file
$extra array Other metadata to add to the file saved
$options array An array of options for the insert operations executed against the chunks and files collections.
return mixed Returns the _id of the saved object

remove() public method

Removes files from the collections
public remove ( array $criteria = [], array $options = [] ) : boolean
$criteria array Description of records to remove.
$options array Options for remove.
return boolean

storeBytes() public method

Chunkifies and stores bytes in the database
public storeBytes ( string $bytes, array $extra = [], array $options = [] ) : mixed
$bytes string A string of bytes to store
$extra array Other metadata to add to the file saved
$options array Options for the store. "safe": Check that this store succeeded
return mixed The _id of the object saved

storeFile() public method

Stores a file in the database
public storeFile ( string $filename, array $extra = [], array $options = [] ) : mixed
$filename string The name of the file
$extra array Other metadata to add to the file saved
$options array Options for the store. "safe": Check that this store succeeded
return mixed Returns the _id of the saved object

storeUpload() public method

Saves an uploaded file directly from a POST to the database
public storeUpload ( string $name, array $metadata = [] ) : mixed
$name string The name attribute of the uploaded file, from .
$metadata array An array of extra fields for the uploaded file.
return mixed Returns the _id of the uploaded file.

Property Details

$chunks public_oe property

MongoCollection
public $chunks

$chunksName protected_oe property

string
protected $chunksName

$filesName protected_oe property

string
protected $filesName