Класс MongoBinData

(PECL mongo >= 0.8.1)

Внимание

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

MongoDB\BSON\Binary

Введение

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

Максимальный размер одного документа, вставляемого в базу данных составляет 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 __toString ( ) : string

}

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

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

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

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

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

Содержание

MongoBinData::__construct — Создает новый двоичный объект данных
MongoBinData::__toString — Строковое представление этого двоичного объекта данных