Класс MongoBinData

(PECL mongo >= 0.8.1)

Внимание

Расширение, задающее этот класс, объявлено устаревшим. Вместо него используйте расширение MongoDB. Есть такие альтернативы:

Введение

Объект, который может использоваться для хранения или получения бинарных данных из базы данных.

Максимальный размер одного документа, вставляемого в базу данных составляет 16 МБ. Для данных превышающих этот размер (видео, аудио, автобиографии Генри Киссенджера) используйте MongoGridFS. Данные менее 16МБ, возможно, будет лучше вставлять непосредственно в документ, используя MongoBinData.

Например, для вставки изображения в документ, можно написать:

<?php

$profile 
= array(
    
"username" => "foobity",
    
"pic" => new MongoBinData(file_get_contents("gravatar.jpg"), MongoBinData::GENERIC),
);

$users->save($profile);

?>

Данный класс содержит поле type, который на данный момент не предоствляют дополнительной функциональности в базе данных или драйвере PHP. Существует семь предопределенных типов, которые являются константами класса и описаны ниже. Для обратной совместимости, драйвер PHP по умолчанию использует тип MongoBinData::BYTE_ARRAY; однако, в будущем, его могут поменять на MongoBinData::GENERIC. Пользователи поощряются указывать тип в конструкторе MongoBinData::__construct().

Обзор классов

MongoBinData {
/* Константы */
const int GENERIC = 0 ;
const int FUNC = 1 ;
const int BYTE_ARRAY = 2 ;
const int UUID = 3 ;
const int UUID_RFC4122 = 4 ;
const int MD5 = 5 ;
const int CUSTOM = 128 ;
/* Fields */
public string $bin ;
public int $type = 2 ;
/* Методы */
public __construct ( string $data [, int $type = 0 ] )
public string __toString ( void )
}

Предопределенные константы

Типы бинарных данных

MongoBinData::GENERIC
0x00
Двоичные данные общего назначения.
MongoBinData::FUNC
0x01
Функция.
MongoBinData::BYTE_ARRAY
0x02
Двоичные данные общего назначения. (Объявлен устаревшим в пользу MongoBinData::GENERIC).
MongoBinData::UUID
0x03
Универсальный уникальный идентификатор. (Объявлен устаревшим в пользу MongoBinData::UUID_RFC4122).
MongoBinData::UUID_RFC4122
0x04
Универсальный уникальный идентификатор (в соответствии с » RFC 4122).
MongoBinData::MD5
0x05
MD5.
MongoBinData::CUSTOM
0xf0
Определенный пользователем тип.

Список изменений

Версия Описание
1.5.0 Добавлены константы MongoBinData::GENERIC и MongoBinData::UUID_RFC4122.

Содержание