odbc_setoption
(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_setoption — Modifie les paramètres ODBC
Description
odbc_setoption(
resource $odbc
,
int $which
,
int $option
,
int $value
): bool
Étant donné que les effets peuvent varier d'un pilote à
l'autre, l'utilisation de odbc_setoption() dans
des scripts voués à être livrés au public
est très fortement déconseillée. De plus, certaines
options ODBC ne sont pas disponibles car elles doivent être
fixées avant l'établissement de la connexion. Cependant,
si dans un cas bien spécifique, odbc_setoption()
vous permet d'utiliser PHP sans que votre patron ne vous pousse à
utiliser un produit commercial, alors cela n'a pas d'importance.
Liste de paramètres
-
odbc
-
Un identifiant de connexion, ou un identifiant
de résultat, pour lequel vous souhaitez modifier des options.
Pour SQLSetConnectOption()
, c'est un identifiant de connexion.
Pour SQLSetStmtOption()
, c'est un identifiant de résultat.
-
which
-
Fonction ODBC à utiliser.
La valeur doit être de 1 pour utiliser SQLSetConnectOption()
et 2
pour SQLSetStmtOption()
.
-
option
-
L'option à définir.
-
value
-
La valeur pour l'option donnée.
Valeurs de retour
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
Exemples
Exemple #1 Exemple avec odbc_setoption()
<?php
// 1. L'option 102 de SQLSetConnectOption() est SQL_AUTOCOMMIT.
// 1 de SQL_AUTOCOMMIT est SQL_AUTOCOMMIT_ON.
// Cet exemple a le même effet que
// odbc_autocommit($conn, true);
odbc_setoption($conn, 1, 102, 1);
// 2. Option 0 de SQLSetStmtOption() est SQL_QUERY_TIMEOUT.
// Cet exemple fixe le délai d'expiration à 30 secondes.
$result = odbc_prepare($conn, $sql);
odbc_setoption($result, 2, 0, 30);
odbc_execute($result);
?>