Just to be careful with the strict comparison. Object inequalities holds.
<?php
$m1 = new MongoId('51b14c2de8e185801f000006');
$m2 = new MongoId('51b14c2de8e185801f000006');
var_dump($m1 === $m2); //gives you boolean false
var_dump($m1 == $m2); //gives you boolean true
$m3 = new MongoId('51b14c2de8e185801f000006');
$m4 = new MongoId('51b14c2de8e185801f000007');
var_dump($m3 === $m4); //gives you boolean false
var_dump($m3 == $m4); //gives you boolean false
?>
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 :
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
MongoId
{
public
string
$id
=
NULL
;/* Méthodes */
}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'}).
Voir aussi
Documentation de MongoDB » concernant les ObjectIds.
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
add a note
User Contributed Notes 7 notes
Lionel ¶
10 years ago
rmarscher ¶
11 years ago
You can also cast the id to a string rather than access the $id property to get a string representation of the MongoId.
<?php
$stringId = (string) $mongoId;
?>
georgedot dont spam me gmail caom ¶
10 years ago
Due to Recent changes.
* [PHP-554] - MongoId should not get constructed when passing in an invalid ID.
Constructor will throw an exception when passing invalid ID.
<?php
$_id = new MongoId(); //Generates new ID
$_id = new MongoId(null); //Generates new ID
$_id = new MongoId("invalid id"); //throws MongoException
?>
<?php
//Revert to old behaviour
$_id = "invalid id";
try {
$_id = new MongoId($_id);
} catch (MongoException $ex) {
$_id = new MongoId();
}
?>
<?php
//Nifty hack
class SafeMongoId extends MongoId {
public function __construct($id=null) {
try {
parent::__construct($id);
} catch (MongoException $ex) {
parent::__construct(null);
}
}
}
?>
Ryan S ¶
11 years ago
it is important to note that
<?php
array("_id" => new MongoId("50cf7d2841d41f4f35000000"))
// ≠
array("_id" => array("$id" => "50cf7d2841d41f4f35000000"))
?>
This issue can arrise when using json_encode() and json_decode(). If not paying close enough attention one can assume due to the encoded value of the object that it is just this simple:
<?php
$item = $db->myCollection->findOne();
print json_encode($item);
// {"_id": {"$id": "50cf7d2841d41f4f35000000"}}
$item = $db->myCollection->findOne(json_encode($item));
// $item is empty aka not found
?>
Simple solution to handle these situations:
<?php
class MongoId2 extends MongoId {
public function __construct($id = null) {
if(is_array($id)) {
$id = (object) $id;
}
if(is_object($id) && isset($id->{'$id'})) {
$id = $id->{'$id'};
}
return parent::__construct($id);
}
}
?>
lensvil dot co at gmail dot com ¶
7 years ago
Get ObjectId MongoDB via PHP
var_dump($object);
object(MongoDB\Model\BSONDocument)#36 (1) {
["storage":"ArrayObject":private]=>
array(8) {
["_id"]=>
object(MongoDB\BSON\ObjectID)#33 (1) {
["oid"]=>
string(24) "573e69e78fccd968aa066611"
}
["dummy"]=>
string(5) "mongo"
}
}
Failure
var_dump($object->_id->oid);
>>> null
var_dump($object->_id->{'oid'});
>>> null
var_dump($object->_id->{'$oid'});
>>> null
Success
$bson = \MongoDB\BSON\fromPHP($object);
$json = \MongoDB\BSON\toJSON($bson);
$result = json_decode($json, true);
var_dump($result['_id']['$oid']);
>>> string(24) "573e69e78fccd968aa066611"
exit;
sararschreiber at gmail dot com ¶
13 years ago
this is useful for querying for an object by id, given the id's hex:
<?php
$userid = '4cb4ab6d7addf98506010000';
$theObjId = new MongoId($userid);
$connection = new Mongo();
$db = $connection->thedb->users;
// this will return our matching entry.
$item = $db->findOne(array("_id" => $theObjId));
$connection->close();
?>
alex dot turpin at gmail dot com ¶
12 years ago
If you need to get the actual ID string, and you try the usual way, PHP will whine because it starts with a dollar sign and it thinks it's a variable. Instead, use this notation:
<?php
$mongoid->{'$id'} //Get the $id property of a MongoId object
?>
