PDOStatement::bindParam
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::bindParam — Прив'язує параметр запиту до змінної
Опис
public PDOStatement::bindParam( string|int $param, mixed &$var, int $type = PDO::PARAM_STR, int $maxLength = 0, mixed $driverOptions = null): bool
Зв'язує змінну PHP з іменованим або неіменованим параметром SQL-запиту, що готується. На відміну від PDOStatement::bindValue(), змінна прив'язується за посиланням та її значення обчислюватиметься під час виклику PDOStatement::execute()
У більшості випадків у запитах, що готуються, використовуються тільки вхідні параметри, тобто при побудові запиту доступ до них здійснюється тільки в режимі читання (можливе приведення відповідно до type). Тим не менш, деякі драйвери дозволяють запускати збережені процедури, які, у свою чергу, можуть повертати дані за допомогою вихідних параметрів. Часто такі параметри використовуються одночасно як вхідні і як вихідні.
Список параметрів
param
Ідентифікатор параметра. Для запитів, що готуються, з іменованими параметрами це буде ім'я у вигляді :name. Якщо використовуються неіменовані параметри (знаки питання?), це буде позиція псевдозмінної в запиті (починаючи з 1).
var
Ім'я змінної PHP, яку потрібно прив'язати до SQL-запиту.
type
Явно заданий тип даних параметра. Тип задається однією з константPDO::PARAM_*. Якщо параметр використовується, у тому числі для виведення інформації з процедури, що зберігається, до значення аргументу typeнеобходимо добавить**PDO::PARAM_INPUT_OUTPUT**, використовуючи оператор побітове АБО.
maxLength
Розмір типу даних. Щоб вказати, що параметр використовується для виведення даних із процедури, необхідно явно задати його розмір. Має значення, тільки якщо параметр typeустановлено значение**PDO::PARAM_INPUT_OUTPUT**
driverOptions
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Помилки
Видає помилку рівня E_WARNING, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_WARNING
Викидає виняток PDOException, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_EXCEPTION
Приклади
Приклад #1 Виконання підготовленого запиту з іменованими псевдозмінними
Приклад #2 Виконання підготовленого запиту з неназваними псевдозмінними (?)
Приклад #3 Виклик процедури, що зберігається з INOUT-параметром
Дивіться також
- PDO::prepare() - готує запит до виконання та повертає пов'язаний із цим запитом об'єкт
- PDOStatement::execute() - Запускає підготовлений запит на виконання
- PDOStatement::bindValue() - Зв'язує параметр із заданим значенням