sqlsrv_prepare
(No version information available, might only be in Git)
sqlsrv_prepare — Підготовка запиту до виконання
Опис
sqlsrv_prepare( resource $conn, string $sql, array $params = ?, array $options = ?): mixed
Підготовка запиту до виконання. Функція ідеально підходить для підготовки запиту, який буде виконуватись кілька разів із різними значеннями параметрів.
Список параметрів
conn
Ресурс підключення, що повертається sqlsrv_connect()
sql
Рядок, що визначає запит, який потрібно підготувати та виконати.
params
Масив, що визначає інформацію про параметри під час виконання запиту. Елементи масиву можуть бути будь-якими з наступних:
- Строкове значення
- Змінна PHP
- Масив із такою структурою: array($value[, $direction[, $phpType[, $sqlType]]]) .
У наступній таблиці описані елементи у структурі масиву вище:
Структура масиву
| Элемент | Опис |
|---|---|
| $value | Рядкове значення, змінна PHP або змінна PHP, передана за посиланням. |
| $direction (необов'язковий) | Одна з наступних констант SQLSRV, що використовуються для вказівки напряму параметра: SQLSRV_PARAM_IN, SQLSRV_PARAM_OUT, SQLSRV_PARAM_INOUT. Значення за промовчанням - SQLSRV_PARAM_IN. |
| $phpType (необов'язковий) | Константа SQLSRV_PHPTYPE_*, що вказує тип даних PHP значення, що повертається. |
| $sqlType (необов'язковий) | Константа SQLSRV_SQLTYPE_*вказує тип даних SQL Server вхідного значення. |
options
Масив, визначальний параметри властивостей запиту. Ключі, що підтримуються, описані в наступній таблиці:
Опції запиту
| Ключ | Значения | Опис |
|---|---|---|
| QueryTimeout | Позитивне ціле значення. | Встановлює час очікування в секундах. За замовчуванням драйвер очікуватиме результатів нескінченно. |
| SendStreamParamsAtExec | true або false (за замовчуванням true) . | Налаштовує драйвер для надсилання всіх даних потоку під час виконання (true) або для надсилання даних потоку частинами (false). За замовчуванням встановлено значення true. . Для отримання додаткової інформації дивіться sqlsrv_send_stream_data() |
| Scrollable | SQLSRV_CURSOR_FORWARD, SQLSRV_CURSOR_STATIC, SQLSRV_CURSOR_DYNAMIC, або SQLSRV_CURSOR_KEYSET | Смотрите» Вказівка типу курсору та вибір рядківв документации Microsoft SQLSRV. |
Значення, що повертаються
Повертає ресурс оператора у разі успішного виконання або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Приклад використання sqlsrv_prepare()****
У цьому прикладі показано, як підготувати оператор за допомогою sqlsrv_prepare() та повторно виконати його кілька разів (з різними значеннями параметрів) за допомогою sqlsrv_execute()
Примітки
Коли ви підготуєте запит, який використовує змінні як параметри, змінні прив'язуються до оператора. Це означає, що якщо ви оновите значення змінних, наступного разу, коли ви виконаєте запит, він буде працювати з оновленими значеннями параметрів. Для операторів, які ви плануєте виконати лише один раз, використовуйте sqlsrv_query()
Дивіться також
- sqlsrv_execute() - Виконує запит підготовлений за допомогою sqlsrv_prepare
- sqlsrv_query() - готує та виконує запит