mixed &getOne (
string $query
,
mixed $params = array()
)
Récupère la première colonne de la première ligne des données retournées par la requête. La fonction prend soin d'exécuter la requête et de libérer le résultat par la suite.
la requête SQL à préparer
tableau, chaîne ou données numériques à ajouter à la requête préparée. Le nombre d'éléments passés doit correspondre à celui des marqueurs dans la requête préparée : un marqueur pour les scalaires ou un marqueur par élément du tableau pour un tableau.
Si fourni, prepare() / execute() sont utilisées.
mixed - la valeur retournée ou un objet DB_Error en cas d'erreur.
| Code erreur | Message erreur | Raison | Solution |
|---|---|---|---|
| DB_ERROR_INVALID | invalid | La requête SQL à préparer n'est pas valide. | Voyez la documentation de prepare(), si vous voulez utiliser une requête SQL avec des marqueurs. |
| DB_ERROR_MISMATCH | mismatch | Le nombre de paramètres ne correspond pas au nombre de marqueurs dans la requête préparée. | Vérifiez le nombre de marqueurs dans la requête prepare() passée à $query . Il doit être égal au nombre d'entrées passées à $params . |
| DB_ERROR_NODBSELECTED | no database selected | Aucune base de données n'a été sélectionnée. | Vérifiez le DSN dans connect(). |
| tout autre code erreur | Erreur spécifique à la base de données. | Vérifiez la section spécifique à la base de données dans le manuel PHP pour trouver la raison de cette erreur. Dans la plupart des cas, il s'agit d'une requête mal formée, comme l'utilisation de LIMIT dans une requête envoyée à une base de données Oracle. |
This function can not be called statically.
Exemple avec getOne()
<?php
// On suppose que $db est un objet DB valide...
$data =& $db->getOne('SELECT cf FROM foo');
if (PEAR::isError($data)) {
die($data->getMessage());
}
echo "$data\n";
?>
Utilisation de getOne() avec un marqueur
<?php
// On suppose que $db est un objet DB valide...
$data =& $db->getOne('SELECT cf FROM foo WHERE nf = ?',
5);
if (PEAR::isError($data)) {
die($data->getMessage());
}
echo "$data\n";
?>
Utilisation de getOne() avec deux marqueurs
<?php
// On suppose que $db est un objet DB valide...
$data =& $db->getOne('SELECT cf FROM foo WHERE nf IN (?, ?)',
array(5, 10));
if (PEAR::isError($data)) {
die($data->getMessage());
}
echo "$data\n";
?>