PDOStatement::bindColumn

PHP PDO 参考手册Manual de referencia de PHP PDO

PDOStatement::bindColumn — Vincula una columna a una variable de PHP (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Descripción

Sintaxis

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

Vincula una variable específica a una columna determinada de un conjunto de resultados de una consulta. Cada llamada a PDOStatement::fetch() o PDOStatement::fetchAll() actualizará todas las variables vinculadas a las columnas.

Nota:La información de las columnas no siempre está disponible para PDO antes de ejecutar la sentencia; las aplicaciones portables deben llamar a esta función (método) después de PDOStatement::execute().
Sin embargo, cuando se usa el controlador PgSQL, para poder vincular una columna LOB como flujo, la aplicación debe llamar a este método antes de llamar a PDOStatement::execute(); de lo contrario, el OID del objeto grande se devuelve como un entero.


Parámetros

column
El número de columna (indexado desde 1) o el nombre de columna en el conjunto de resultados. Si se usa un nombre de columna, tenga en cuenta que el nombre debe coincidir en mayúsculas y minúsculas con el nombre de columna devuelto por el controlador.

param
El nombre de la variable de PHP que se vinculará a la columna

type
El tipo de datos del parámetro especificado mediante las constantes PDO::PARAM_*.

maxlen
Sugerencia de preasignación.

driverdata
Parámetros opcionales del controlador.


Valores de retorno

Devuelve TRUE en caso de éxito o FALSE en caso de error.


Ejemplos

Vincular la salida del conjunto de resultados a variables de PHP

Vincular columnas de un conjunto de resultados a variables de PHP es una forma eficaz de hacer que los datos de cada fila estén inmediatamente disponibles en la aplicación. El siguiente ejemplo demuestra cómo PDO vincula y recupera columnas con varias opciones y valores predeterminados.

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

El ejemplo anterior generará:

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

PHP PDO 参考手册Manual de referencia de PHP PDO

Otras extensiones