odbc_setoption

(PHP 4, PHP 5)

odbc_setoptionModifie les param�tres ODBC

Description

bool odbc_setoption ( resource $id , int $function , int $option , int $param )

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($conn11021);

// 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($result2030);
odbc_execute($result);
?>