Stores a file in the database


(PECL mongo >=0.9.0)

MongoGridFS::storeFileStores a file in the database

Описание

public mixed MongoGridFS::storeFile ( string $filename [, array $metadata = array() [, array $options = array() ]] )

Список параметров

filename

Name of the file to store.

metadata

Other metadata fields to include in the file document.

Замечание:

Данные поля могут перезаписать поля, автоматически созданные драйвером, как указано в основной документации MongoDB » коллекции файлов. В качестве практического применения данного поведения можно указать собственный chunkSize или _id для файла.

options

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

Возвращаемые значения

Возвращает _id сохраненного документа. Это будет сгенерированный MongoId, за исключением случая, когда _id был явно указан в параметре metadata.

Ошибки

Throws MongoGridFSException if there is an error reading filename or inserting into the chunks or files collections.

Примеры

Пример #1 MongoGridFS::storeFile() with additional metadata

<?php
$m 
= new MongoClient();
$gridfs $m->selectDB('test')->getGridFS();

$id $gridfs->storeFile('example.txt', array('contentType' => 'plain/text'));
$gridfsFile $gridfs->get($id);

var_dump($gridfsFile->file);
?>

Результатом выполнения данного примера будет что-то подобное:

 array(7) {   ["_id"]=>   object(MongoId)#6 (0) {   }   ["contentType"]=>   string(10) "plain/text"   ["filename"]=>   string(11) "example.txt"   ["uploadDate"]=>   object(MongoDate)#7 (0) {   }   ["length"]=>   int(26)   ["chunkSize"]=>   int(262144)   ["md5"]=>   string(32) "c3fcd3d76192e4007dfb496cca67e13b" } 

Смотрите также