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 — Освобождает память от результата запроса
Внимание
Данный модуль устарел начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API. Альтернативы для этой функции:
- mysqli_free_result()
- Присвоение значения
nullпеременной PDO объекта, или PDOStatement::closeCursor()
Описание
mysql_free_result() высвободит всю память, занимаемую
результатом, на который ссылается переданный дескриптор
result.
mysql_free_result() нуждается в вызове только в том случае, если вы всерьёз обеспокоены тем, сколько памяти используют ваши запросы к БД, возвращающие большое количество данных. Вся память, используемая для хранения этих данных автоматически очистится в конце работы скрипта.
Список параметров
-
result -
Обрабатываемый результат запроса. Этот результат может быть получен с помощью функции mysql_query().
Возвращаемые значения
Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.
Если в качестве параметра result передан
не ресурс, то будет вызвана ошибка уровня E_WARNING. Стоит также
заметить, что mysql_query() возвращает
resource только для запросов SELECT, SHOW,
EXPLAIN и DESCRIBE.
Примеры
Пример #1 Пример использования mysql_free_result()
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Не удалось выполнить запрос: ' . mysql_error();
exit;
}
/* Используем результат, подразумевая, что после этого он нам больше не нужен */
$row = mysql_fetch_assoc($result);
/* Теперь освобождаем результат и продолжаем дальнейшую работу над нашим скриптом */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>Примечания
Замечание:
Для обратной совместимости может быть использован следующий устаревший псевдоним: mysql_freeresult()
Смотрите также
- mysql_query() - Посылает запрос MySQL
- is_resource() - Проверяет, представляет ли собой переменная ресурс
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!
