array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.mysql-free-result.php', 1 => 'mysql_free_result', ), 'up' => array ( 0 => 'ref.mysql.php', 1 => 'MySQL', ), 'prev' => array ( 0 => 'function.mysql-field-type.php', 1 => 'mysql_field_type', ), 'next' => array ( 0 => 'function.mysql-get-client-info.php', 1 => 'mysql_get_client_info', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mysql/functions/mysql-free-result.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5)
mysql_free_result — Освобождает память от результата запроса
Данный модуль устарел начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API. Альтернативы для этой функции:
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()