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

Назначение

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

Синтаксические правила
 
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
        )