pg_select

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

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

Описание

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

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

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

По умолчанию функция pg_select() передаёт необработанные значения. Значения потребуется заэкранировать или указать опцию 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 , если возникла ошибка.

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

Примеры

<?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";
}
?>

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

• pg_convert() - Преобразовывает значения ассоциативного массива в вид, который соответствует SQL-запросам