(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_select — Выбирает записи из базы данных
$connection,$table_name,$conditions = [],$flags = PGSQL_DML_EXEC,$mode = PGSQL_ASSOC
Функция 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";
}
?>