La classe MongoId

(PECL mongo >=0.8.0)

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\ObjectId

Introduction

Table des matières

Un identifiant unique créé par les objets de la base. Si un objet est inséré dans la base de données sans le champ _id, ce champ y sera ajouté en utilisant la valeur de l'instance MongoId. Si les données ont un champ unique naturel (comme un nom d'utilisateur ou un timestamp), il conviendra de l'utiliser, mais sa valeur ne sera pas remplacée par la valeur de l'instance MongoId.

Les instances de la classe MongoId remplissent le rôle d'un champ auto-incrémenté d'une base de données relationnelle : fournir une clé unique si la base de données n'en possède pas. L'auto-incrémentation ne fonctionne pas correctement lors de bases de données partagées, vu qu'il est très difficile de déterminer le prochain nombre de la séquence. Cette classe permet de trouver rapidement une valeur unique, y compris lors de l'utilisation de bases de données partagées.

Chaque MongoId est sur 12 octets (ces chaînes seront sur 24 caractères héxadécimaux). Les premiers 4 octets sont un timestamp, les 3 suivants, un hash du nom de la machine cliente, les 2 suivants, les 2 derniers octets significatifs de l'identifiant du processus exécutant le script, et les 3 derniers, une valeur incrémentée.

Un MongoId est linéarisable/délinéarisable. Leur forme linéarisé est similaire à la forme d'une chaîne de caractères :

C:7:"MongoId":24:{4af9f23d8ead0e1d32000000}

Synopsis de la classe

MongoId {

public string $$id = NULL ;

/* Méthodes */

public __construct ([ string|MongoId $id = NULL ] )

public static getHostname ( void ) : string

public getInc ( void ) : int

public getPID ( void ) : int

public getTimestamp ( void ) : int

public static isValid ( mixed $value ) : bool

public static __set_state ( array $props ) : MongoId

public __toString ( void ) : string

}

Retour à la première page de Manuel PHP Table des matières Haut

Champs

$id: Ce champ contient la représentation sous forme de chaine de cet objet.
Note: Le nom de la propriété commence avec un caractère $. Il peut être accédé en utilisant une syntaxe d'analyser complexe de variable (i.e. $mongoId->{'$id'}).

Retour à la première page de Manuel PHP Table des matières Haut

Voir aussi

Documentation de MongoDB » concernant les ObjectIds.

Retour à la première page de Manuel PHP Table des matières Haut

Sommaire

MongoId::__construct — Crée un nouvel identifiant
MongoId::getHostname — Récupère le nom d'hôte utilisé pour les identifiants de cette machine
MongoId::getInc — Récupère la valeur incrémentée pour créer cet identifiant
MongoId::getPID — Récupère l'identifiant du processus
MongoId::getTimestamp — Retourne le timestamp depuis la création de l'id
MongoId::isValid — Vérifie si une valeur est un ObjectId valide
MongoId::__set_state — Crée un MongoId
MongoId::__toString — Retourne une représentation hexadécimale de cet identifiant

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-class.mongoid.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut