Освобождает память от результата запроса

# 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()

### Описание

function mysql_free_result(resource `$result`): bool

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() - Определяет, относится ли переменная к типу ресурса

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open