mysqli_stmt::sqlstate
MySQLi_Result
MySQLi_STMT
PHP Manual

# mysqli_stmt::store_result

# mysqli_stmt_store_result

(PHP 5)

mysqli_stmt::store_result -- mysqli_stmt_store_result — Stock un jeu de résultats depuis une requête préparée

### Description

Style orienté objet

bool mysqli_stmt::store_result ( void )

Style procédural

bool mysqli_stmt_store_result ( mysqli_stmt `$stmt` )

Vous devez appeler mysqli_stmt_store_result() pour toutes les requêtes qui produisent un jeu de résultats (SELECT, SHOW, DESCRIBE, EXPLAIN), et uniquement si vous voulez stocker le jeu de résultats complet par le client, et donc, les séquences mysqli_stmt_fetch() pourront retourner ces données stockées.

> Note: Il n'est pas nécessaire d'appeler mysqli_stmt_store_result() pour d'autres types de requête, mais si vous le faites, ce n'est pas grave et ne causera aucune perte notable de performance dans tous les cas. Vous pouvez détecter dans tous les cas si votre requête va produire un jeu de résultats en regardant si la fonction mysqli_stmt_result_metadata() retourne `NULL`.

### Liste de paramètres

`stmt`

  Style procédural uniquement : Un identifiant de requête retourné par la fonction mysqli_stmt_init().

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Exemples

Style orienté objet

`<?php
/* Ouvre la connexion */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Vérifie la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = $mysqli->prepare($query)) {
/* Exécution de la requête */
$stmt->execute();
/* Stock le résultat */
$stmt->store_result();
printf("Nombre de lignes: %d.\n", $stmt->num_rows);
/* Libère le résultat */
$stmt->free_result();
/* Fermeture de la requête */
$stmt->close();
}
/* Fermeture de la connexion */
$mysqli->close();
?>`

Style procédural

`<?php
/* Ouvre la connexion */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Vérifie la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = mysqli_prepare($link, $query)) {
/* Exécution de la requête */
mysqli_stmt_execute($stmt);
/* Stock le résultat */
mysqli_stmt_store_result($stmt);
printf("Nombre de lignes : %d.\n", mysqli_stmt_num_rows($stmt));
/* Libère le résultat */
mysqli_stmt_free_result($stmt);
/* Fermeture de la requête */
mysqli_stmt_close($stmt);
}
/* Fermeture de la connexion */
mysqli_close($link);
?>`

Les exemples ci-dessus vont afficher :

    Nombre de lignes : 20.

### Voir aussi

- mysqli_prepare() - Prépare une requête SQL pour l'exécution
- mysqli_stmt_result_metadata() - Retourne les métadonnées de préparation de requête MySQL
- mysqli_stmt_fetch() - Lit des résultats depuis une requête MySQL préparée dans des variables liées

mysqli_stmt::sqlstate
MySQLi_Result
MySQLi_STMT
PHP Manual