pg_query
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_query — Виконує запит
Опис
pg_query(PgSql\Connection $connection = ?, string $query): PgSql\Result|false
pg_query() виконує query до вказаної в connection базі даних . pg_query_params() має бути кращим у більшості випадків.
В случае возникновения ошибки функция возвращает**false**, деталі помилки можна отримати за допомогою функції pg_last_error()якщо з'єднання з БД не порушено.
Зауваження: Несмотря на то, что параметр
connectionможе бути опущений, робити так не рекомендується, так як це може призвести до помилок, що важко перебувають у скриптах.
Зауваження :
Раніше ця функція називалася pg_exec(). . pg_exec() все ще доступна для забезпечення сумісності, але краще використовувати нове ім'я.
Список параметрів
connection
Екземпляр PgSql\Connection. Якщо параметр connection не вказано, буде вибрано стандартне з'єднання. Стандартне з'єднання — це останнє з'єднання, яке встановила функція pg_connect() або pg_pconnect()
Увага
Починаючи з версії PHP 8.1.0, використання стандартного з'єднання застаріло.
query
Вираз або вираз SQL для виконання. Якщо передано кілька виразів, вони автоматично виконуються, як одна транзакція, якщо явно не вказані команди BEGIN/COMMIT усередині виразу. Тим не менш, використовувати кілька транзакцій в одному дзвінку функції не рекомендується.
Увага
Строкове представлення даних користувача дуже небезпечне і часто призводить до можливості SQL ін'єкції. У більшості випадків краще передавати дані користувача параметром в pg_query_params(), а не підставляти їх у рядок запиту.
Будь-які дані, що передаються від користувача безпосередньо в рядок запиту, повинні бути добре екрановані
Значення, що повертаються
Екземпляр PgSql\Result у разі успішного виконання або **false**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| 8.1.0 | Повертає екземпляр PgSql\Result; раніше повертався ресурс (resource |
| 8.1.0 | Параметрconnection тепер чекає екземпляр PgSql\Connection; раніше очікувався ресурс (resource |
Приклади
Приклад #1 Приклад використання pg_query()****
Приклад #2 Використання кількох виразів у pg_query()
Дивіться також
- pg_connect() - Відкриває з'єднання з базою даних PostgreSQL
- pg_pconnect() - Відкриває постійне з'єднання із сервером PostgreSQL
- pg_fetch_array() - Повертає рядок результату у вигляді масиву
- pg_fetch_object() - Вибирає рядок результату запиту та повертає дані у вигляді об'єкта
- pg_num_rows() - Повертає кількість рядків у вибірці
- pg_affected_rows() - Повертає кількість порушених запитом записів (кортежів)