La classe MongoId
(PECL mongo >=0.8.0)
Cette extension, qui définie cette classe est obsolète. Veuillez utiliser l'extension MongoDB à la place. Les alertnatives à cette classe sont :
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 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
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'}).
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
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
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.