PDOStatement::bindColumn

PHP PDO 参考手册PHP PDO-Referenzhandbuch

PDOStatement::bindColumn — Bindet eine Spalte an eine PHP-Variable (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Beschreibung

Syntax

bool PDOStatement::bindColumn ( mixed $column , mixed &$param [, int $type [, int $maxlen [, mixed $driverdata ]]] )

Bindet eine bestimmte Variable an eine gegebene Spalte in der Ergebnismenge einer Abfrage. Jeder Aufruf von PDOStatement::fetch() oder PDOStatement::fetchAll() aktualisiert alle an Spalten gebundenen Variablen.

Hinweis:Nicht alle Spalteninformationen sind immer verfügbar, bevor die Anweisung ausgeführt wird. Portable Anwendungen sollten diese Funktion (Methode) nach PDOStatement::execute() aufrufen.
Wenn jedoch der PgSQL-Treiber verwendet wird, muss die Anwendung diese Methode aufrufen, bevor PDOStatement::execute() aufgerufen wird, um eine LOB-Spalte als Stream binden zu können; andernfalls wird die OID des Large Objects als Integer zurückgegeben.


Parameters

column
Die Spaltennummer (ab 1 indexiert) oder der Spaltenname in der Ergebnismenge. Wenn Sie einen Spaltennamen verwenden, beachten Sie, dass der Name in der Groß-/Kleinschreibung mit dem vom Treiber zurückgegebenen Spaltennamen übereinstimmen sollte.

param
Der Name der PHP-Variable, die an die Spalte gebunden werden soll

type
Der Datentyp des Parameters, angegeben durch die PDO::PARAM_*-Konstanten.

maxlen
Hinweis zur Vorabzuweisung.

driverdata
Treiberspezifischer optionaler Parameter.


Rückgabewerte

Gibt bei Erfolg TRUE zurück, bei Fehlschlag FALSE.


Beispiele

Ausgabe der Ergebnismenge an PHP-Variablen binden

Das Binden von Spalten in der Ergebnismenge an PHP-Variablen ist eine effektive Möglichkeit, die in jeder Zeile enthaltenen Daten unmittelbar für die Anwendung verfügbar zu machen. Das folgende Beispiel zeigt, wie PDO Spalten mit verschiedenen Optionen und Standardwerten bindet und abruft.

<?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);
?>

Die obige Routine gibt Folgendes aus:

apple   red     150
banana  yellow  175
kiwi    green   75
orange  orange  150
mango   red     200
strawberry      red     25

PHP PDO 参考手册PHP PDO-Referenzhandbuch

Weitere Erweiterungen