Получить все строки результирующей выборки
Назначение
Получение всех строк результирующей выборки.
Синтаксические правила
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 )