PDOStatement::execute
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::execute — Запускає підготовлений запит на виконання
Опис
public PDOStatement::execute(?array $params = null): bool
Запускає підготовлений запит. Якщо запит містить маркери параметрів (псевдозмінні), ви повинні:
-
викликатиPDOStatement::bindParam()и/илиPDOStatement::bindValue(), щоб зв'язати ці маркери, відповідно, зі змінними чи значеннями. Пов'язані змінні передають свої значення як вхідні дані та отримують вихідні значення
-
або передати масив значень лише на вхід
Список параметрів
params
Масив значень містить стільки елементів, скільки параметрів заявлено в SQL-запиті. Усі значення будуть прийняті як такі, що мають тип PDO::PARAM_STR
Не можна прив'язати кілька значень одного параметра; наприклад, не можна прив'язати два значення до іменованого параметра у виразі IN().
Не можна прив'язати більше значень, ніж заявлено у запиті; якщо в масиві params більше елементів, ніж заявлено у SQL-запиті методом PDO::prepare(), виконання запиту завершиться невдачею та буде викликана помилка.
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Помилки
Видає помилку рівня E_WARNING, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_WARNING
Викидає виняток PDOException, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_EXCEPTION
Приклади
Приклад #1 Виконання підготовленого запиту з прив'язкою змінних та значень
Приклад #2 Виконання підготовленого запиту з масивом іменованих значень
Приклад #3 Виконання підготовленого запиту з масивом значень позицій
Приклад #4 Виконання підготовленого запиту зі змінними, прив'язаними до позиційних заповнювачів
Приклад #5 Виконання підготовленого запиту з використанням масиву для вираження IN
Примітки
Зауваження :
Для деяких драйверів потрібно закривати курсор, перш ніж виконувати наступний запит.
Дивіться також
- PDO::prepare() - готує запит до виконання та повертає пов'язаний із цим запитом об'єкт
- PDOStatement::bindParam() - Прив'язує параметр запиту до змінної
- PDOStatement::fetch() - Вилучення наступного рядка з результуючого набору
- PDOStatement::fetchAll() - Вибирає рядки, що залишилися, з набору результатів
- PDOStatement::fetchColumn() - Повертає дані одного стовпця наступного рядка результуючого набору