(PHP 4, PHP 5)
mysql_free_result — Libère le résultat de la mémoire
Avertissement
Cette extension
était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez
utiliser l'extension MySQLi ou l'extension
PDO_MySQL. Voir aussi
MySQL : choisir une API du guide.
Alternatives à cette fonction :
- mysqli_free_result()
- Assignez la valeur
null
à l'objet PDO, ou pdostatement::closeCursor()
Description
mysql_free_result(resource
$result
): bool
mysql_free_result() n'est à appeler que si
vous avez peur d'utiliser trop de mémoire durant l'exécution
de votre script. Toute la mémoire associée à
l'identifiant de résultat sera automatiquement libérée.
Liste de paramètres
-
result
-
La ressource de résultat qui vient d'être évaluée.
Ce résultat vient de l'appel à la fonction mysql_query().
Valeurs de retour
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
Si la valeur passée à l'argument result
n'est
pas une ressource, une erreur de niveau E_WARNING
sera émise. Il est important de noter que la fonction
mysql_query() retourne uniquement une
ressource pour les requêtes SELECT
,
SHOW
, EXPLAIN
et DESCRIBE
.
Exemples
Exemple #1 Exemple avec mysql_free_result()
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Impossible d\'exécuter la requête : ' . mysql_error();
exit;
}
/* Utilisation du résultat */
$row = mysql_fetch_assoc($result);
/* Maintenant, nous libérons le résultat et continuons notre script */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>
Notes
Note:
Pour des raisons de compatibilité ascendante,
l'alias obsolète suivant peut être utilisé :
mysql_freeresult()
Voir aussi
- mysql_query() - Envoie une requête à un serveur MySQL
- is_resource() - Détermine si une variable est une ressource