TokyoTyrantTable::put
(PECL tokyo_tyrant >= 0.1.0)
TokyoTyrantTable::put — Enregistre une ligne
Description
public int TokyoTyrantTable::put
( string
$key
, array $columns
)
Enregistre une nouvelle ligne dans la base de données. Le paramètre
key est la clé primaire de la ligne, et le
fait d'y passer la valeur NULL génèrera un nouvel identifiant unique.
Le paramètre value est un tableau contenant
les données de la ligne, qui sont habituellement des paires clé/valeur.
Liste de paramètres
-
key -
La clé primaire de la ligne
-
columns -
Le contenu de la ligne
Valeurs de retour
Retourne la clé primaire en cas de succès, et lance une exception TokyoTyrantException si une erreur survient.
Exemples
Exemple #1 Exemple avec TokyoTyrantTable::put()
<?php
/* Connexion à la base de données */
$tt = new TokyoTyrantTable("localhost", 1979);
/* Passage de la valeur null pour générer un nouvel identifiant unique */
$index = $tt->put(null, array("column1" => "some data", "column2" => "more data"));
/* Récupère la ligne précédemment insérée */
var_dump($tt->get($index));
/* Modification d'une ligne existante */
$tt->put($index, array("column1" => "other data", "column2" => "better data"));
/* Récupère la ligne précédante */
var_dump($tt->get($index));
?>L'exemple ci-dessus va afficher :
array(2) {
["column1"]=>
string(9) "some data"
["column2"]=>
string(9) "more data"
}
array(2) {
["column1"]=>
string(10) "other data"
["column2"]=>
string(11) "better data"
}
