PDOStatement::setFetchMode

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

PDOStatement::setFetchMode Establece el modo de obtención para esta sentencia

Descripción

public PDOStatement::setFetchMode(int $mode): bool
public PDOStatement::setFetchMode(int $PDO::FETCH_COLUMN, int $colno): bool
public PDOStatement::setFetchMode(int $PDO::FETCH_CLASS, string $classname, array $ctorargs): bool
public PDOStatement::setFetchMode(int $PDO::FETCH_INTO, object $object): bool

Parámetros

mode

El modo de obtención debe ser una de las constantes PDO::FETCH_*.

colno

El número de la columna.

classname

El nombre de la clase.

ctorargs

Los argumentos del constructor.

object

El objeto.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Establece el modo de obtención

El siguiente ejemplo demuestra cómo PDOStatement::setFetchMode() cambia el modo de obtención predeterminado para un objeto PDOStatement.

<?php
$sql
= 'SELECT name, colour, calories FROM fruit';
try {
$sentencia = $gbd->query($sql);
$resultado = $sentencia->setFetchMode(PDO::FETCH_NUM);
while (
$fila = $sentencia->fetch()) {
print
$fila[0] . "\t" . $fila[1] . "\t" . $fila[2] . "\n";
}
}
catch (
PDOException $e) {
print
$e->getMessage();
}
?>

El resultado del ejemplo sería:

apple   red     150
banana  yellow  250
orange  orange  300
kiwi    brown   75
lemon   yellow  25
pear    green   150
watermelon      pink    90

add a note

User Contributed Notes 3 notes

up
35
Dormilich at netscape dot net
14 years ago
if you want to fetch your result into a class (by using PDO::FETCH_CLASS) and want the constructor to be executed *before* PDO assings the object properties, you need to use the PDO::FETCH_PROPS_LATE constant:

<?php
$stmt
= $pdo->prepare("your query");

$stmt->setFetchMode(PDO::FETCH_CLASS|PDO::FETCH_PROPS_LATE, "className", $constructorArguments);

# pass parameters, if required by the query
$stmt->execute($parameters);

foreach (
$stmt as $row)
{
// do something with (each of) your object
}
?>
up
9
Kats
7 years ago
Something very helpful is knowing how to access namespaces from the function. It took me a minute (and Google) to figure out. The ::class property is going to be your best friend in this case.

<?php
$stmt
->setFetchMode(PDO::FETCH_CLASS, Name\Space\Class::class);
?>
up
2
stein_AT_rhrk.uni-kl.de
16 years ago
Some note on PDO :: FETCH_CLASS | PDO :: FETCH_CLASSTYPE

It took me some time, to realize, that you can not use this fetch-mode in $stm->setFetchMode(), when you want to retrieve objects from the database whereas the type is defined by the first column in the resultset.
You have to define this mode directly in the $stm->fetch() method.

To make it clearer:

$stm = $pdo->query("SELECT * FROM `foo`);
$stm->setFetchMode(FETCH_CLASS | PDO :: FETCH_CLASSTYPE);

$object = $stm->fetch();

Will not return the expected object, whereas

$stm = $pdo->query("SELECT * FROM `foo`");

$object = $stm->fetch(FETCH_CLASS | PDO :: FETCH_CLASSTYPE);

will give you the object of the class, defined in the first column of `foo`.
To Top