odbc-execute.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ed1aff13602c94f86344bdd7c4fbc31f5a71bf84 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.odbc-execute" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>odbc_execute</refname>
  <refpurpose>Exécute une requête SQL préparée</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>odbc_execute</methodname>
   <methodparam><type>Odbc\Result</type><parameter>statement</parameter></methodparam>
   <methodparam choice="opt"><type>array</type><parameter>params</parameter><initializer>[]</initializer></methodparam>
  </methodsynopsis>
  <para>
   Exécute une requête SQL préparée par <function>odbc_prepare</function>.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>statement</parameter></term>
     <listitem>
      <para>
       &odbc.result.object; depuis <function>odbc_prepare</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>params</parameter></term>
     <listitem>
      <para>
       Les valeurs du paramètre <parameter>params</parameter> seront
       substituées dans les variables de requêtes de la requête préparée.
       Les éléments de ce tableau seront convertis en chaînes de caractères en
       appelant cette fonction.
      </para>
      <para>
       Tout paramètre de <parameter>params</parameter> qui
       commence et termine par des guillemets simples sera considéré
       comme un nom de fichier à lire et envoyé à la base de données,
       avec la variable de requête appropriée.
      </para>
      <simpara>
       Pour stocker une chaîne de caractères qui commence et se finit
       réellement par des guillemets, il faut ajouter un espace au début
       ou à la fin de la chaîne, pour éviter que ce paramètre soit confondu avec
       un nom de fichier. Si ce n'est pas possible dans le cadre de l'application,
       il faudra passer par la fonction <function>odbc_exec</function>.
      </simpara>
     </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>
     &odbc.changelog.result-return;
     <row>
      <entry>8.0.0</entry>
      <entry>
       Le paramètre <parameter>flags</parameter>, inutilisé, a été supprimé.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>
     Exemple avec <function>odbc_execute</function> et
     <function>odbc_prepare</function>
    </title>
    <para>
     Dans le script suivant, <varname>$success</varname> ne sera
     possible que si les trois paramètres de <literal>maproc</literal>
     sont des paramètres de type IN :
    </para>
    <programlisting role="php">
<![CDATA[
<?php
$a = 1;
$b = 2;
$c = 3;
$stmt    = odbc_prepare($conn, 'CALL maproc(?,?,?)');
$success = odbc_execute($stmt, array($a, $b, $c));
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   S'il faut appeler une procédure stockée en utilisant des paramètres
   INOUT ou OUT, la solution est d'utiliser une extension native de la
   base de données
   (par exemple pour <link linkend="ref.oci8">oci8</link> pour Oracle).
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>odbc_prepare</function></member>
   </simplelist>
   </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
-->