yes this function may increase the memory usage if you use unbuffered querys and if you have not fetched all the data from mysql. in this case the mysql api has a problem: you want to free the result but do not want to close the connection. now mysql will only accept another query if all data has been fetched, so the api now must fetch the rest of the data when calling mysql_free_result().
so only use unbuffered querys if you fetch all the data (and need it).
mysql_free_result
(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() libère toute la mémoire et
les ressources utilisées par la ressource de résultat result.
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
add a note
User Contributed Notes 3 notes
admin at ifyouwantblood dot de ¶
16 years ago
webmaster at bluesting dot co dot za ¶
13 years ago
mysql_query() also returns a resource for "OPTIMIZE TABLE" statements!
