odbc_setoption
(PHP 4, PHP 5)
odbc_setoption — Modifie les param�tres ODBC
Description
odbc_setoption() donne acc�s aux options ODBC pour une connexion particuli�re ou un r�sultat de requ�te. Elle a �t� �crite pour aider � la r�solution de probl�mes li�s aux pilotes ODBC r�calcitrants. Vous aurez s�rement � utiliser odbc_setoption() si vous �tes un programmeur ODBC et que vous comprenez les divers effets des options disponibles. Vous aurez aussi besoin d'un bon manuel de r�f�rence pour comprendre les options et leur usage. Diff�rentes versions de pilotes supportent diff�rentes versions d'options.
�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
- id
-
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.
- function
-
Fonction ODBC � utiliser. La valeur doit �tre de 1 pour utiliser SQLSetConnectOption() et 2 pour SQLSetStmtOption().
- option
-
L'option � d�finir.
- param
-
La valeur pour l'option donn�e.
Valeurs de retour
Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec.
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);
?>