Comment utiliser la fonction use_result()/mysqli_use_result() en PHP

Tutoriel sur la fonction PHP use_result()/mysqli_use_result()

La fonction PHP use_result() /mysqli_use_result() est utilisée pour initier la récupération d'un jeu de résultats à partir de la dernière requête exécutée à l'aide de la fonction mysqli_real_query() sur la connexion de base de données. Soit cette fonction, soit la fonction mysqli_store_result() doit être appelée avant que les résultats d'une requête puissent être récupérés, et l'une ou l'autre doit être appelée pour empêcher l'échec de la prochaine requête sur cette connexion de base de données.

Définition et utilisation

La fonction use_result() /mysqli_use_result() prend en charge les deux styles de programmation : objet et procédural.

Syntaxe orientée objet

public mysqli::use_result()

Syntaxe procédurale

mysqli_use_result()

Valeurs possibles et paramètres

La fonction use_result() /mysqli_use_result() ne prend pas de paramètres.

Exemples pratiques

Approche orientée objet

Exemple :      Copier le code

<?php

	// Connexion à la base de données
	$mysqli = new mysqli("localhost", "root", "password", "database");
	if ($mysqli->connect_errno) {
	  echo "Erreur de connexion à la base de données : " . $mysqli->connect_error;
	  exit();
	}

	// Exécution de la requête
	$sql = "SELECT * FROM users";
	$result = $mysqli->query($sql);

	// Récupération du jeu de résultats
	$result_set = $result->use_result();

	// Parcours du jeu de résultats
	if ($result_set) {
	  while ($row = $result_set->fetch_assoc()) {
		echo $row['id'] . " - " . $row['name'] . " - " . $row['email'] . "
";
	  }
	}

	// Fermeture de la connexion
	$mysqli->close();
	?>
?>

Approche procédurale

Exemple :      Copier le code

<?php

	// Connexion à la base de données
	$mysqli = mysqli_connect("localhost", "root", "password", "database");
	if (mysqli_connect_errno()) {
	  echo "Erreur de connexion à la base de données : " . mysqli_connect_error();
	  exit();
	}

	// Exécution de la requête
	$sql = "SELECT * FROM users";
	$result = mysqli_query($mysqli, $sql);

	// Récupération du jeu de résultats
	$result_set = mysqli_use_result($mysqli);

	// Parcours du jeu de résultats
	if ($result_set) {
	  while ($row = mysqli_fetch_assoc($result_set)) {
		echo $row['id'] . " - " . $row['name'] . " - " . $row['email'] . "
";
	  }
	}

	// Fermeture de la connexion
	mysqli_close($mysqli);
	?>
?>

Astuces et conseils d'utilisation pratique

• La fonction use_result() /mysqli_use_result() est utile pour récupérer les résultats d'une requête en un seul bloc.
• Cette fonction ne doit pas être utilisée si un grand volume de traitement est effectué sur le côté client, car cela peut bloquer le serveur et empêcher d'autres threads de mettre à jour les tables à partir desquelles les données sont extraites.
• Si vous devez effectuer un grand volume de traitement sur le côté client, vous devez utiliser la fonction mysqli_store_result() pour stocker le jeu de résultats sur le serveur avant de le récupérer.