PDOStatement::bindColumn

PHP PDO 参考手册Manuel de référence PHP PDO

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

PHP PDO 参考手册Manuel de référence PHP PDO

Autres extensions