(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_setoption — Настраивает параметры ODBC-соединения или объекта ODBC с результатом запроса
Функция настраивает параметры объекта ODBC для конкретного соединения или результата запроса. Функция помогает найти решение проблем в конкретных ODBC-драйверах. Функцией рекомендуют пользоваться только ODBC-программистам, которые понимают, как параметры влияют на объекты соединения и результата. Влияние параметров объясняют развёрнутые справочные руководства по протоколу ODBC. Список параметров, которые поддерживаются конкретным драйвером, зависит от версии драйвера.
Поскольку влияние параметров зависит от ODBC-драйвера, настоятельно не рекомендуют пользоваться функцией в общедоступных скриптах. Кроме прочего, функции недоступны отдельные параметры протокола ODBC, поскольку их требуется настроить до установки соединения или подготовки запроса. Функцией лучше пользоваться, только если она выполняет задачи, для решения которых приходится покупать коммерческий продукт.
odbcИдентификатор соединения или идентификатор результата, для которого требуется изменить настройки. Для функции SQLSetConnectOption() это идентификатор соединения. Для функции SQLSetStmtOption() это идентификатор результата.
whichODBC-функция, которую требуется вызывать. Для функции SQLSetConnectOption() указывают значение 1, а для функции SQLSetStmtOption() значение 2.
optionПараметр, который требуется установить.
value
Значение для параметра option.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
| Версия | Описание |
|---|---|
| 8.4.0 |
Параметр odbc теперь ожидает экземпляр класса Odbc\Connection
или Odbc\Result; раньше ожидалось значение
с типом resource.
|
Пример #1 Примеры установки параметров функцией odbc_setoption()
<?php
// 1. Опция 102 SQLSetConnectOption() — SQL_AUTOCOMMIT.
// Значение 1 SQL_AUTOCOMMIT — SQL_AUTOCOMMIT_ON.
// Этот пример сработает аналогично
// вызову odbc_autocommit($conn, true);
odbc_setoption($conn, 1, 102, 1);
// 2. Опция 0 SQLSetStmtOption() — SQL_QUERY_TIMEOUT.
// Пример устанавливает для времени ожидания запроса 30 секунд
$result = odbc_prepare($conn, $sql);
odbc_setoption($result, 2, 0, 30);
odbc_execute($result);
?>