(PHP 4, PHP 5)
odbc_setoption — Impostazione dei parametri ODBC
$identificativo
, int $funzione
, int $opzione
, int $parametro
)Questa funzione permette di manipolare i parametri ODBC per la connessione o il risultato di una query indicati. La funzione è stata sviluppata per permettere di aggirare dei problemi emersi in alcuni driver ODBC. Pertanto si dovrebbe utilizzare questa funzione soltanto se si è dei programmatori e si conoscono gli effetti generati dalle varie opzioni. Dato che ogni singola versione di driver ODBC supporta differenti parametri, occorre avere a disposizione un buon manuale del driver per avere esposti tutti i differenti settaggi che possono essere utilizzati.
Poiché i parametri possono variare in base al driver ODBC, è fortemente sconsigliato l'uso di questa funzione in script resi pubblici. Inoltre, alcune opzioni di ODBC non sono gestibili da questa funzione, dato che devono essere specificate prima di stabilire la connessione o prima della preparazione della query. Tuttavia, se per un particolare lavoro permette al PHP di funzionare, può evitare il ricorso a prodotti commerciali.
Restituisce TRUE
in caso di successo, FALSE
in caso di fallimento.
Il campo identificativo
indica la connessione
o l'esito su cui si varia il settaggio. Per la funzione SQLSetConnectOption(),
questo indica l'identificativo di connessione, per SQLSetStmtOption(),
indica l'identificativo del risultato.
Il campo funzione
indica quale funzione ODBC
utilizzare. Dovrebbe essere valorizzato a 1 per SQLSetConnectOption()
e a 2 per SQLSetStmtOption().
Il parametro opzione
indica l'opzione da settare.
Il campo parametro
indica il valore per
l'opzione
richiesta.
Example #1 Esempi di utilizzo
<?php
// 1. Il valore 102 per il campo opzione in SQLSetConnectOption() indica SQL_AUTOCOMMIT.
// Il valore 1 per SQL_AUTOCOMMIT è SQL_AUTOCOMMIT_ON.
// Pertanto questo esempio ha il medesimo effetto di:
// odbc_autocommit($conn, true);
odbc_setoption($conn, 1, 102, 1);
// 2. Il valore 0 per il campo opzione in SQLSetStmtOption() indica SQL_QUERY_TIMEOUT.
// In questo esempio si setta il timeout di una query a 30 secondi.
$result = odbc_prepare($conn, $sql);
odbc_setoption($result, 2, 0, 30);
odbc_execute($result);
?>