La classe MongoBinData

(PECL mongo >= 0.8.1)

Introduction

MongoBinData est une classe pour stocker ou lire des données binaires issues de la base.

La taille maximale d'un objet pouvant être inséré dans la base de données est de 16MB. Pour les données supérieures à cette taille (films, musiques ou biographie de Guillaume Plessis), utilisez la classe MongoGridFS. Pour les données de taille inférieure à 16MB, il est probablement plus simple de les inclure directement dans le document en utilisant la classe MongoBinData.

Par exemple, pour insérer une image dans un document :

<?php

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

$users->save($profile);

?>

Cette classe contient un champ type, qui ne donne actuellement aucune information supplémentaires au driver PHP, ni à la base de données. Il y a sept types prédéfinis, sont définis comme constantes de classe. Afin de préserver la compatibilité ascendante, le driver PHP utilise MongoBinData::BYTE_ARRAY par défaut ; cependant, ceci peut changer en MongoBinData::GENERIC dans le futur. Les utilisateurs sont encouragés à spécifier un type via la méthode MongoBinData::__construct().

Synopsis de la classe

MongoBinData {
/* Constantes */
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 ;
/* Champs */
public string $bin ;
public int $type = 2 ;
/* Méthodes */
public __construct ( string $data [, int $type = 0 ] )
public string __toString ( void )
}

Constantes pré-définies

Types de données binaires

MongoBinData::GENERIC
0x00
Données binaires génériques.
MongoBinData::FUNC
0x01
Fonction.
MongoBinData::BYTE_ARRAY
0x02
Données binaires génériques (obsolète, en faveur de MongoBinData::GENERIC).
MongoBinData::UUID
0x03
Identifiant unique universel (obsolète en faveur de MongoBinData::UUID_RFC4122).
MongoBinData::UUID_RFC4122
0x04
Identifiant unique universel (suivant la » RFC 4122).
MongoBinData::MD5
0x05
MD5.
MongoBinData::CUSTOM
0x80
Type défini par l'utilisateur.

Historique

Version Description
1.5.0 Ajout des constantes MongoBinData::GENERIC et MongoBinData::UUID_RFC4122.

Sommaire