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

Если задан параметр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. Буде обрано лише ті рядки, значення полів яких збігатимуться зі значеннями масиву.

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, що повертається значення буде асоціативним масивом (array), при PGSQL_NUMвозвращаемое значение будет массивом (array), а приPGSQL_BOTH значення, що повертається, буде і асоціативним і числовим індексованим масивом (array).

Значення, що повертаються

Повертає рядок (string), якщо flags містить PGSQL_DML_STRING, інакше у разі успішного виконання функція повертає масив (array) або **false**в случае возникновения ошибки.

список змін

Версия	Опис
8.1.0	Параметрconnection тепер чекає екземпляр PgSql\Connection; раніше очікувався ресурс (resource
7.1.0	Добавлен параметрmode

Приклади

Приклад #1 Приклад використання pg_select()****

Loading...
▶

Дивіться також

• pg_convert() - Перетворює значення асоціативного масиву на відповідний для SQL-запитів вид