PDO::nextRowset() does not appear to be currently supported by the Firebird PDO driver. Unfortunate.
PDOStatement::nextRowset
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)
PDOStatement::nextRowset — Avance à la prochaine ligne de résultats d'un gestionnaire de lignes de résultats multiples
Description
public PDOStatement::nextRowset(): bool
Quelques bases de données supportent les procédures stockées qui retournent plus d'une ligne de résultats (aussi connu comme des jeux de résultats). PDOStatement::nextRowset() vous permet d'accéder à la seconde et suivantes lignes de résultats associées avec l'objet PDOStatement. Chaque ligne de résultats a des jeux différents de colonnes depuis la ligne de résultats.
Liste de paramètres
Cette fonction ne contient aucun paramètre.
Valeurs de retour
Cette fonction retourne true en cas de succès ou false si une erreur survient.
Exemples
Exemple #1 Récupération de multiples lignes de résultats retournées par une procédure stockée
L'exemple suivant montre comment appeler une procédure stockée,
MULTIPLE_RESULTS, qui retourne trois lignes de résultats.
Nous utilisons une boucle do / while pour parcourir la méthode
PDOStatement::nextRowset(), qui
retourne false et termine la boucle lorsque plus aucune ligne de résultats
ne peut être retournée.
<?php
$sql = 'CALL multiple_rowsets()';
$stmt = $conn->query($sql);
$i = 1;
do {
$rowset = $stmt->fetchAll(PDO::FETCH_NUM);
if ($rowset) {
printResultSet($rowset, $i);
}
$i++;
} while ($stmt->nextRowset());
function printResultSet(&$rowset, $i) {
print "Jeu de résultats $i:\n";
foreach ($rowset as $row) {
foreach ($row as $col) {
print $col . "\t";
}
print "\n";
}
print "\n";
}
?>
L'exemple ci-dessus va afficher :
Jeu de résultats 1: apple red banana yellow Jeu de résultats 2: orange orange 150 banana yellow 175 Jeu de résultats 3: lime green apple red banana yellow
Voir aussi
- PDOStatement::columnCount() - Retourne le nombre de colonnes dans le jeu de résultats
- PDOStatement::execute() - Exécute une requête préparée
- PDOStatement::getColumnMeta() - Retourne les métadonnées pour une colonne d'un jeu de résultats
- PDO::query() - Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement
add a note
User Contributed Notes 4 notes
guilleamathews at gmail dot com ¶
12 years ago
a dot naschekin at mypsw dot ru ¶
5 years ago
When you call $stmt->nextRowset(); it returns TRUE every time and does not stop with FALSE even when no more results left.
It causes Fatal Error when calling
$results[] = $stmt->fetchAll(PDO::FETCH_ASSOC);
with error message
"PHP message: PHP Fatal error: Uncaught PDOException: SQLSTATE[HY000]: General error in ..."
unable to fetch result which not exists.
The desission is try {} catch(e) {}
$stmt = pdo->query("Call Get_multi_result();");
do {
try {
$streets[] = $stmt->fetchAll(PDO::FETCH_ASSOC);
} catch (PDOException $e) {
}
} while ($stmt->nextRowset());
et dot coder at gmail dot com ¶
9 years ago
on MSSQL and 'dsn' => 'dblib:...',:
If you know how many count rowset then don't use contruction of do..while.
<?php
do {
$pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
} while (
$pdoStatement->nextRowset()
);
?>
When I get large fetchAll(over 30) for second nextRowset. I get error - Segmentation fault.
Uses step-by-step insted do..while is fix for this bug:
<?php
$pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
$pdoStatement->nextRowset();
$pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
?>
alex at 1stleg dot com ¶
7 years ago
If you use PDO::fetch instead of PDO::fetchAll and do not reach the end the result set, PDO::nextRowset() will fail with "SQLSTATE[HY000]: General error: PDO_DBLIB: dbresults() returned FAIL."
