PDOStatement::bindColumn
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
Otras extensiones