PDOStatement::bindColumn
PDOStatement::bindColumn — Lie une colonne à une variable PHP (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Description
Syntaxe
bool PDOStatement::bindColumn ( mixed $column , mixed &$param [, int $type [, int $maxlen [, mixed $driverdata ]]] )
Lie une variable spécifique à une colonne donnée dans le jeu de résultats d'une requête. Chaque appel à PDOStatement::fetch() ou PDOStatement::fetchAll() mettra à jour toutes les variables liées aux colonnes.
Remarque :Toutes les informations de colonne ne sont pas toujours disponibles avant l'exécution de l'instruction. Les applications portables doivent appeler cette fonction (méthode) après PDOStatement::execute().
Toutefois, lors de l'utilisation du pilote PgSQL, pour pouvoir lier une colonne LOB en tant que flux, l'application doit appeler cette méthode avant d'appeler PDOStatement::execute(), sinon l'OID du grand objet est renvoyé sous forme d'entier.
Parameters
column
Le numéro de colonne (indexé à partir de 1) ou le nom de colonne dans le jeu de résultats. Si vous utilisez un nom de colonne, notez que le nom doit correspondre à la casse du nom de colonne renvoyé par le pilote.
param
Le nom de la variable PHP à lier à la colonne
type
Le type de données du paramètre, spécifié par les constantes PDO::PARAM_*.
maxlen
Indication de pré-allocation.
driverdata
Paramètre optionnel spécifique au pilote.
Valeurs de retour
Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Exemples
Lier la sortie du jeu de résultats aux variables PHP
La liaison des colonnes du jeu de résultats à des variables PHP est un moyen efficace de rendre les données contenues dans chaque ligne immédiatement disponibles pour l'application. L'exemple suivant montre comment PDO lie et récupère des colonnes avec diverses options et valeurs par défaut.
<?php
function readData($dbh) {
$sql = 'SELECT name, colour, calories FROM fruit';
try {
$stmt = $dbh->prepare($sql);
$stmt->execute();
/* 通过列号绑定 */
$stmt->bindColumn(1, $name);
$stmt->bindColumn(2, $colour);
/* 通过列名绑定 */
$stmt->bindColumn('calories', $cals);
while ($row = $stmt->fetch(PDO::FETCH_BOUND)) {
$data = $name . "\t" . $colour . "\t" . $cals . "\n";
print $data;
}
}
catch (PDOException $e) {
print $e->getMessage();
}
}
readData($dbh);
?>
La routine ci-dessus affichera :
apple red 150 banana yellow 175 kiwi green 75 orange orange 150 mango red 200 strawberry red 25
Autres extensions
Manuel de référence PHP PDO