array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.pg-select.php', 1 => 'pg_select', 2 => 'Выбирает записи из базы данных', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Функции PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-result-status.php', 1 => 'pg_result_status', ), 'next' => array ( 0 => 'function.pg-send-execute.php', 1 => 'pg_send_execute', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/pgsql/functions/pg-select.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_select

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_select — Выбирает записи из базы данных

Описание

pg_select(
    PgSql\Connection $connection,
    string $table_name,
    array $conditions = [],
    int $flags = PGSQL_DML_EXEC,
    int $mode = PGSQL_ASSOC
): array|string|false

Функция pg_select() выбирает из базы данных записи, которые удовлетворяют условиям field=>value в массиве conditions. Функция вернёт массив записей, поля которых удовлетворяют условиям conditions.

При установке параметра flags функция применит к каждому условию в массиве conditions функцию pg_convert() с этими флагами.

При установке для параметра mode режима PGSQL_NUM функция вернёт значение в форме индексного массива, в режиме по умолчанию PGSQL_ASSOC возвращается ассоциативный массив, а в режиме PGSQL_BOTH функция возвращает значения полей и с целочисленными, и со строковыми ключами.

По умолчанию функция pg_insert() передаёт необработанные значения. Значения потребуется заэкранировать или указать опцию PGSQL_DML_ESCAPE. Опция PGSQL_DML_ESCAPE берёт в кавычки и экранирует параметры и идентификаторы. Поэтому названия таблиц и столбцов становятся чувствительными к регистру.

Обратите внимание, что ни экранирование, ни подготовленный запрос не защитят запрос LIKE, JSON, массив, регулярные выражения и т. д. Эти параметры потребуется обработать в соответствии с их контекстом — заэкранировать или проверить значения.

Список параметров

connection

Экземпляр класса PgSql\Connection.

table_name

Название таблицы, из которой требуется выбрать данные.

conditions

Массив (array), ключи которого соответствуют названиям полей таблицы table_name, а значения — условиям извлечения строк. Начиная с PHP 8.4.0 при передаче пустого массива функция не применяет условия. Раньше при передаче пустого массива conditions функция завершалась ошибкой.

flags

Параметр принимает произвольное сочетание следующих констант: PGSQL_CONV_FORCE_NULL, PGSQL_DML_NO_CONV, PGSQL_DML_ESCAPE, PGSQL_DML_EXEC, PGSQL_DML_ASYNC, PGSQL_DML_STRING. Функция вернёт строку запроса, если в списке флагов flags содержится флаг PGSQL_DML_STRING. При установке флага PGSQL_DML_NO_CONV или PGSQL_DML_ESCAPE функция pg_convert() внутренне не вызывается.

mode

Константа PGSQL_ASSOC, PGSQL_NUM или PGSQL_BOTH. В режиме PGSQL_ASSOC функция возвращает ассоциативный массив, в режиме PGSQL_NUM возвращается индексный массив, а в режиме PGSQL_BOTH функция вернёт значения и с ассоциативным, и с числовым ключом.

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

Функция возвращает значение с типом string, если аргумент flags содержит флаг PGSQL_DML_STRING, в остальных случаях функция возвращает значение с типом array, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия Описание
8.4.0 Параметр conditions стал необязательным.
8.1.0 Параметр connection теперь принимает объект PgSql\Connection; раньше параметр принимал тип resource.
7.1.0 Добавили параметр mode.

Примеры

Пример #1 Пример выборки записей функцией pg_select()

<?php

$db = pg_connect('dbname=foo');

// Отчасти это безопасно, поскольку значения экранируются.
// Однако СУБД PostgreSQL поддерживает типы JSON и массив. Для таких значений это небезопасно
// ни с экранированием, ни в подготовленном запросе
$rec = pg_select($db, 'post_log', $_POST);

if ($rec) {
echo "Функция выбрала следующие записи\n";
var_dump($rec);
} else {
echo "Пользователь, должно быть, отправил неверные данные\n";
}

?>

Смотрите также