<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: ed1aff13602c94f86344bdd7c4fbc31f5a71bf84 Maintainer: dams Status: ready -->

<!-- Reviewed: yes -->

<refentry xml:id="function.odbc-setoption" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>odbc_setoption</refname>

<refpurpose>Modifie les paramètres ODBC</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>bool</type><methodname>odbc_setoption</methodname>

<methodparam><type class="union"><type>Odbc\Connection</type><type>Odbc\Result</type></type><parameter>odbc</parameter></methodparam>

<methodparam><type>int</type><parameter>which</parameter></methodparam>

<methodparam><type>int</type><parameter>option</parameter></methodparam>

<methodparam><type>int</type><parameter>value</parameter></methodparam>

</methodsynopsis>

<para>

<function>odbc_setoption</function> 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. Il sera sûrement à utiliser

<function>odbc_setoption</function> en tant que programmeur

ODBC comprenant les divers effets des options disponibles.

Il sera 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.

</para>

<para>

Étant donné que les effets peuvent varier d'un pilote à

l'autre, l'utilisation de <function>odbc_setoption</function> 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, <function>odbc_setoption</function>

permet d'utiliser PHP sans qu'il soit nécessaire de recourir à

utiliser un produit commercial, alors cela n'a pas d'importance.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>odbc</parameter></term>

<listitem>

<para>

Un identifiant de connexion, ou un identifiant

de résultat, pour lequel il faut modifier des options.

Pour <literal>SQLSetConnectOption()</literal>, c'est un identifiant de connexion.

Pour <literal>SQLSetStmtOption()</literal>, c'est un identifiant de résultat.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>which</parameter></term>

<listitem>

<para>

Fonction ODBC à utiliser.

La valeur doit être de 1 pour utiliser <literal>SQLSetConnectOption()</literal> et 2

pour <literal>SQLSetStmtOption()</literal>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>option</parameter></term>

<listitem>

<para>

L'option à définir.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>value</parameter></term>

<listitem>

<para>

La valeur pour l'option donnée.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

&return.success;

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.4.0</entry>

<entry>

<parameter>odbc</parameter> attend désormais une instance de <classname>Odbc\Connection</classname>

ou de <classname>Odbc\Result</classname>; auparavant, une <type>resource</type> était attendue.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Exemple avec <function>odbc_setoption</function></title>

<programlisting role="php">

<![CDATA[

<?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);

?>

]]>

</programlisting>

</example>

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->