MongoGridFS::put
(PECL mongo >=1.0.8)
MongoGridFS::put — Сохраняет файл в базе данных
Описание
$filename
, array $metadata
= array()
, array $options
= array()
) : mixedЗамечание:
MongoGridFS::put() является псевдонимом MongoGridFS::storeFile().
Список параметров
-
filename
-
Имя файла для сохранения.
-
metadata
-
Другие поля метаданных для включения в файл документа.
Замечание:
Данные поля могут перезаписать поля, автоматически созданные драйвером, как указано в основной документации MongoDB » коллекции файлов. В качестве практического применения данного поведения можно указать собственный
chunkSize
или_id
для файла. -
options
-
Массив опций для операций вставки, выполняемых для коллекций
chunks
иfiles
. Смотрите MongoCollection::insert() для документации по этим параметрам.
Возвращаемые значения
Возвращает _id
сохраненного документа. Это будет сгенерированный MongoId, за исключением случая, когда _id
был явно указан в параметре metadata
.
Ошибки
Выдает исключение MongoGridFSException,
если при чтении filename
или
вставке в коллекции chunks
или files
возникает ошибка.
Смотрите также
- MongoGridFS::storeBytes() - Сохраняет строку байтов в базе данных
- MongoGridFS::storeFile() - Сохраняет файл в базе данных
- MongoGridFS::storeUpload() - Сохраняет загруженный файл в базе данных
- Основная документация MongoDB по » GridFS