MongoCommandCursor: : createFromDocument
(PECL mongo >=1.5.0)
MongoCommandCursor::createFromDocument — Crée un nouveau curseur de commande depuis un document de commande existant
Description
$connection
, string $hash
, array $document
) : MongoCommandCursorUtilisez cette méthode si vous avez un résultat de commande brute qui contient des informations de curseur. Notez que les curseurs créés avec cette méthode ne peuvent pas être parcouru plusieurs fois, sachant qu'ils perdent la commande originale nécessaire à la ré-exécution.
Liste de paramètres
-
connection
-
La connexion à la base de données.
-
hash
-
Le hash de la connexion, tel qu'obtenu via le troisième argument par référence de la méthodec MongoDB:command().
-
document
-
Document contenant les informations du curseur. Ce document doit contenir les champs id, ns et firstBatch. Un tel document est obtenu par appel à la méthode MongoDB:command() avec les arguments appropriés à retourner au curseur, et pas seulement un résultat. Voir l'exemple ci-dessous.
Exemples
Exemple #1 Exemple avec MongoCommandCursor::createFromDocument()
<?php
$m = new MongoClient;
$d = $m->demo;
// Définit le pipeline d'agrégation
$pipeline = [
[ '$group' => [
'_id' => '$country_code',
'timezones' => [ '$addToSet' => '$timezone' ]
] ],
[ '$sort' => [ '_id' => 1 ] ],
];
// Exécution de la commande. L'option "cursor" ci-dessous indique au serveur
// de retourner un document d'information de curseur plutôt que des résultats
$r = $d->command(
[
'aggregate' => 'cities',
'pipeline' => $pipeline,
'cursor' => [ 'batchSize' => 1 ],
],
null,
$hash
);
// Affiche les résultats ainsi que le hash
var_dump( $r, $hash );
// Construit le curseur de commande
$cursor = MongoCommandCursor::createFromDocument( $m, $hash, $r );
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
array(2) { ["cursor"]=> array(3) { ["id"]=> object(MongoInt64)#5 (1) { ["value"]=> string(12) "392143983421" } ["ns"]=> string(11) "demo.cities" ["firstBatch"]=> array(1) { [0]=> array(2) { ["_id"]=> string(2) "AD" ["timezones"]=> array(1) { [0]=> string(14) "Europe/Andorra" } } } } ["ok"]=> float(1) } string(25) "localhost:27017;-;.;17617"
Comme vous pouvez le voir, les informations de curseur retournées contiennent les champs id, ns et firstBatch.
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-mongocommandcursor.createfromdocument.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.