array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.odbc-setoption.php', 1 => 'odbc_setoption', 2 => 'Modifica los parámetros ODBC', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'Funciones 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' => 'es', '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 — Modifica los parámetros ODBC

Descripción

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

odbc_setoption() permite acceder a las opciones ODBC para una conexión particular o un resultado de consulta. Fue escrita para ayudar a la resolución de problemas relacionados con los controladores ODBC problemáticos. Será necesario utilizar odbc_setoption() si se es un programador ODBC y se comprenden los diversos efectos de las opciones disponibles. Asimismo, se necesitará un buen manual de referencia para comprender las opciones y su uso. Diferentes versiones de controladores admiten diferentes versiones de opciones.

Dado que los efectos pueden variar de un controlador a otro, el uso de odbc_setoption() en scripts destinados a ser entregados al público está muy fuertemente desaconsejado. Además, ciertas opciones ODBC no están disponibles porque deben ser fijadas antes del establecimiento de la conexión. Sin embargo, si en un caso bien específico, odbc_setoption() permite utilizar PHP sin que el jefe obligue a usar un producto comercial, entonces no importa.

Parámetros

odbc

Un identificador de conexión, o un identificador de resultado, para el cual se desea modificar opciones. Para SQLSetConnectOption(), es un identificador de conexión. Para SQLSetStmtOption(), es un identificador de resultado.

which

Función ODBC a utilizar. El valor debe ser 1 para SQLSetConnectOption() y 2 para SQLSetStmtOption().

option

La opción a definir.

value

El valor para el parámetro option dado.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.4.0 odbc espera ahora una instancia de Odbc\Connection o de Odbc\Result; anteriormente, se esperaba un resource.

Ejemplos

Ejemplo #1 Ejemplo con odbc_setoption()

<?php
// 1. La opción 102 de SQLSetConnectOption() es SQL_AUTOCOMMIT.
// 1 de SQL_AUTOCOMMIT es SQL_AUTOCOMMIT_ON.
// Este ejemplo tiene el mismo efecto que
// odbc_autocommit($conn, true);

odbc_setoption($conn, 1, 102, 1);

// 2. Opción 0 de SQLSetStmtOption() es SQL_QUERY_TIMEOUT.
// Este ejemplo fija el tiempo límite a 30 segundos.

$result = odbc_prepare($conn, $sql);
odbc_setoption($result, 2, 0, 30);
odbc_execute($result);
?>