array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.odbc-setoption.php', 1 => 'odbc_setoption', 2 => 'Настраивает параметры ODBC-соединения или объекта ODBC с результатом запроса', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'Функции ODBC', ), 'prev' => array ( 0 => 'function.odbc-rollback.php', 1 => 'odbc_rollback', ), 'next' => array ( 0 => 'function.odbc-specialcolumns.php', 1 => 'odbc_specialcolumns', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/uodbc/functions/odbc-setoption.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

odbc_setoption

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_setoption — Настраивает параметры ODBC-соединения или объекта ODBC с результатом запроса

Описание

odbc_setoption(
    Odbc\Connection|Odbc\Result $odbc,
    int $which,
    int $option,
    int $value
): bool

Функция настраивает параметры объекта ODBC для конкретного соединения или результата запроса. Функция помогает найти решение проблем в конкретных ODBC-драйверах. Функцией рекомендуют пользоваться только ODBC-программистам, которые понимают, как параметры влияют на объекты соединения и результата. Влияние параметров объясняют развёрнутые справочные руководства по протоколу ODBC. Список параметров, которые поддерживаются конкретным драйвером, зависит от версии драйвера.

Поскольку влияние параметров зависит от ODBC-драйвера, настоятельно не рекомендуют пользоваться функцией в общедоступных скриптах. Кроме прочего, функции недоступны отдельные параметры протокола ODBC, поскольку их требуется настроить до установки соединения или подготовки запроса. Функцией лучше пользоваться, только если она выполняет задачи, для решения которых приходится покупать коммерческий продукт.

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

odbc

Идентификатор соединения или идентификатор результата, для которого требуется изменить настройки. Для функции SQLSetConnectOption() это идентификатор соединения. Для функции SQLSetStmtOption() это идентификатор результата.

which

ODBC-функция, которую требуется вызывать. Для функции 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);

?>