PHP Conference Nagoya 2025

Collection::replaceOne

(No version information available, might only be in Git)

Collection::replaceOneRemplace un document de la collection

Description

public mysql_xdevapi\Collection::replaceOne(string $id, string $doc): mysql_xdevapi\Result

Modifie (ou remplace) le document identifié par ID, s'il existe.

Liste de paramètres

id

L'identifiant du document à remplacer ou mettre à jour. Typiquement c'est le _id généré par le serveur MySQL lors de l'ajout de l'enregistrement.

doc

Le document de la collection à mettre à jour ou remplacer correspondant au paramètre id.

Ce document peut être soit un objet document, soit une chaîne JSON valide décrivant le nouveau document.

Valeurs de retour

Un objet Result qui peut être utilisé pour interroger le nombre d'éléments affectés et le nombre d'avertissements générés par l'opération.

Exemples

Exemple #1 Exemple de mysql_xdevapi\Collection::replaceOne()

<?php
$session
= mysql_xdevapi\getSession("mysqlx://user:password@localhost");

$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();

$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");

$result = $collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();

// Normalement l'_id est connu par d'autres moyens,
// mais pour cet exemple, récupérons l'identifiant généré et utilisons-le
$ids = $result->getGeneratedIds();
$alfred_id = $ids[0];

// ...

$alfred = $collection->getOne($alfred_id);
$alfred['age'] = 81;
$alfred['job'] = 'Guru';

$collection->replaceOne($alfred_id, $alfred);

?>
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top