ЛИНТЕР

Получить все строки результирующей выборки

Назначение

Получение всех строк результирующей выборки.

Синтаксические правила

array PDOStatement::fetchAll ([int fetch_style[, int column_index]]);

fetch_style: Режим выборки данных (одна из констант вида PDO::FETCH_*). Допустимые значения см. в пункте «Установить режим выборки данных». По умолчанию используется режим PDO::FETCH_BOTH.
column_index: Если установлен режим выборки PDO::FETCH_COLUMN, аргумент задает номер столбца, из которого нужно извлекать данные. По умолчанию 0.

Описание

Функция возвращает все строки результирующей выборки.

Каждая строка выборки будет представлена либо в виде массива собственно значений столбцов, либо в виде объекта со свойствами, имена которых соответствуют именам столбцов выборки (свойства объекта содержат ссылки на значение столбца, например, на BLOB-значение, которое трудно разместить непосредственно в массиве).

Если объем результирующей выборки будет очень большим, то может не хватить ресурсов операционной системы или сервера базы данных. В этом случае необходимо либо изменить алгоритм PHP-приложения, либо уменьшить объем выборки, передаваемый сервером БД PHP-приложению с помощью средств SQL (условия WHERE, предикаты (BETWEEN, IN и др.), группировка GROUP BY, удаление дубликатов DISTINCT и т.п.).

Возвращаемые значения

Массив значений результирующей выборки (нормальное завершение).

Если массив пустой, то запрошенных данных нет, либо задан некорректный оператор.

Пример

<?php
…
$sth = $dbh->prepare("select firstnam, name from auto, person
where auto.personid=person.personid and make='FORD'
and model='LINCOLN CONTINENTAL'
and color='YELLOW' and year=71");
$sth->execute();

/* Получить фамилию и имя владельцев автомобилей марки Lincoln Continetal производства компании Ford желтого цвета 1971 года выпуска */
print("Список владельцев автомобилей:\n");
$result = $sth->fetchAll();
print_r($result);
?>

Результат выполнения данного примера:

Список владельцев автомобилей:
Array
(
    [0] => Array
        (
            [FIRSTNAM] => JUSTIN
            [0] => JUSTIN
            [NAME] => SHAW
            [1] => SHAW
        )
)