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 :

MongoDB\BSON\Binary

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

MongoBinData::__construct — Crée un nouvel objet de données binaires
MongoBinData::__toString — La représentation en chaîne de l'objet binaire

add a note

User Contributed Notes 1 note

down

sander at steffann dot nl ¶

14 years ago


Note MongoBinData::CUSTOM has value 0x80, not 0xf0

add a note