PDO::query

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

PDO::query — Підготовка та виконання виразу SQL без заповнювачів

Опис

public PDO::query(string $query, ?int $fetchMode = null): PDOStatement|false

public PDO::query(string $query, ?int $fetchMode = PDO::FETCH_COLUMN, int $colno): PDOStatement|false

public PDO::query(    string $query,    ?int $fetchMode = PDO::FETCH_CLASS,    string $classname,    array $constructorArgs): PDOStatement|false

public PDO::query(string $query, ?int $fetchMode = PDO::FETCH_INTO, object $object): PDOStatement|false

PDO::query() готує та виконує вираз SQL за один виклик функції, повертаючи вираз як об'єкт PDOStatement

Якщо запит запускатиметься багаторазово, для покращення продуктивності програми має сенс цей запит один раз підготувати PDOStatementметодомPDO::prepare(), а потім запускати на виконання методом PDOStatement::execute() стільки разів, скільки потрібно.

Якщо після виконання попереднього запиту ви не вибрали всі дані з результуючого набору, наступний дзвінок PDO::query() може зазнати невдачі. У таких випадках слід викликати метод PDOStatement::closeCursor(), що звільнить ресурси бази даних, зайняті попереднім об'єктом PDOStatement. Після цього можна безпечно викликати PDO::query()

Зауваження :

Якщо query містить заповнювачі, вираз має бути підготовлено та виконано окремо з використанням методів PDO::prepare() і PDOStatement::execute()

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

query

SQL-запит для підготовки та виконання.

Якщо SQL містить заповнювачі, замість цього слід використовувати PDO::prepare() і PDOStatement::execute(). В якості альтернативи, SQL можна підготувати вручну перед викликом PDO::query(), при цьому дані мають бути правильно відформатовані з використанням PDO::quote()якщо драйвер підтримує це.

fetchMode

Режим вибірки за промовчанням для повернутого PDOStatement. Має бути однією з констант PDO::FETCH_*

Якщо цей аргумент передається функції, інші аргументи будуть оброблятися так, якби PDOStatement::setFetchMode() був викликаний отриманого об'єкта висловлювання. Подальші аргументи залежать від вибраного режиму вибірки.

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

Повертає об'єкт PDOStatementили**false**в случае возникновения ошибки.

Помилки

Видає помилку рівня E_WARNING, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_WARNING

Викидає виняток PDOException, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_EXCEPTION

Приклади

Приклад #1 SQL без наповнювачів може бути виконаний з використанням PDO::query()

Loading...
▶

Результат виконання наведеного прикладу:

apple   red     150
banana  yellow  250
kiwi    brown   75
lemon   yellow  25
orange  orange  300
pear    green   150
watermelon      pink    90

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

• PDO::exec() - Виконує SQL-запит та повертає кількість порушених рядків
• PDO::prepare() - готує запит до виконання та повертає пов'язаний із цим запитом об'єкт
• PDOStatement::execute() - Запускає підготовлений запит на виконання