La classe MongoBinData

(PECL mongo >= 0.8.1)

Avertissement

Cette extension, qui définie cette classe est obsolète. Veuillez utiliser l'extension MongoDB à la place. Les alertnatives à cette classe sont :

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 __toString ( void ) : string
}

Constantes pré-définies

Types de données binaires

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

Historique

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

Sommaire