La classe MongoId
(PECL mongo >=0.8.0)
Introduction
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 intances de la classe MongoId remplit le rôle d'un champ auto-incrémenté d'un 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 impossible de trouver rapidement la valeur suivante. 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
Champs
- id
- Ce champ contient la représentation sous forme de chaine de cet objet.
Voir aussi
Documentation de MongoDB » concernant les ids.
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::__set_state — Crée un MongoId
- MongoId::__toString — Retourne une représentation hexadécimale de cet identifiant