cvs: phpdoc /fr/functions oracle.xml
| From: | Damien Seguy | Date: | Fri, 24 Nov 2000 11:08:23 +0000 |
| Subject: | cvs: phpdoc /fr/functions oracle.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333071@lists.php.net to get a copy of this message | ||
dams Fri Nov 24 03:08:23 2000 EDT
Modified files:
/phpdoc/fr/functions oracle.xml
Log:
Added functions and funcprototype.
Index: phpdoc/fr/functions/oracle.xml diff -u phpdoc/fr/functions/oracle.xml:1.1 phpdoc/fr/functions/oracle.xml:1.2 --- phpdoc/fr/functions/oracle.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/oracle.xml Fri Nov 24 03:08:22 2000 @@ -1,490 +1,668 @@ - <reference id="ref.oracle"> - <title>Fonctions Oracle</title> - <titleabbrev>Oracle</titleabbrev> - - <refentry id="function.ora-bind"> - <refnamediv> - <refname>Ora_Bind</refname> - <refpurpose>Lie une variable PHP à un paramètre Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_bind</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>string <parameter>PHP variable name</parameter></paramdef> - <paramdef>string <parameter>SQL parameter name</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - <paramdef>int <parameter><optional>type</optional></parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_bind</function> retourne TRUE si la liaison a pu se faire, et - sinon FALSE. Les erreurs sont accessibles avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - <para> - Cette fonction lie une variable PHP avec un paramètre SQL. Le paramètre SQL - doit être de la forme ":name". Avec l'option, vous pouvez choisir si le paramètre - SQL est de type entrée/sortie (0, valeur par défaut), entrée seulement (1) ou - sortie seulement (2). Comme dans PHP 3.0.1, vous pouvez respectivement utiliser - les constantes ORA_BIND_INOUT, ORA_BIND_IN eet ORA_BIND_OUT plutôt que des nombres. - </para> - <para> - <function>ora_bind</function> doit être appelée après la fonction - <function>ora_parse</function> et avant <function>ora_exec</function>. Les valeurs - d'entrées peuvent alors être fournies par assignation des variables PHP. Après la - fonction <function>ora_exec</function> les variables liées contiennent les valeurs - de sorties, si elles sont disponibles. Par exemple : - -<informalexample> - <programlisting role="php"> -<?php -ora_parse($curs, "declare tmp INTEGER; begin tmp := :in; :out := tmp; :x := 7.77; end;"); -ora_bind($curs, "result", ":x", $len, 2); -ora_bind($curs, "input", ":in", 5, 1); -ora_bind($curs, "output", ":out", 5, 2); -$input = 765; -ora_exec($curs); -echo "Résultat: $result<BR>Sortie: $output<BR>Entrée: $input"; -?> -</programlisting> - </informalexample></para> - - </refsect1> - </refentry> - - <refentry id="function.ora-close"> - <refnamediv> - <refname>Ora_Close</refname> - <refpurpose>Ferme un pointeur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_close</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - </funcsynopsis> - <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. - Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - <para> - Cette fonction termine les pointeurs ouverts avec la fonction - <function>ora_open</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.ora-columnname"> - <refnamediv> - <refname>Ora_ColumnName</refname> - <refpurpose>Retourne le nom de la colonne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>Ora_ColumnName</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>int <parameter>column</parameter></paramdef> - </funcsynopsis> - <para> - <function>Ora_ColumnName</function> retourne le nom du champs - <parameter>column</parameter> du pointeur <parameter>cursor</parameter>. - Le nom retourné sera en majuscule. - </para> - </refsect1> - </refentry> - - <refentry id="function.ora-columntype"> - <refnamediv> - <refname>Ora_ColumnType</refname> - <refpurpose>Retourne le type de la colonne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>Ora_ColumnType</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>int <parameter>column</parameter></paramdef> - </funcsynopsis> - <para> - <function>Ora_ColumnType</function> retourne le type de la colonne - <parameter>column</parameter> du résultat <parameter>cursor</parameter>. - Le type retourné prendra une des valeurs suivantes : - <simplelist> - <member><literal>"VARCHAR2"</literal></member> - <member><literal>"VARCHAR"</literal></member> - <member><literal>"CHAR"</literal></member> - <member><literal>"NUMBER"</literal></member> - <member><literal>"LONG"</literal></member> - <member><literal>"LONG RAW"</literal></member> - <member><literal>"ROWID"</literal></member> - <member><literal>"DATE"</literal></member> - <member><literal>"CURSOR"</literal></member> - </simplelist></para> - </refsect1> - </refentry> - - - <refentry id="function.ora-commit"> - <refnamediv> - <refname>Ora_Commit</refname> - <refpurpose>Valide une transaction Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_commit</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> - </funcsynopsis> - <para> - Retourne TRUE si la validation a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - <para> - Cette fonction valide les transactions Oracle. Une transaction est définie par - toutes les requêtes effectuées sur la connexion conn depuis la dernière - validation ou annulation (avec auto-validation inactivée) ou depuis - l'établissement de la connexion. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-commitoff"> - <refnamediv> - <refname>Ora_CommitOff</refname> - <refpurpose>Inactive la validation automatique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_commitoff</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_commitoff</function> retourne TRUE si la désactivation a bien - eu lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - <para> - Inactive la validation automatique après chaque<function>ora_exec</function>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-commiton"> - <refnamediv> - <refname>Ora_CommitOn</refname> - <refpurpose>Active la validation automatique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_commiton</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_commiton</function> active la validation automatique après chaque - <function>ora_exec</function>. - </para> - - <para> - Retourne TRUE si l'activation a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-error"> - <refnamediv> - <refname>Ora_Error</refname> - <refpurpose>Retourne le message d'erreur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>Ora_Error</function></funcdef> - <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> - </funcsynopsis> - <para> - Retourne un messages d'erreur de la forme - <replaceable>XXX</replaceable>-<replaceable>NNNNN</replaceable> avec - <replaceable>XXX</replaceable> qui est l'origine de l'erreur, et - <replaceable>NNNNN</replaceable> qui identifie le message d'erreur. - <note> - <para> - Le support des connexions a été ajouté dans PHP 3.0.4. - </para> - </note></para> - <para> - Avec les versions UNIX d'Oracle, vous pouvez avoir des messages d'erreurs tels que : - <computeroutput><prompt>$</prompt> <userinput>oerr ora <replaceable>00001</replaceable></userinput> - 00001, 00000, "unique constraint (%s.%s) violated" // *Cause: An update or insert -statement attempted to insert a duplicate key // For Trusted -ORACLE configured in DBMS MAC mode, you may see // this message -if a duplicate entry exists at a different level. // *Action: Either -remove the unique restriction or do not insert the key </computeroutput>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-errorcode"> - <refnamediv> - <refname>Ora_ErrorCode</refname> - <refpurpose>Retourne le code d'erreur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>Ora_ErrorCode</function></funcdef> - <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>Ora_ErrorCode</function> retourne le code d'erreur numérique de la - dernière commande exécuté sur la connexion ou le pointeur fourni en paramètre. - <note> - <para> - Les identifiants de connexion ne sont acceptés qu'à partir de la version - 3.0.4. - </para> - </note> - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-exec"> - <refnamediv> - <refname>Ora_Exec</refname> - <refpurpose>Exécute une commande analysée sur un pointeur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_exec</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_exec</function> retourne TRUE en cas de succès, et FALSE en cas - d'erreur. L'erreur générée sera alors accessible avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-fetch"> - <refnamediv> - <refname>Ora_Fetch</refname> - <refpurpose>Retourne une ligne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_fetch</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_fetch</function> retourne TRUE (une ligne a été lue) ou FALSE - (plus de lignes à lire ou erreur). Si une erreur survient, sa valeur sera - disponible dans les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - <para> - Lit une ligne de données sur le pointeur cursor. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-getcolumn"> - <refnamediv> - <refname>Ora_GetColumn</refname> - <refpurpose>Retourne une donnée d'une ligne lue.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>mixed <function>ora_getcolumn</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>mixed <parameter>column</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_getcolumn</function> retourne la valeur de la colonne. Si une erreur - survient, FALSE est retourné et <function>ora_errorcode</function> aura une valeur - non nulle. Notez, qu'un test à FALSE, avec cette fonction peut être TRUE, même sans - erreur : en effet, la fonction peut retourner des valeurs telles que (résultat NULL, - chaînes vides, nombre 0, la chaîne "0"). - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-logoff"> - <refnamediv> - <refname>Ora_Logoff</refname> - <refpurpose>Ferme une connexion Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_logoff</function></funcdef> - <paramdef>int <parameter>connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_logoff</function> retourne TRUE si la fermeture a bien eu lieu, et - FALSE sinon. Les erreurs sont accessibles avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - <para> - Déconnecte l'utilisateur, et se déconnecte. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-logon"> - <refnamediv> - <refname>Ora_Logon</refname> - <refpurpose>Ouvre une connexion Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_logon</function></funcdef> - <paramdef>string <parameter>user</parameter></paramdef> - <paramdef>string <parameter>password</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_logon</function> établit une connexion entre PHP et un serveur - Oracle avec les noms d'utilisateur user et le mot de passe password. - </para> - - <para> - Les connexions peut être faîtes avec <productname>SQL*Net</productname> - en fournissant le nom <acronym>TNS</acronym> de la manière suivante : - <informalexample> - <programlisting role="php"> -$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass"); -</programlisting> - </informalexample></para> - - <para> - Si vous avez des données qui ne sont pas ASCII, vous devriez vérifier que la - variable <envar>NLS_LANG</envar> a été correctement configuré dans votre - environnement. - Pour les modules de serveur, vous devrez la configurer dans l'environnement - d'exécution du serveur avant de le lancer. - </para> - - <para> - Retourne un index de connexion, en cas de succès, ou FALSE en cas d'échec. - Les erreurs sont accessibles avec les fonctions <function>ora_error</function> - et <function>ora_errorcode</function>. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-open"> - <refnamediv> - <refname>Ora_Open</refname> - <refpurpose>Ouvre un pointeur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_open</function></funcdef> - <paramdef>int <parameter>connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_open</function> ouvre un pointeur Oracle sur la connexion. - </para> - - <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-parse"> - <refnamediv> - <refname>Ora_Parse</refname> - <refpurpose>Analyse une requête SQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_parse</function></funcdef> - <paramdef>int <parameter>cursor_ind</parameter></paramdef> - <paramdef>string <parameter>sql_statement</parameter></paramdef> - <paramdef>int <parameter>defer</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_parse</function> analyse une requête SQL ou un bloc PL/SQL et - l'associe avec le pointeur cursor_ind. Retourne 0 en cas de succès, et -1 en cas - d'erreur. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-rollback"> - <refnamediv> - <refname>Ora_Rollback</refname> - <refpurpose>Annule une transaction.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_rollback</function></funcdef> - <paramdef>int <parameter>connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_rollback</function> annule une transaction Oracle. (Voir - <function>ora_commit</function> pour la définition d'une transaction). - </para> - - <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - </refsect1> - </refentry> - - - </reference> - -<!-- 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 -sgml-parent-document:nil -sgml-default-dtd-file:"../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> + <reference id="ref.oracle"> + <title>Fonctions Oracle</title> + <titleabbrev>Oracle</titleabbrev> + <refentry id="function.ora-bind"> + <refnamediv> + <refname>Ora_Bind</refname> + <refpurpose>Lie une variable PHP à un paramètre Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_bind</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>string <parameter>PHP variable name</parameter></paramdef> + <paramdef>string <parameter>SQL parameter name</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>int <parameter><optional>type</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_bind</function> retourne TRUE si la liaison a pu se faire, et + sinon FALSE. Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + Cette fonction lie une variable PHP avec un paramètre SQL. Le + paramètre SQL doit être de la forme ":name". Avec l'option, + vous pouvez choisir si le paramètre SQL est de type entrée/sortie + (0, valeur par défaut), entrée seulement (1) ou sortie + seulement (2). Comme dans PHP 3.0.1, vous pouvez respectivement utiliser + les constantes ORA_BIND_INOUT, ORA_BIND_IN eet ORA_BIND_OUT plutôt + que des nombres. + </para> + <para> + <function>ora_bind</function> doit être appelée après + la fonction <function>ora_parse</function> et avant + <function>ora_exec</function>. Les valeurs d'entrées peuvent alors + être fournies par assignation des variables PHP. Après la + fonction <function>ora_exec</function> les variables liées + contiennent les valeurs de sortie, si elles sont disponibles. Par exemple : + <informalexample> + <programlisting role="php"> +<?php +ora_parse($curs, "declare tmp INTEGER; begin tmp := :in; :out := tmp; :x := 7.77; end;"); +ora_bind($curs, "result", ":x", $len, 2); +ora_bind($curs, "input", ":in", 5, 1); +ora_bind($curs, "output", ":out", 5, 2); +$input = 765; +ora_exec($curs); +echo "Résultat: $result<BR>Sortie: $output<BR>Entrée: $input"; +?> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + <refentry id="function.ora-close"> + <refnamediv> + <refname>Ora_Close</refname> + <refpurpose>Ferme un pointeur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_close</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_close</function> retourne TRUE si la fermeture a bien eu + lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + <function>ora_close</function> termine les pointeurs ouverts avec la fonction + <function>ora_open</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-columnname"> + <refnamediv> + <refname>Ora_ColumnName</refname> + <refpurpose>Retourne le nom de la colonne de résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_columnname</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>int <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_columnname</function> retourne le nom du champs + <parameter>column</parameter> du pointeur <parameter>cursor</parameter>. + Le nom retourné sera en majuscule. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-columnsize"> + <refnamediv> + <refname>Ora_ColumnSize</refname> + <refpurpose>Lit la taille d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_columnsize</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>int <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_columnsize</function> retourne la taille de la + colonne <parameter>column</parameter> dans le résultat + <parameter>cursor</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-columntype"> + <refnamediv> + <refname>Ora_ColumnType</refname> + <refpurpose>Retourne le type de la colonne de résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_columntype</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>int <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_columntype</function> retourne le type de la colonne + <parameter>column</parameter> du résultat + <parameter>cursor</parameter>. Le type retourné prendra + une des valeurs suivantes : + <simplelist> + <member><literal>"VARCHAR2"</literal></member> + <member><literal>"VARCHAR"</literal></member> + <member><literal>"CHAR"</literal></member> + <member><literal>"NUMBER"</literal></member> + <member><literal>"LONG"</literal></member> + <member><literal>"LONG RAW"</literal></member> + <member><literal>"ROWID"</literal></member> + <member><literal>"DATE"</literal></member> + <member><literal>"CURSOR"</literal></member> + </simplelist></para> + </refsect1> + </refentry> + <refentry id="function.ora-commit"> + <refnamediv> + <refname>Ora_Commit</refname> + <refpurpose>Valide une transaction Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_commit</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_commit</function> retourne TRUE si la validation a bien eu + lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + <function>ora_commit</function> valide les transactions Oracle. Une + transaction est définie par toutes les requêtes + effectuées sur la connexion conn depuis la dernière + validation ou annulation (avec auto-validation inactivée) ou + depuis l'établissement de la connexion. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-commitoff"> + <refnamediv> + <refname>Ora_CommitOff</refname> + <refpurpose>Inactive la validation automatique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_commitoff</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_commitoff</function> retourne TRUE si la + désactivation a bien eu lieu, et FALSE sinon. Les erreurs + sont accessibles avec les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + <para> + <function>ora_commitoff</function> inactive la validation + automatique après chaque <function>ora_exec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-commiton"> + <refnamediv> + <refname>Ora_CommitOn</refname> + <refpurpose>Active la validation automatique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_commiton</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_commiton</function> active la validation + automatique après chaque <function>ora_exec</function>. + </para> + <para> + <function>ora_commiton</function> retourne TRUE si l'activation a + bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec les + fonctions <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-do"> + <refnamediv> + <refname>Ora_Do</refname> + <refpurpose>Analyse, exécute et lit une requête</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_do</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_do</function> est une combinaison de + <function>ora_parse</function>, <function>ora_exec</function> et + <function>ora_fetch</function>. Elle va analyser la requête, l'éxécuter + et lire la première ligne du résultat. + </para> + <para> + <function>ora_do</function> retourne TRUE en cas de succès, et FALSE sinon. Le détails sur les erreurs est accessible avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + et <function>ora_fetch</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-error"> + <refnamediv> + <refname>Ora_Error</refname> + <refpurpose>Retourne le message d'erreur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_error</function></funcdef> + <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_error</function> etourne un messages d'erreur de la forme + <replaceable>XXX</replaceable>-<replaceable>NNNNN</replaceable> avec + <replaceable>XXX</replaceable> qui est l'origine de l'erreur, et + <replaceable>NNNNN</replaceable> qui identifie le message d'erreur. + <note> + <para> + Le support des connexions a été ajouté dans PHP 3.0.4. + </para> + </note> + </para> + <para> + Avec les versions UNIX d'Oracle, vous pouvez avoir des messages + d'erreur tels que : + <computeroutput><prompt>$</prompt> <userinput>oerr ora <replaceable>00001</replaceable></userinput> + 00001, 00000, "unique constraint (%s.%s) violated" // *Cause: An update or insert +statement attempted to insert a duplicate key // For Trusted +ORACLE configured in DBMS MAC mode, you may see // this message +if a duplicate entry exists at a different level. // *Action: Either +remove the unique restriction or do not insert the key </computeroutput>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-errorcode"> + <refnamediv> + <refname>Ora_ErrorCode</refname> + <refpurpose>Retourne le code d'erreur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_error</function></funcdef> + <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_errorcode</function> retourne le code d'erreur + numérique de la dernière commande exécuté + sur la connexion ou le pointeur fourni en paramètre. + <note> + <para> + Les identifiants de connexion ne sont acceptés qu'à + partir de la version 3.0.4. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.ora-exec"> + <refnamediv> + <refname>Ora_Exec</refname> + <refpurpose> + Exécute une commande analysée sur un pointeur Oracle. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_exec</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_exec</function> retourne TRUE en cas de succès, et + FALSE en cas d'erreur. L'erreur générée sera alors + accessible avec les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-fetch"> + <refnamediv> + <refname>Ora_Fetch</refname> + <refpurpose>Retourne une ligne de résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_fetch</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_fetch</function> retourne TRUE (une ligne a + été lue) ou FALSE (plus de lignes à lire ou + erreur). Si une erreur survient, sa valeur sera disponible dans + les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + <para> + Lit une ligne de données sur le pointeur cursor. + </para> + <simpara> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-fetch-into"> + <refnamediv> + <refname>Ora_Fetch_Into</refname> + <refpurpose>Lit une ligne dans un tableau</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_fetch_into</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>array <parameter>result</parameter></paramdef> + <paramdef>int + <parameter> + <optional>flags</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_fetch_into</function> lit la ligne courante du + résultat <parameter>cursor</parameter> dans le tableau + <parameter>result</parameter>. + <example> + <title>Exemple <function>ora_fetch_into</function></title> + <programlisting role="php"> +<?php +array($results); +ora_fetch_into($cursor, &$results); +echo $results[0]; +echo $results[1]; +?> + </programlisting> + </example> + Notez que vous devez passer le tableau par référence; + </para> + <simpara> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + <function>ora_fetch</function>, et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-getcolumn"> + <refnamediv> + <refname>Ora_GetColumn</refname> + <refpurpose>Retourne une donnée d'une ligne lue.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>ora_getcolumn</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>mixed <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_getcolumn</function> retourne la valeur de la + colonne. Si une erreur survient, FALSE est retourné et + <function>ora_errorcode</function> aura une valeur non nulle. + Notez, qu'un test à FALSE, avec cette fonction peut + être TRUE, même sans erreur : en effet, la fonction + peut retourner des valeurs telles que (résultat NULL, + chaînes vides, nombre 0, la chaîne "0"). + </para> + </refsect1> + </refentry> + <refentry id="function.ora-logoff"> + <refnamediv> + <refname>Ora_Logoff</refname> + <refpurpose>Ferme une connexion Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_logoff</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_logoff</function> retourne TRUE si la fermeture a + bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec + les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + <para> + Déconnecte l'utilisateur, et se déconnecte. + </para> + <simpara> + Voir aussi <function>ora_logon</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-logon"> + <refnamediv> + <refname>Ora_Logon</refname> + <refpurpose>Ouvre une connexion Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_logon</function></funcdef> + <paramdef>string <parameter>user</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_logon</function> établit une connexion entre + PHP et un serveur Oracle avec les noms d'utilisateur user et le + mot de passe password. + </para> + <para> + Les connexions peut être faîtes avec + <productname>SQL*Net</productname> en fournissant le nom + <acronym>TNS</acronym> de la manière suivante : + <informalexample> + <programlisting role="php"> +$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass"); +</programlisting> + </informalexample> + </para> + <para> + Si vous avez des données qui ne sont pas ASCII, vous + devriez vérifier que la variable <envar>NLS_LANG</envar> + a été correctement configuré dans votre + environnement. Pour les modules de serveur, vous devrez la + configurer dans l'environnement d'exécution du serveur + avant de le lancer. + </para> + <para> + Retourne un index de connexion, en cas de succès, ou + FALSE en cas d'échec. Les erreurs sont accessibles avec + les fonctions <function>ora_error</function> + et <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-plogon"> + <refnamediv> + <refname>Ora_pLogon</refname> + <refpurpose> + Ouvre une connexion persistante à Oracle + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_plogon</function></funcdef> + <paramdef>string <parameter>user</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_plogon</function> établit une connexion persistante + à un serveur Oracle, avec l'utilisateur <parameter>user</parameter> et + le mot de passe <parameter>password</parameter>. + </para> + <simpara> + Voir aussi <function>ora_logon</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-numcols"> + <refnamediv> + <refname>Ora_Numcols</refname> + <refpurpose>Retourne le nombre de colonnes</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_numcols</function></funcdef> + <paramdef>int <parameter>cursor_ind</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_numcols</function> retourne le nombre de colonne dans le + résultat <parameter>cursor_ind</parameter>. Cette valeur n'est significative + qu'après une requête parse/exec/fetch. + </para> + <simpara> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + <function>ora_fetch</function>, et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-numrows"> + <refnamediv> + <refname>Ora_Numrows</refname> + <refpurpose>Retourne le nombre de colonnes</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_numrows</function></funcdef> + <paramdef>int <parameter>cursor_ind</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_numrows</function> retourne le nombre de colonnes + dans le résultat <parameter>cursor_ind</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-open"> + <refnamediv> + <refname>Ora_Open</refname> + <refpurpose>Ouvre un pointeur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_open</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_open</function> ouvre un pointeur Oracle sur la connexion. + </para> + <para> + Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. + Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-parse"> + <refnamediv> + <refname>Ora_Parse</refname> + <refpurpose>Analyse une requête SQL.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_parse</function></funcdef> + <paramdef>int <parameter>cursor_ind</parameter></paramdef> + <paramdef>string <parameter>sql_statement</parameter></paramdef> + <paramdef>int <parameter>defer</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_parse</function> analyse une requête SQL ou + un bloc PL/SQL et l'associe avec le pointeur cursor_ind. Retourne + 0 en cas de succès, et -1 en cas d'erreur. + </para> + <para> + Retourne 0 en cas de succès, et -1 en cas d'erreur. + </para> + <simpara> + Voir aussi <function>ora_exec</function>, + <function>ora_fetch</function>, et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-rollback"> + <refnamediv> + <refname>Ora_Rollback</refname> + <refpurpose>Annule une transaction.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_rollback</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_rollback</function> annule une transaction Oracle. (Voir + <function>ora_commit</function> pour la définition d'une transaction). + </para> + <para> + Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont + accessibles avec les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + </reference> +<!-- 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 +sgml-parent-document:nil +sgml-default-dtd-file:"../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->
Index: phpdoc/fr/functions/oracle.xml diff -u phpdoc/fr/functions/oracle.xml:1.1 phpdoc/fr/functions/oracle.xml:1.2 --- phpdoc/fr/functions/oracle.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/oracle.xml Fri Nov 24 03:08:22 2000 @@ -1,490 +1,668 @@ - <reference id="ref.oracle"> - <title>Fonctions Oracle</title> - <titleabbrev>Oracle</titleabbrev> - - <refentry id="function.ora-bind"> - <refnamediv> - <refname>Ora_Bind</refname> - <refpurpose>Lie une variable PHP à un paramètre Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_bind</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>string <parameter>PHP variable name</parameter></paramdef> - <paramdef>string <parameter>SQL parameter name</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - <paramdef>int <parameter><optional>type</optional></parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_bind</function> retourne TRUE si la liaison a pu se faire, et - sinon FALSE. Les erreurs sont accessibles avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - <para> - Cette fonction lie une variable PHP avec un paramètre SQL. Le paramètre SQL - doit être de la forme ":name". Avec l'option, vous pouvez choisir si le paramètre - SQL est de type entrée/sortie (0, valeur par défaut), entrée seulement (1) ou - sortie seulement (2). Comme dans PHP 3.0.1, vous pouvez respectivement utiliser - les constantes ORA_BIND_INOUT, ORA_BIND_IN eet ORA_BIND_OUT plutôt que des nombres. - </para> - <para> - <function>ora_bind</function> doit être appelée après la fonction - <function>ora_parse</function> et avant <function>ora_exec</function>. Les valeurs - d'entrées peuvent alors être fournies par assignation des variables PHP. Après la - fonction <function>ora_exec</function> les variables liées contiennent les valeurs - de sorties, si elles sont disponibles. Par exemple : - -<informalexample> - <programlisting role="php"> -<?php -ora_parse($curs, "declare tmp INTEGER; begin tmp := :in; :out := tmp; :x := 7.77; end;"); -ora_bind($curs, "result", ":x", $len, 2); -ora_bind($curs, "input", ":in", 5, 1); -ora_bind($curs, "output", ":out", 5, 2); -$input = 765; -ora_exec($curs); -echo "Résultat: $result<BR>Sortie: $output<BR>Entrée: $input"; -?> -</programlisting> - </informalexample></para> - - </refsect1> - </refentry> - - <refentry id="function.ora-close"> - <refnamediv> - <refname>Ora_Close</refname> - <refpurpose>Ferme un pointeur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_close</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - </funcsynopsis> - <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. - Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - <para> - Cette fonction termine les pointeurs ouverts avec la fonction - <function>ora_open</function>. - </para> - - </refsect1> - </refentry> - - <refentry id="function.ora-columnname"> - <refnamediv> - <refname>Ora_ColumnName</refname> - <refpurpose>Retourne le nom de la colonne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>Ora_ColumnName</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>int <parameter>column</parameter></paramdef> - </funcsynopsis> - <para> - <function>Ora_ColumnName</function> retourne le nom du champs - <parameter>column</parameter> du pointeur <parameter>cursor</parameter>. - Le nom retourné sera en majuscule. - </para> - </refsect1> - </refentry> - - <refentry id="function.ora-columntype"> - <refnamediv> - <refname>Ora_ColumnType</refname> - <refpurpose>Retourne le type de la colonne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>Ora_ColumnType</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>int <parameter>column</parameter></paramdef> - </funcsynopsis> - <para> - <function>Ora_ColumnType</function> retourne le type de la colonne - <parameter>column</parameter> du résultat <parameter>cursor</parameter>. - Le type retourné prendra une des valeurs suivantes : - <simplelist> - <member><literal>"VARCHAR2"</literal></member> - <member><literal>"VARCHAR"</literal></member> - <member><literal>"CHAR"</literal></member> - <member><literal>"NUMBER"</literal></member> - <member><literal>"LONG"</literal></member> - <member><literal>"LONG RAW"</literal></member> - <member><literal>"ROWID"</literal></member> - <member><literal>"DATE"</literal></member> - <member><literal>"CURSOR"</literal></member> - </simplelist></para> - </refsect1> - </refentry> - - - <refentry id="function.ora-commit"> - <refnamediv> - <refname>Ora_Commit</refname> - <refpurpose>Valide une transaction Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_commit</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> - </funcsynopsis> - <para> - Retourne TRUE si la validation a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - <para> - Cette fonction valide les transactions Oracle. Une transaction est définie par - toutes les requêtes effectuées sur la connexion conn depuis la dernière - validation ou annulation (avec auto-validation inactivée) ou depuis - l'établissement de la connexion. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-commitoff"> - <refnamediv> - <refname>Ora_CommitOff</refname> - <refpurpose>Inactive la validation automatique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_commitoff</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_commitoff</function> retourne TRUE si la désactivation a bien - eu lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - <para> - Inactive la validation automatique après chaque<function>ora_exec</function>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-commiton"> - <refnamediv> - <refname>Ora_CommitOn</refname> - <refpurpose>Active la validation automatique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_commiton</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_commiton</function> active la validation automatique après chaque - <function>ora_exec</function>. - </para> - - <para> - Retourne TRUE si l'activation a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-error"> - <refnamediv> - <refname>Ora_Error</refname> - <refpurpose>Retourne le message d'erreur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>Ora_Error</function></funcdef> - <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> - </funcsynopsis> - <para> - Retourne un messages d'erreur de la forme - <replaceable>XXX</replaceable>-<replaceable>NNNNN</replaceable> avec - <replaceable>XXX</replaceable> qui est l'origine de l'erreur, et - <replaceable>NNNNN</replaceable> qui identifie le message d'erreur. - <note> - <para> - Le support des connexions a été ajouté dans PHP 3.0.4. - </para> - </note></para> - <para> - Avec les versions UNIX d'Oracle, vous pouvez avoir des messages d'erreurs tels que : - <computeroutput><prompt>$</prompt> <userinput>oerr ora <replaceable>00001</replaceable></userinput> - 00001, 00000, "unique constraint (%s.%s) violated" // *Cause: An update or insert -statement attempted to insert a duplicate key // For Trusted -ORACLE configured in DBMS MAC mode, you may see // this message -if a duplicate entry exists at a different level. // *Action: Either -remove the unique restriction or do not insert the key </computeroutput>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-errorcode"> - <refnamediv> - <refname>Ora_ErrorCode</refname> - <refpurpose>Retourne le code d'erreur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>Ora_ErrorCode</function></funcdef> - <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>Ora_ErrorCode</function> retourne le code d'erreur numérique de la - dernière commande exécuté sur la connexion ou le pointeur fourni en paramètre. - <note> - <para> - Les identifiants de connexion ne sont acceptés qu'à partir de la version - 3.0.4. - </para> - </note> - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-exec"> - <refnamediv> - <refname>Ora_Exec</refname> - <refpurpose>Exécute une commande analysée sur un pointeur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_exec</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_exec</function> retourne TRUE en cas de succès, et FALSE en cas - d'erreur. L'erreur générée sera alors accessible avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - - </refsect1> - </refentry> - - - <refentry id="function.ora-fetch"> - <refnamediv> - <refname>Ora_Fetch</refname> - <refpurpose>Retourne une ligne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_fetch</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_fetch</function> retourne TRUE (une ligne a été lue) ou FALSE - (plus de lignes à lire ou erreur). Si une erreur survient, sa valeur sera - disponible dans les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - <para> - Lit une ligne de données sur le pointeur cursor. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-getcolumn"> - <refnamediv> - <refname>Ora_GetColumn</refname> - <refpurpose>Retourne une donnée d'une ligne lue.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>mixed <function>ora_getcolumn</function></funcdef> - <paramdef>int <parameter>cursor</parameter></paramdef> - <paramdef>mixed <parameter>column</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_getcolumn</function> retourne la valeur de la colonne. Si une erreur - survient, FALSE est retourné et <function>ora_errorcode</function> aura une valeur - non nulle. Notez, qu'un test à FALSE, avec cette fonction peut être TRUE, même sans - erreur : en effet, la fonction peut retourner des valeurs telles que (résultat NULL, - chaînes vides, nombre 0, la chaîne "0"). - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-logoff"> - <refnamediv> - <refname>Ora_Logoff</refname> - <refpurpose>Ferme une connexion Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_logoff</function></funcdef> - <paramdef>int <parameter>connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_logoff</function> retourne TRUE si la fermeture a bien eu lieu, et - FALSE sinon. Les erreurs sont accessibles avec les fonctions - <function>ora_error</function> et <function>ora_errorcode</function>. - </para> - <para> - Déconnecte l'utilisateur, et se déconnecte. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-logon"> - <refnamediv> - <refname>Ora_Logon</refname> - <refpurpose>Ouvre une connexion Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_logon</function></funcdef> - <paramdef>string <parameter>user</parameter></paramdef> - <paramdef>string <parameter>password</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_logon</function> établit une connexion entre PHP et un serveur - Oracle avec les noms d'utilisateur user et le mot de passe password. - </para> - - <para> - Les connexions peut être faîtes avec <productname>SQL*Net</productname> - en fournissant le nom <acronym>TNS</acronym> de la manière suivante : - <informalexample> - <programlisting role="php"> -$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass"); -</programlisting> - </informalexample></para> - - <para> - Si vous avez des données qui ne sont pas ASCII, vous devriez vérifier que la - variable <envar>NLS_LANG</envar> a été correctement configuré dans votre - environnement. - Pour les modules de serveur, vous devrez la configurer dans l'environnement - d'exécution du serveur avant de le lancer. - </para> - - <para> - Retourne un index de connexion, en cas de succès, ou FALSE en cas d'échec. - Les erreurs sont accessibles avec les fonctions <function>ora_error</function> - et <function>ora_errorcode</function>. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-open"> - <refnamediv> - <refname>Ora_Open</refname> - <refpurpose>Ouvre un pointeur Oracle.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_open</function></funcdef> - <paramdef>int <parameter>connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_open</function> ouvre un pointeur Oracle sur la connexion. - </para> - - <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-parse"> - <refnamediv> - <refname>Ora_Parse</refname> - <refpurpose>Analyse une requête SQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_parse</function></funcdef> - <paramdef>int <parameter>cursor_ind</parameter></paramdef> - <paramdef>string <parameter>sql_statement</parameter></paramdef> - <paramdef>int <parameter>defer</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_parse</function> analyse une requête SQL ou un bloc PL/SQL et - l'associe avec le pointeur cursor_ind. Retourne 0 en cas de succès, et -1 en cas - d'erreur. - </para> - </refsect1> - </refentry> - - - <refentry id="function.ora-rollback"> - <refnamediv> - <refname>Ora_Rollback</refname> - <refpurpose>Annule une transaction.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>ora_rollback</function></funcdef> - <paramdef>int <parameter>connection</parameter></paramdef> - </funcsynopsis> - <para> - <function>ora_rollback</function> annule une transaction Oracle. (Voir - <function>ora_commit</function> pour la définition d'une transaction). - </para> - - <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont - accessibles avec les fonctions <function>ora_error</function> et - <function>ora_errorcode</function>. - </para> - </refsect1> - </refentry> - - - </reference> - -<!-- 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 -sgml-parent-document:nil -sgml-default-dtd-file:"../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> + <reference id="ref.oracle"> + <title>Fonctions Oracle</title> + <titleabbrev>Oracle</titleabbrev> + <refentry id="function.ora-bind"> + <refnamediv> + <refname>Ora_Bind</refname> + <refpurpose>Lie une variable PHP à un paramètre Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_bind</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>string <parameter>PHP variable name</parameter></paramdef> + <paramdef>string <parameter>SQL parameter name</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>int <parameter><optional>type</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_bind</function> retourne TRUE si la liaison a pu se faire, et + sinon FALSE. Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + Cette fonction lie une variable PHP avec un paramètre SQL. Le + paramètre SQL doit être de la forme ":name". Avec l'option, + vous pouvez choisir si le paramètre SQL est de type entrée/sortie + (0, valeur par défaut), entrée seulement (1) ou sortie + seulement (2). Comme dans PHP 3.0.1, vous pouvez respectivement utiliser + les constantes ORA_BIND_INOUT, ORA_BIND_IN eet ORA_BIND_OUT plutôt + que des nombres. + </para> + <para> + <function>ora_bind</function> doit être appelée après + la fonction <function>ora_parse</function> et avant + <function>ora_exec</function>. Les valeurs d'entrées peuvent alors + être fournies par assignation des variables PHP. Après la + fonction <function>ora_exec</function> les variables liées + contiennent les valeurs de sortie, si elles sont disponibles. Par exemple : + <informalexample> + <programlisting role="php"> +<?php +ora_parse($curs, "declare tmp INTEGER; begin tmp := :in; :out := tmp; :x := 7.77; end;"); +ora_bind($curs, "result", ":x", $len, 2); +ora_bind($curs, "input", ":in", 5, 1); +ora_bind($curs, "output", ":out", 5, 2); +$input = 765; +ora_exec($curs); +echo "Résultat: $result<BR>Sortie: $output<BR>Entrée: $input"; +?> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + <refentry id="function.ora-close"> + <refnamediv> + <refname>Ora_Close</refname> + <refpurpose>Ferme un pointeur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_close</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_close</function> retourne TRUE si la fermeture a bien eu + lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + <function>ora_close</function> termine les pointeurs ouverts avec la fonction + <function>ora_open</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-columnname"> + <refnamediv> + <refname>Ora_ColumnName</refname> + <refpurpose>Retourne le nom de la colonne de résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_columnname</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>int <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_columnname</function> retourne le nom du champs + <parameter>column</parameter> du pointeur <parameter>cursor</parameter>. + Le nom retourné sera en majuscule. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-columnsize"> + <refnamediv> + <refname>Ora_ColumnSize</refname> + <refpurpose>Lit la taille d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_columnsize</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>int <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_columnsize</function> retourne la taille de la + colonne <parameter>column</parameter> dans le résultat + <parameter>cursor</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-columntype"> + <refnamediv> + <refname>Ora_ColumnType</refname> + <refpurpose>Retourne le type de la colonne de résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_columntype</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>int <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_columntype</function> retourne le type de la colonne + <parameter>column</parameter> du résultat + <parameter>cursor</parameter>. Le type retourné prendra + une des valeurs suivantes : + <simplelist> + <member><literal>"VARCHAR2"</literal></member> + <member><literal>"VARCHAR"</literal></member> + <member><literal>"CHAR"</literal></member> + <member><literal>"NUMBER"</literal></member> + <member><literal>"LONG"</literal></member> + <member><literal>"LONG RAW"</literal></member> + <member><literal>"ROWID"</literal></member> + <member><literal>"DATE"</literal></member> + <member><literal>"CURSOR"</literal></member> + </simplelist></para> + </refsect1> + </refentry> + <refentry id="function.ora-commit"> + <refnamediv> + <refname>Ora_Commit</refname> + <refpurpose>Valide une transaction Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_commit</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_commit</function> retourne TRUE si la validation a bien eu + lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + <function>ora_commit</function> valide les transactions Oracle. Une + transaction est définie par toutes les requêtes + effectuées sur la connexion conn depuis la dernière + validation ou annulation (avec auto-validation inactivée) ou + depuis l'établissement de la connexion. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-commitoff"> + <refnamediv> + <refname>Ora_CommitOff</refname> + <refpurpose>Inactive la validation automatique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_commitoff</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_commitoff</function> retourne TRUE si la + désactivation a bien eu lieu, et FALSE sinon. Les erreurs + sont accessibles avec les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + <para> + <function>ora_commitoff</function> inactive la validation + automatique après chaque <function>ora_exec</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-commiton"> + <refnamediv> + <refname>Ora_CommitOn</refname> + <refpurpose>Active la validation automatique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_commiton</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_commiton</function> active la validation + automatique après chaque <function>ora_exec</function>. + </para> + <para> + <function>ora_commiton</function> retourne TRUE si l'activation a + bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec les + fonctions <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-do"> + <refnamediv> + <refname>Ora_Do</refname> + <refpurpose>Analyse, exécute et lit une requête</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_do</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_do</function> est une combinaison de + <function>ora_parse</function>, <function>ora_exec</function> et + <function>ora_fetch</function>. Elle va analyser la requête, l'éxécuter + et lire la première ligne du résultat. + </para> + <para> + <function>ora_do</function> retourne TRUE en cas de succès, et FALSE sinon. Le détails sur les erreurs est accessible avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + <para> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + et <function>ora_fetch</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-error"> + <refnamediv> + <refname>Ora_Error</refname> + <refpurpose>Retourne le message d'erreur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_error</function></funcdef> + <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_error</function> etourne un messages d'erreur de la forme + <replaceable>XXX</replaceable>-<replaceable>NNNNN</replaceable> avec + <replaceable>XXX</replaceable> qui est l'origine de l'erreur, et + <replaceable>NNNNN</replaceable> qui identifie le message d'erreur. + <note> + <para> + Le support des connexions a été ajouté dans PHP 3.0.4. + </para> + </note> + </para> + <para> + Avec les versions UNIX d'Oracle, vous pouvez avoir des messages + d'erreur tels que : + <computeroutput><prompt>$</prompt> <userinput>oerr ora <replaceable>00001</replaceable></userinput> + 00001, 00000, "unique constraint (%s.%s) violated" // *Cause: An update or insert +statement attempted to insert a duplicate key // For Trusted +ORACLE configured in DBMS MAC mode, you may see // this message +if a duplicate entry exists at a different level. // *Action: Either +remove the unique restriction or do not insert the key </computeroutput>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-errorcode"> + <refnamediv> + <refname>Ora_ErrorCode</refname> + <refpurpose>Retourne le code d'erreur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ora_error</function></funcdef> + <paramdef>int <parameter>cursor_or_connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_errorcode</function> retourne le code d'erreur + numérique de la dernière commande exécuté + sur la connexion ou le pointeur fourni en paramètre. + <note> + <para> + Les identifiants de connexion ne sont acceptés qu'à + partir de la version 3.0.4. + </para> + </note> + </para> + </refsect1> + </refentry> + <refentry id="function.ora-exec"> + <refnamediv> + <refname>Ora_Exec</refname> + <refpurpose> + Exécute une commande analysée sur un pointeur Oracle. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_exec</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_exec</function> retourne TRUE en cas de succès, et + FALSE en cas d'erreur. L'erreur générée sera alors + accessible avec les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-fetch"> + <refnamediv> + <refname>Ora_Fetch</refname> + <refpurpose>Retourne une ligne de résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_fetch</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_fetch</function> retourne TRUE (une ligne a + été lue) ou FALSE (plus de lignes à lire ou + erreur). Si une erreur survient, sa valeur sera disponible dans + les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + <para> + Lit une ligne de données sur le pointeur cursor. + </para> + <simpara> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-fetch-into"> + <refnamediv> + <refname>Ora_Fetch_Into</refname> + <refpurpose>Lit une ligne dans un tableau</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_fetch_into</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>array <parameter>result</parameter></paramdef> + <paramdef>int + <parameter> + <optional>flags</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_fetch_into</function> lit la ligne courante du + résultat <parameter>cursor</parameter> dans le tableau + <parameter>result</parameter>. + <example> + <title>Exemple <function>ora_fetch_into</function></title> + <programlisting role="php"> +<?php +array($results); +ora_fetch_into($cursor, &$results); +echo $results[0]; +echo $results[1]; +?> + </programlisting> + </example> + Notez que vous devez passer le tableau par référence; + </para> + <simpara> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + <function>ora_fetch</function>, et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-getcolumn"> + <refnamediv> + <refname>Ora_GetColumn</refname> + <refpurpose>Retourne une donnée d'une ligne lue.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>ora_getcolumn</function></funcdef> + <paramdef>int <parameter>cursor</parameter></paramdef> + <paramdef>mixed <parameter>column</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_getcolumn</function> retourne la valeur de la + colonne. Si une erreur survient, FALSE est retourné et + <function>ora_errorcode</function> aura une valeur non nulle. + Notez, qu'un test à FALSE, avec cette fonction peut + être TRUE, même sans erreur : en effet, la fonction + peut retourner des valeurs telles que (résultat NULL, + chaînes vides, nombre 0, la chaîne "0"). + </para> + </refsect1> + </refentry> + <refentry id="function.ora-logoff"> + <refnamediv> + <refname>Ora_Logoff</refname> + <refpurpose>Ferme une connexion Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_logoff</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_logoff</function> retourne TRUE si la fermeture a + bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec + les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + <para> + Déconnecte l'utilisateur, et se déconnecte. + </para> + <simpara> + Voir aussi <function>ora_logon</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-logon"> + <refnamediv> + <refname>Ora_Logon</refname> + <refpurpose>Ouvre une connexion Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>int <function>ora_logon</function></funcdef> + <paramdef>string <parameter>user</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + </funcsynopsis> + <para> + <function>ora_logon</function> établit une connexion entre + PHP et un serveur Oracle avec les noms d'utilisateur user et le + mot de passe password. + </para> + <para> + Les connexions peut être faîtes avec + <productname>SQL*Net</productname> en fournissant le nom + <acronym>TNS</acronym> de la manière suivante : + <informalexample> + <programlisting role="php"> +$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass"); +</programlisting> + </informalexample> + </para> + <para> + Si vous avez des données qui ne sont pas ASCII, vous + devriez vérifier que la variable <envar>NLS_LANG</envar> + a été correctement configuré dans votre + environnement. Pour les modules de serveur, vous devrez la + configurer dans l'environnement d'exécution du serveur + avant de le lancer. + </para> + <para> + Retourne un index de connexion, en cas de succès, ou + FALSE en cas d'échec. Les erreurs sont accessibles avec + les fonctions <function>ora_error</function> + et <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-plogon"> + <refnamediv> + <refname>Ora_pLogon</refname> + <refpurpose> + Ouvre une connexion persistante à Oracle + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_plogon</function></funcdef> + <paramdef>string <parameter>user</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_plogon</function> établit une connexion persistante + à un serveur Oracle, avec l'utilisateur <parameter>user</parameter> et + le mot de passe <parameter>password</parameter>. + </para> + <simpara> + Voir aussi <function>ora_logon</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-numcols"> + <refnamediv> + <refname>Ora_Numcols</refname> + <refpurpose>Retourne le nombre de colonnes</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_numcols</function></funcdef> + <paramdef>int <parameter>cursor_ind</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_numcols</function> retourne le nombre de colonne dans le + résultat <parameter>cursor_ind</parameter>. Cette valeur n'est significative + qu'après une requête parse/exec/fetch. + </para> + <simpara> + Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, + <function>ora_fetch</function>, et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-numrows"> + <refnamediv> + <refname>Ora_Numrows</refname> + <refpurpose>Retourne le nombre de colonnes</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_numrows</function></funcdef> + <paramdef>int <parameter>cursor_ind</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_numrows</function> retourne le nombre de colonnes + dans le résultat <parameter>cursor_ind</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-open"> + <refnamediv> + <refname>Ora_Open</refname> + <refpurpose>Ouvre un pointeur Oracle.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_open</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_open</function> ouvre un pointeur Oracle sur la connexion. + </para> + <para> + Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. + Les erreurs sont accessibles avec les fonctions + <function>ora_error</function> et <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ora-parse"> + <refnamediv> + <refname>Ora_Parse</refname> + <refpurpose>Analyse une requête SQL.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_parse</function></funcdef> + <paramdef>int <parameter>cursor_ind</parameter></paramdef> + <paramdef>string <parameter>sql_statement</parameter></paramdef> + <paramdef>int <parameter>defer</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_parse</function> analyse une requête SQL ou + un bloc PL/SQL et l'associe avec le pointeur cursor_ind. Retourne + 0 en cas de succès, et -1 en cas d'erreur. + </para> + <para> + Retourne 0 en cas de succès, et -1 en cas d'erreur. + </para> + <simpara> + Voir aussi <function>ora_exec</function>, + <function>ora_fetch</function>, et <function>ora_do</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ora-rollback"> + <refnamediv> + <refname>Ora_Rollback</refname> + <refpurpose>Annule une transaction.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ora_rollback</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ora_rollback</function> annule une transaction Oracle. (Voir + <function>ora_commit</function> pour la définition d'une transaction). + </para> + <para> + Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont + accessibles avec les fonctions <function>ora_error</function> et + <function>ora_errorcode</function>. + </para> + </refsect1> + </refentry> + </reference> +<!-- 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 +sgml-parent-document:nil +sgml-default-dtd-file:"../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->