cvs: phpdoc /fr/functions oci8.xml ovrimos.xml
| From: | Derick Rethans | Date: | Wed, 14 Nov 2001 17:43:39 +0000 |
| Subject: | cvs: phpdoc /fr/functions oci8.xml ovrimos.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338839@lists.php.net to get a copy of this message | ||
derick Wed Nov 14 12:43:39 2001 EDT
Modified files:
/phpdoc/fr/functions oci8.xml ovrimos.xml
Log:
- Fixing parsing errors
Index: phpdoc/fr/functions/oci8.xml diff -u phpdoc/fr/functions/oci8.xml:1.15 phpdoc/fr/functions/oci8.xml:1.16 --- phpdoc/fr/functions/oci8.xml:1.15 Mon Nov 12 18:37:22 2001 +++ phpdoc/fr/functions/oci8.xml Wed Nov 14 12:43:38 2001 @@ -1,5 +1,5 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <reference id="ref.oci8"> <title>Oracle 8</title> <titleabbrev>oci8</titleabbrev> @@ -708,9 +708,9 @@ <title>Exemple avec <function>ocinewdescriptor</function></title> <programlisting> <?php - /* Appel d'une procdure PL/SQL stocke qui prend un clobs en entre - * (PHP 4 >= 4.0.6). - * Exemple de signateure de procdure stocke PL/SQL : + /* Appel d'une procédure PL/SQL stockée qui prend un clobs + * en entrée (PHP 4 >= 4.0.6). + * Exemple de signateure de procédure stockée PL/SQL : * * PROCEDURE save_data * Nom de l'argument Type In/Out Default? Index: phpdoc/fr/functions/ovrimos.xml diff -u phpdoc/fr/functions/ovrimos.xml:1.6 phpdoc/fr/functions/ovrimos.xml:1.7 --- phpdoc/fr/functions/ovrimos.xml:1.6 Mon Nov 12 18:37:22 2001 +++ phpdoc/fr/functions/ovrimos.xml Wed Nov 14 12:43:38 2001 @@ -1 +1,806 @@ -<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.6 $ --><reference id="ref.ovrimos"> <title>Ovrimos SQL</title> <titleabbrev>OvrimosSQL</titleabbrev> <partintro> <para> Ovrimos SQL Server est une base de données relationnelle client/serveur et transactionnelle, combinée avec des fonctionnalités web, et des transactions rapides. </para> <para> Ovrimos SQL Server est disponible à <ulink url="&url.ovrimos;">www.ovrimos.com</ulink>. Pour activer le support ovrimos de PHP, il suffit de compiler PHP avec l'option <link linkend="install.configure.with-ovrimos"><option role="configure">--with-ovrimos</option></link> du script de configuration. Vous devrez aussi installer la librairie sqlcli disponible avec la distribution Ovrimos SQL Server. </para> <para> <example> <title> Connection au serveur Ovrimos SQL Server et sélection d'une table système </title> <programlisting role="php"><?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");if ($conn != 0) { echo ("Connection établie!"); $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple effectue une connexion réussie. </para> </partintro> <refentry id="function.ovrimos-connect"> <refnamediv> <refname>ovrimos_connect</refname> <refpurpose>Connexion à un serveur</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_connect</function></funcdef> <paramdef>string <parameter>host</parameter></paramdef> <paramdef>string <parameter>db</parameter></paramdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_connect</function> sert à se connecter à un serveur Ovrimos. </para> <para> <function>ovrimos_connect</function> retourne un identifiant de connexion, supérieur à 0, ou 0 en cas d'échec.<parameter>host</parameter> est l'adresse IP de l'hôte Ovrimos, et <parameter>db</parameter> est soit le nom d'une base de données, soit une chaîne contenant le numéro de port. </para> <para> <example> <title>Exemple avec <function>ovrimos_connect</function></title> <programlisting role="php"><?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> L'exemple ci-dessus montre comment se connecter à une base de données et afficher le contenu d'une table. </para> </refsect1> </refentry> <refentry id="function.ovrimos-close"> <refnamediv> <refname>ovrimos_close</refname> <refpurpose>Ferme une connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>ovrimos_close</function></funcdef> <paramdef>int <parameter>connection</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_close</function> sert à ferme une connexion à un serveur Ovrimos. </para> <para> <function>ovrimos_close</function> ferme la connexion au serveur Ovrimos. Toutes les transactions non validées sont annulées. </para> </refsect1> </refentry><!-- <refentry id="function.ovrimos-close-all"> <refnamediv> <refname>ovrimos_close_all</refname> <refpurpose>Ferme toutes les connexions aux serveurs ovrimos</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>ovrimos_close_all</function></funcdef> <paramdef>void</paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_close_all</function> sert à ferme toutes les connexions. </para> <para> <function>ovrimos_close_all</function> ferme toute les connexions à Ovrimos. Toutes les transactions non validées sont annulées. </para> </refsect1> </refentry>--> <refentry id="function.ovrimos-longreadlen"> <refnamediv> <refname>ovrimos_longreadlen</refname> <refpurpose> Indique la taille des données à lire dans une colonne de grande taille </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_longreadlen</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_longreadlen</function> sert à lire la taille des données qui sera lues lors de l'accès une colonne de grande taille. </para> <para> <function>ovrimos_longreadlen</function> indique le nombre d'octets qui seront lus dans une colonne de grande taille (long varchar et long varbinary). Par défaut, 0. Indépendemment du fait que <function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>, actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre pour tous les résultats. </para> </refsect1> </refentry> <refentry id="function.ovrimos-prepare"> <refnamediv> <refname>ovrimos_prepare</refname> <refpurpose>Prépare une requête SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_prepare</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_prepare</function> sert à préparer une requête SQL. </para> <para> <function>ovrimos_prepare</function> prépare une requête SQL et retourne un identifiant de résultat result_id (ou &false; en cas d'échec). </para> <para> <example> <title> Connexion à un serveur Ovrimos SQL Server et préparation d'une requête </title> <programlisting role="php"><?php$conn=ovrimos_connect("db_host", "8001", "admin", "password");if ($conn!=0) { echo "Connection établie!"; $res=ovrimos_prepare($conn, "select table_id, table_name from sys.tables where table_id=1"); if ($res != 0) { echo "Préparation faite!"; if (ovrimos_execute($res)) { echo "Exécution réussie!\n"; ovrimos_result_all($res); } else { echo "Exécution manquée!"; } ovrimos_free_result($res); } else { echo "Préparation manquée!\n"; } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server, comment préparer une requête SQL et l'exécuter. </para> </refsect1> </refentry> <refentry id="function.ovrimos-execute"> <refnamediv> <refname>ovrimos_execute</refname> <refpurpose>Exécute une requête préparée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_execute</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>array <parameter><optional>parameters_array</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_execute</function> sert à exécuter une requête SQL. </para> <para> <function>ovrimos_execute</function> exécute une requête préparée. <function>ovrimos_execute</function> retourne &true; ou &false;. Si la requête préparée contient des paramètres (des points d'interrogations dans la requête), un nombre correct de paramètre doit être passé dans le tableau <parameter>parameters_array</parameter>. Notez que <function>ovrimos_execute</function> ne suit pas les conventions PHP qui placent les noms des paramètres entre crochets. L'auteur n'a pas pu s'y faire. </para> </refsect1> </refentry> <refentry id="function.ovrimos-cursor"> <refnamediv> <refname>ovrimos_cursor</refname> <refpurpose>Retourne le nom du curseur</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_cursor</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_cursor</function> sert à lire le nom du curseur </para> <para> <function>ovrimos_cursor</function> retourne le nom du curseur. Pratique, lorsqu'on veut faire des modifications ou des effacements avec des curseurs déjà positionnés. </para> </refsect1> </refentry> <refentry id="function.ovrimos-exec"> <refnamediv> <refname>ovrimos_exec</refname> <refpurpose>Exécute une requête SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_exec</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_exec</function> sert à exécuter une requête SQL. </para> <para> <function>ovrimos_exec</function> exécute une requête SQL (selection ou modification), et retourne un identifiant de résultat result_id (ou bien &false;, en cas d'échec). Evidemment, la requête SQL ne doit pas contenir de paramètres. </para> </refsect1> </refentry> <refentry id="function.ovrimos-fetch-into"> <refnamediv> <refname>ovrimos_fetch_into</refname> <refpurpose>Lit une ligne dans un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_fetch_into</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>array <parameter>result_array</parameter></paramdef> <paramdef>string <parameter><optional>how</optional></parameter> </paramdef> <paramdef>int <parameter><optional>rownumber</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_fetch_into</function> lit une ligne dans un résultat SQL. </para> <para> <function>ovrimos_fetch_into</function> lit une ligne dans le résultat <parameter>result_id</parameter>, qui doit être passé en référence. La ligne qui sera lue est déterminée par les deux paramètres <parameter><optional>how</optional></parameter> et <parameter><optional>rownumber</optional></parameter>. <parameter><optional>how</optional></parameter> peut prendre les valeurs de 'Next' (suivant, valeur par défaut), 'Prev' (précédent), 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La casse de <parameter><optional>how</optional></parameter> n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter> est optionnel, sauf dans le cas d''Absolute'. <function>ovrimos_fetch_into</function> retourne &true; ou &false;. </para> <para> <example> <title>Lit un exemple</title> <programlisting role="php"><?php$conn=ovrimos_connect("neptune", "8001", "admin", "password");if ($conn!=0) { echo "Connection établie!"; $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables"); if ($res != 0) { echo "Requête effectuée!"; if (ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; if (ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { echo "Next: erreur\n"; } } else { echo "First: erreur\n"; } ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple lis une ligne. </para> </refsect1> </refentry> <refentry id="function.ovrimos-fetch-row"> <refnamediv> <refname>ovrimos_fetch_row</refname> <refpurpose>Lit une ligne dans un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_fetch_row</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter><optional>how</optional></parameter> </paramdef> <paramdef>int <parameter><optional>row_number</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un résultat SQL. </para> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un résultat. Les colonnes doivent être lues par un autre appel. Retourne &true; en cas de succs et &false; sinon. </para> <para> <example> <title>Exemple de lecture de ligne</title> <programlisting role="php"><?php$conn = ovrimos_connect("remote.host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; if (ovrimos_fetch_row($res, "First")) { $table_id = ovrimos_result($res, 1); $table_name = ovrimos_result($res, 2); echo "table_id=".$table_id.", table_name=".$table_name."\n"; if (ovrimos_fetch_row($res, "Next")) { $table_id = ovrimos_result($res, "table_id"); $table_name = ovrimos_result($res, "table_name"); echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { echo "Next: erreur\n"; } } else { echo "First: erreur\n"; } ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple lit une ligne et l'affiche. </para> </refsect1> </refentry> <refentry id="function.ovrimos-result"> <refnamediv> <refname>ovrimos_result</refname> <refpurpose>Lit le contenu d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_result</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>mixed <parameter>field</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_result</function> sert à lire le contenu de l;a colonne <parameter>field</parameter> dans le rsultat <parameter>result_id</parameter>. </para> <para> <function>ovrimos_result</function> lit le contenu de la colonne <parameter>field</parameter> dans le résultat <parameter>result_id</parameter>. <parameter>field</parameter> peut être le nom de la colonne (une chaîne) ou bien le numéro de la colonne (la première colonne est alors 1). </para> </refsect1> </refentry> <refentry id="function.ovrimos-result-all"> <refnamediv> <refname>ovrimos_result_all</refname> <refpurpose> Affiche un résultat sous forme de table HTML </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_result_all</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>string <parameter><optional>format</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_result_all</function> sert à afficher tout le résultat d'une requête. </para> <para> <function>ovrimos_result_all</function> affiche le résultat de la requête représentée par <parameter>result_id</parameter>. <function>ovrimos_result_all</function> retourne &true; ou &false;. </para> <para> <example> <title>Prépare une requête, l'éxécute, et affiche le résultat</title> <programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_prepare($conn, "select table_id, table_name from sys.tables where table_id = 7"); if ($res != 0) { echo "Préparation faite!"; if (ovrimos_execute($res, array(3))) { echo "Exécution réussie!\n"; ovrimos_result_all($res); } else { echo "Exécution manquée!"; } ovrimos_free_result($res); } else { echo "Préparation manquée!\n"; } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple exécute une requête SQL et affiche le résultat sous forme d'une table HTML. </para> <para> <example> <title><function>ovrimos_result_all</function> avec meta-information</title> <programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables where table_id = 1") if ($res != 0) { echo "Requête effectuée! cursor=".ovrimos_cursor($res)."\n"; $colnb = ovrimos_num_fields($res); echo "Output columns=".$colnb."\n"; for ($i=1; $i<=$colnb; $i++) { $name = ovrimos_field_name($res, $i); $type = ovrimos_field_type($res, $i); $len = ovrimos_field_len($res, $i); echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; } ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> </para> <para> <example> <title>Exemple avec <function>ovrimos_result_all</function></title> <programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_exec($conn, "update test set i=5"); if ($res != 0) { echo "Requête effectuée!"; echo ovrimos_num_rows($res)." lignes affectées\n"; ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.ovrimos-num-rows"> <refnamediv> <refname>ovrimos_num_rows</refname> <refpurpose> Retourne le nombre de lignes affectées par une modification </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_num_rows</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_num_rows</function> retourne le nombre de lignes affectées par une modification </para> </refsect1> </refentry> <refentry id="function.ovrimos-num-fields"> <refnamediv> <refname>ovrimos_num_fields</refname> <refpurpose>Retourne le nombre de colonnes</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_num_fields</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_num_fields</function> indique le nombre de colonnes du résultat <parameter>result_id</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-name"> <refnamediv> <refname>ovrimos_field_name</refname> <refpurpose>Retourne le nom d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_name</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>field_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_name</function> sert à obtenir le nom d'une colonne. </para> <para> <function>ovrimos_field_name</function> retourne le nom d'une colonne à partir de son numéro de colonne <parameter>field_number</parameter>, (la première colonne est à 1). </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-type"> <refnamediv> <refname>ovrimos_field_type</refname> <refpurpose> Retourne le type numérique d'une colonne </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_type</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>field_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_type</function> sert à connaître le type numérique d'une colonne. </para> <para> <function>ovrimos_field_type</function> retourne le type numérique d'une colonne, identifiée par son numéro <parameter>field_number</parameter> dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-len"> <refnamediv> <refname>ovrimos_field_len</refname> <refpurpose>Retourne la taille d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_len</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>field_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_len</function> sert à connaître la taille d'une colonne. </para> <para> <function>ovrimos_field_len</function> retourne la taille de la colonne <parameter>field_number</parameter>, dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-num"> <refnamediv> <refname>ovrimos_field_num</refname> <refpurpose>Retourne le numéro de colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_num</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>string <parameter>field_name</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_num</function> sert à connaître le nuémro de colonne, à partir de son nom. </para> <para> <function>ovrimos_field_num</function> retourne le numéro de la colonne <parameter>field_name</parameter> (la numérotation commence à 1), dans <parameter>result_id</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-free-result"> <refnamediv> <refname>ovrimos_free_result</refname> <refpurpose>Libère les ressources utilisées par un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_free_result</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_free_result</function> sert à effacer un résultat. </para> <para> <function>ovrimos_free_result</function> libère toutes les ressources prises par le résultat <parameter>result_id</parameter>. <function>ovrimos_free_result</function> retourne &true;. </para> </refsect1> </refentry> <refentry id="function.ovrimos-commit"> <refnamediv> <refname>ovrimos_commit</refname> <refpurpose>Valide une transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_commit</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_commit</function> sert à exécuter une transaction. </para> <para> <function>ovrimos_commit</function> exécute la transaction préparée sur la connexion <parameter>connection_id</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-rollback"> <refnamediv> <refname>ovrimos_rollback</refname> <refpurpose>Annule une transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_rollback</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_rollback</function> sert à annuler une transaction. </para> <para> <function>ovrimos_rollback</function> annule la transaction préparée sur la connexion <parameter>connection_id</parameter>. </para> </refsect1> </refentry> </reference><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tsgml-parent-document:nilsgml-default-dtd-file:"../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:--> \ No newline at end of file +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.7 $ --> +<reference id="ref.ovrimos"> + <title>Ovrimos SQL</title> + <titleabbrev>OvrimosSQL</titleabbrev> + <partintro> + <para> + Ovrimos SQL Server est une base de données relationnelle client/serveur + et transactionnelle, combinée avec des fonctionnalités web, et des + transactions rapides. + </para> + <para> + Ovrimos SQL Server est disponible à <ulink + url="&url.ovrimos;">www.ovrimos.com</ulink>. Pour activer le support + ovrimos de PHP, il suffit de compiler PHP avec l'option + <link linkend="install.configure.with-ovrimos"><option role="configure">--with-ovrimos</option></link> + du script de configuration. Vous devrez aussi installer la librairie sqlcli + disponible avec la distribution Ovrimos SQL Server. + </para> + <para> + <example> + <title> + Connection au serveur Ovrimos SQL Server et sélection d'une table système + </title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password"); +if ($conn != 0) { + echo ("Connection établie!"); + $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + ovrimos_result_all($res); + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple effectue une connexion réussie. + </para> + </partintro> + <refentry id="function.ovrimos-connect"> + <refnamediv> + <refname>ovrimos_connect</refname> + <refpurpose>Connexion à un serveur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>db</parameter></paramdef> + <paramdef>string <parameter>user</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_connect</function> sert à se connecter à un serveur + Ovrimos. + </para> + <para> + <function>ovrimos_connect</function> retourne un identifiant de connexion, + supérieur à 0, ou 0 en cas d'échec.<parameter>host</parameter> + est l'adresse IP de l'hôte Ovrimos, et <parameter>db</parameter> est soit + le nom d'une base de données, soit une chaîne contenant + le numéro de port. + </para> + <para> + <example> + <title>Exemple avec <function>ovrimos_connect</function></title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + ovrimos_result_all($res); + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + L'exemple ci-dessus montre comment se connecter à une base de données + et afficher le contenu d'une table. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-close"> + <refnamediv> + <refname>ovrimos_close</refname> + <refpurpose>Ferme une connexion</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>ovrimos_close</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_close</function> sert à ferme une connexion + à un serveur Ovrimos. + </para> + <para> + <function>ovrimos_close</function> ferme la connexion au serveur + Ovrimos. Toutes les transactions non validées sont annulées. + </para> + </refsect1> + </refentry> +<!-- + <refentry id="function.ovrimos-close-all"> + <refnamediv> + <refname>ovrimos_close_all</refname> + <refpurpose>Ferme toutes les connexions aux serveurs ovrimos</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>ovrimos_close_all</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_close_all</function> sert à ferme toutes les connexions. + </para> + <para> + <function>ovrimos_close_all</function> ferme toute les connexions à + Ovrimos. Toutes les transactions non validées sont annulées. + </para> + </refsect1> + </refentry> +--> + <refentry id="function.ovrimos-longreadlen"> + <refnamediv> + <refname>ovrimos_longreadlen</refname> + <refpurpose> + Indique la taille des données à lire dans une colonne de grande taille + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_longreadlen</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_longreadlen</function> sert à lire la taille des + données qui sera lues lors de l'accès une colonne de grande taille. + </para> + <para> + <function>ovrimos_longreadlen</function> indique le nombre d'octets + qui seront lus dans une colonne de grande taille (long varchar et long + varbinary). Par défaut, 0. Indépendemment du fait que + <function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>, + actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre + pour tous les résultats. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-prepare"> + <refnamediv> + <refname>ovrimos_prepare</refname> + <refpurpose>Prépare une requête SQL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_prepare</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_prepare</function> sert à préparer une requête SQL. + </para> + <para> + <function>ovrimos_prepare</function> prépare une requête SQL + et retourne un identifiant de résultat result_id (ou &false; en cas d'échec). + </para> + <para> + <example> + <title> + Connexion à un serveur Ovrimos SQL Server et préparation + d'une requête + </title> + <programlisting role="php"> +<?php +$conn=ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn!=0) { + echo "Connection établie!"; + $res=ovrimos_prepare($conn, "select table_id, table_name + from sys.tables where table_id=1"); + if ($res != 0) { + echo "Préparation faite!"; + if (ovrimos_execute($res)) { + echo "Exécution réussie!\n"; + ovrimos_result_all($res); + } else { + echo "Exécution manquée!"; + } + ovrimos_free_result($res); + } else { + echo "Préparation manquée!\n"; + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server, + comment préparer une requête SQL et l'exécuter. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-execute"> + <refnamediv> + <refname>ovrimos_execute</refname> + <refpurpose>Exécute une requête préparée</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_execute</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array + <parameter><optional>parameters_array</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_execute</function> sert à exécuter une requête SQL. + </para> + <para> + <function>ovrimos_execute</function> exécute une requête + préparée. <function>ovrimos_execute</function> + retourne &true; ou &false;. Si la requête préparée + contient des paramètres (des points d'interrogations dans la + requête), un nombre correct de paramètre doit être + passé dans le tableau <parameter>parameters_array</parameter>. Notez + que <function>ovrimos_execute</function> ne + suit pas les conventions PHP qui placent les noms des paramètres + entre crochets. L'auteur n'a pas pu s'y faire. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-cursor"> + <refnamediv> + <refname>ovrimos_cursor</refname> + <refpurpose>Retourne le nom du curseur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_cursor</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_cursor</function> sert à lire le nom du curseur + </para> + <para> + <function>ovrimos_cursor</function> retourne le nom du curseur. + Pratique, lorsqu'on veut faire des modifications ou des effacements + avec des curseurs déjà positionnés. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-exec"> + <refnamediv> + <refname>ovrimos_exec</refname> + <refpurpose>Exécute une requête SQL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_exec</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_exec</function> sert à exécuter une + requête SQL. + </para> + <para> + <function>ovrimos_exec</function> exécute une requête SQL + (selection ou modification), et retourne un identifiant de résultat + result_id (ou bien &false;, en cas d'échec). Evidemment, la + requête SQL ne doit pas contenir de paramètres. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-fetch-into"> + <refnamediv> + <refname>ovrimos_fetch_into</refname> + <refpurpose>Lit une ligne dans un résultat</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_fetch_into</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array <parameter>result_array</parameter></paramdef> + <paramdef>string + <parameter><optional>how</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>rownumber</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_fetch_into</function> lit une ligne dans un résultat SQL. + </para> + <para> + <function>ovrimos_fetch_into</function> lit une ligne dans le + résultat <parameter>result_id</parameter>, qui doit être passé + en référence. La ligne qui sera lue est déterminée par les deux + paramètres <parameter><optional>how</optional></parameter> et + <parameter><optional>rownumber</optional></parameter>. + <parameter><optional>how</optional></parameter> peut prendre les valeurs de + 'Next' (suivant, valeur par défaut), 'Prev' (précédent), + 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La + casse de <parameter><optional>how</optional></parameter> + n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter> + est optionnel, sauf dans le cas d''Absolute'. + <function>ovrimos_fetch_into</function> retourne &true; ou &false;. + </para> + <para> + <example> + <title>Lit un exemple</title> + <programlisting role="php"> +<?php +$conn=ovrimos_connect("neptune", "8001", "admin", "password"); +if ($conn!=0) { + echo "Connection établie!"; + $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + if (ovrimos_fetch_into($res, &$row)) { + list ($table_id, $table_name) = $row; + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + if (ovrimos_fetch_into($res, &$row)) { + list ($table_id, $table_name) = $row; + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + } else { + echo "Next: erreur\n"; + } + } else { + echo "First: erreur\n"; + } + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple lis une ligne. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-fetch-row"> + <refnamediv> + <refname>ovrimos_fetch_row</refname> + <refpurpose>Lit une ligne dans un résultat</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_fetch_row</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int + <parameter><optional>how</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>row_number</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_fetch_row</function> lit une ligne dans un résultat SQL. + </para> + <para> + <function>ovrimos_fetch_row</function> lit une ligne dans un résultat. + Les colonnes doivent être lues par un autre appel. Retourne &true; en + cas de succès et &false; sinon. + </para> + <para> + <example> + <title>Exemple de lecture de ligne</title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("remote.host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + if (ovrimos_fetch_row($res, "First")) { + $table_id = ovrimos_result($res, 1); + $table_name = ovrimos_result($res, 2); + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + if (ovrimos_fetch_row($res, "Next")) { + $table_id = ovrimos_result($res, "table_id"); + $table_name = ovrimos_result($res, "table_name"); + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + } else { + echo "Next: erreur\n"; + } + } else { + echo "First: erreur\n"; + } + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple lit une ligne et l'affiche. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-result"> + <refnamediv> + <refname>ovrimos_result</refname> + <refpurpose>Lit le contenu d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_result</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>mixed <parameter>field</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_result</function> sert à lire le contenu de l;a + colonne <parameter>field</parameter> dans le résultat + <parameter>result_id</parameter>. + </para> + <para> + <function>ovrimos_result</function> lit le contenu de la colonne + <parameter>field</parameter> dans le résultat + <parameter>result_id</parameter>. <parameter>field</parameter> peut + être le nom de la colonne (une chaîne) ou bien le numéro + de la colonne (la première colonne est alors 1). + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-result-all"> + <refnamediv> + <refname>ovrimos_result_all</refname> + <refpurpose> + Affiche un résultat sous forme de table HTML + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_result_all</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>string + <parameter><optional>format</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_result_all</function> sert à afficher tout le résultat + d'une requête. + </para> + <para> + <function>ovrimos_result_all</function> affiche le résultat de la requête + représentée par <parameter>result_id</parameter>. + <function>ovrimos_result_all</function> retourne &true; ou &false;. + </para> + <para> + <example> + <title>Prépare une requête, l'éxécute, et affiche le résultat</title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res = ovrimos_prepare($conn, "select table_id, table_name + from sys.tables where table_id = 7"); + if ($res != 0) { + echo "Préparation faite!"; + if (ovrimos_execute($res, array(3))) { + echo "Exécution réussie!\n"; + ovrimos_result_all($res); + } else { + echo "Exécution manquée!"; + } + ovrimos_free_result($res); + } else { + echo "Préparation manquée!\n"; + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple exécute une requête SQL et affiche le résultat sous forme + d'une table HTML. + </para> + <para> + <example> + <title><function>ovrimos_result_all</function> avec meta-information</title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res = ovrimos_exec($conn, "select table_id, table_name + from sys.tables where table_id = 1") + if ($res != 0) { + echo "Requête effectuée! cursor=".ovrimos_cursor($res)."\n"; + $colnb = ovrimos_num_fields($res); + echo "Output columns=".$colnb."\n"; + for ($i=1; $i<=$colnb; $i++) { + $name = ovrimos_field_name($res, $i); + $type = ovrimos_field_type($res, $i); + $len = ovrimos_field_len($res, $i); + echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; + } + ovrimos_result_all($res); + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + </para> + <para> + <example> + <title>Exemple avec <function>ovrimos_result_all</function></title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res = ovrimos_exec($conn, "update test set i=5"); + if ($res != 0) { + echo "Requête effectuée!"; + echo ovrimos_num_rows($res)." lignes affectées\n"; + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-num-rows"> + <refnamediv> + <refname>ovrimos_num_rows</refname> + <refpurpose> + Retourne le nombre de lignes affectées par une modification + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_num_rows</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_num_rows</function> retourne le nombre de lignes + affectées par une modification + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-num-fields"> + <refnamediv> + <refname>ovrimos_num_fields</refname> + <refpurpose>Retourne le nombre de colonnes</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_num_fields</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_num_fields</function> indique le nombre de colonnes + du résultat <parameter>result_id</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-name"> + <refnamediv> + <refname>ovrimos_field_name</refname> + <refpurpose>Retourne le nom d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_name</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_name</function> sert à obtenir le nom d'une + colonne. + </para> + <para> + <function>ovrimos_field_name</function> retourne le nom d'une colonne + à partir de son numéro de colonne <parameter>field_number</parameter>, + (la première colonne est à 1). + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-type"> + <refnamediv> + <refname>ovrimos_field_type</refname> + <refpurpose> + Retourne le type numérique d'une colonne + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_type</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_type</function> sert à connaître le type + numérique d'une colonne. + </para> + <para> + <function>ovrimos_field_type</function> retourne le type numérique + d'une colonne, identifiée par son numéro <parameter>field_number</parameter> + dans le résultat <parameter>field_number</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-len"> + <refnamediv> + <refname>ovrimos_field_len</refname> + <refpurpose>Retourne la taille d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_len</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_len</function> sert à connaître la taille + d'une colonne. + </para> + <para> + <function>ovrimos_field_len</function> retourne la taille de la + colonne <parameter>field_number</parameter>, dans le résultat + <parameter>field_number</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-num"> + <refnamediv> + <refname>ovrimos_field_num</refname> + <refpurpose>Retourne le numéro de colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_num</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>string <parameter>field_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_num</function> sert à connaître le nuémro de + colonne, à partir de son nom. + </para> + <para> + <function>ovrimos_field_num</function> retourne le numéro de la colonne + <parameter>field_name</parameter> (la numérotation commence à 1), dans + <parameter>result_id</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-free-result"> + <refnamediv> + <refname>ovrimos_free_result</refname> + <refpurpose>Libère les ressources utilisées par un résultat</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_free_result</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_free_result</function> sert à effacer un résultat. + </para> + <para> + <function>ovrimos_free_result</function> libère toutes les + ressources prises par le résultat <parameter>result_id</parameter>. + <function>ovrimos_free_result</function> retourne &true;. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-commit"> + <refnamediv> + <refname>ovrimos_commit</refname> + <refpurpose>Valide une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_commit</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_commit</function> sert à exécuter une + transaction. + </para> + <para> + <function>ovrimos_commit</function> exécute la transaction préparée + sur la connexion <parameter>connection_id</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-rollback"> + <refnamediv> + <refname>ovrimos_rollback</refname> + <refpurpose>Annule une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_rollback</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_rollback</function> sert à annuler une transaction. + </para> + <para> + <function>ovrimos_rollback</function> annule la transaction préparée sur + la connexion <parameter>connection_id</parameter>. + </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/oci8.xml diff -u phpdoc/fr/functions/oci8.xml:1.15 phpdoc/fr/functions/oci8.xml:1.16 --- phpdoc/fr/functions/oci8.xml:1.15 Mon Nov 12 18:37:22 2001 +++ phpdoc/fr/functions/oci8.xml Wed Nov 14 12:43:38 2001 @@ -1,5 +1,5 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <reference id="ref.oci8"> <title>Oracle 8</title> <titleabbrev>oci8</titleabbrev> @@ -708,9 +708,9 @@ <title>Exemple avec <function>ocinewdescriptor</function></title> <programlisting> <?php - /* Appel d'une procdure PL/SQL stocke qui prend un clobs en entre - * (PHP 4 >= 4.0.6). - * Exemple de signateure de procdure stocke PL/SQL : + /* Appel d'une procédure PL/SQL stockée qui prend un clobs + * en entrée (PHP 4 >= 4.0.6). + * Exemple de signateure de procédure stockée PL/SQL : * * PROCEDURE save_data * Nom de l'argument Type In/Out Default? Index: phpdoc/fr/functions/ovrimos.xml diff -u phpdoc/fr/functions/ovrimos.xml:1.6 phpdoc/fr/functions/ovrimos.xml:1.7 --- phpdoc/fr/functions/ovrimos.xml:1.6 Mon Nov 12 18:37:22 2001 +++ phpdoc/fr/functions/ovrimos.xml Wed Nov 14 12:43:38 2001 @@ -1 +1,806 @@ -<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.6 $ --><reference id="ref.ovrimos"> <title>Ovrimos SQL</title> <titleabbrev>OvrimosSQL</titleabbrev> <partintro> <para> Ovrimos SQL Server est une base de données relationnelle client/serveur et transactionnelle, combinée avec des fonctionnalités web, et des transactions rapides. </para> <para> Ovrimos SQL Server est disponible à <ulink url="&url.ovrimos;">www.ovrimos.com</ulink>. Pour activer le support ovrimos de PHP, il suffit de compiler PHP avec l'option <link linkend="install.configure.with-ovrimos"><option role="configure">--with-ovrimos</option></link> du script de configuration. Vous devrez aussi installer la librairie sqlcli disponible avec la distribution Ovrimos SQL Server. </para> <para> <example> <title> Connection au serveur Ovrimos SQL Server et sélection d'une table système </title> <programlisting role="php"><?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");if ($conn != 0) { echo ("Connection établie!"); $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple effectue une connexion réussie. </para> </partintro> <refentry id="function.ovrimos-connect"> <refnamediv> <refname>ovrimos_connect</refname> <refpurpose>Connexion à un serveur</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_connect</function></funcdef> <paramdef>string <parameter>host</parameter></paramdef> <paramdef>string <parameter>db</parameter></paramdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_connect</function> sert à se connecter à un serveur Ovrimos. </para> <para> <function>ovrimos_connect</function> retourne un identifiant de connexion, supérieur à 0, ou 0 en cas d'échec.<parameter>host</parameter> est l'adresse IP de l'hôte Ovrimos, et <parameter>db</parameter> est soit le nom d'une base de données, soit une chaîne contenant le numéro de port. </para> <para> <example> <title>Exemple avec <function>ovrimos_connect</function></title> <programlisting role="php"><?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> L'exemple ci-dessus montre comment se connecter à une base de données et afficher le contenu d'une table. </para> </refsect1> </refentry> <refentry id="function.ovrimos-close"> <refnamediv> <refname>ovrimos_close</refname> <refpurpose>Ferme une connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>ovrimos_close</function></funcdef> <paramdef>int <parameter>connection</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_close</function> sert à ferme une connexion à un serveur Ovrimos. </para> <para> <function>ovrimos_close</function> ferme la connexion au serveur Ovrimos. Toutes les transactions non validées sont annulées. </para> </refsect1> </refentry><!-- <refentry id="function.ovrimos-close-all"> <refnamediv> <refname>ovrimos_close_all</refname> <refpurpose>Ferme toutes les connexions aux serveurs ovrimos</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>void <function>ovrimos_close_all</function></funcdef> <paramdef>void</paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_close_all</function> sert à ferme toutes les connexions. </para> <para> <function>ovrimos_close_all</function> ferme toute les connexions à Ovrimos. Toutes les transactions non validées sont annulées. </para> </refsect1> </refentry>--> <refentry id="function.ovrimos-longreadlen"> <refnamediv> <refname>ovrimos_longreadlen</refname> <refpurpose> Indique la taille des données à lire dans une colonne de grande taille </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_longreadlen</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_longreadlen</function> sert à lire la taille des données qui sera lues lors de l'accès une colonne de grande taille. </para> <para> <function>ovrimos_longreadlen</function> indique le nombre d'octets qui seront lus dans une colonne de grande taille (long varchar et long varbinary). Par défaut, 0. Indépendemment du fait que <function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>, actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre pour tous les résultats. </para> </refsect1> </refentry> <refentry id="function.ovrimos-prepare"> <refnamediv> <refname>ovrimos_prepare</refname> <refpurpose>Prépare une requête SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_prepare</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_prepare</function> sert à préparer une requête SQL. </para> <para> <function>ovrimos_prepare</function> prépare une requête SQL et retourne un identifiant de résultat result_id (ou &false; en cas d'échec). </para> <para> <example> <title> Connexion à un serveur Ovrimos SQL Server et préparation d'une requête </title> <programlisting role="php"><?php$conn=ovrimos_connect("db_host", "8001", "admin", "password");if ($conn!=0) { echo "Connection établie!"; $res=ovrimos_prepare($conn, "select table_id, table_name from sys.tables where table_id=1"); if ($res != 0) { echo "Préparation faite!"; if (ovrimos_execute($res)) { echo "Exécution réussie!\n"; ovrimos_result_all($res); } else { echo "Exécution manquée!"; } ovrimos_free_result($res); } else { echo "Préparation manquée!\n"; } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server, comment préparer une requête SQL et l'exécuter. </para> </refsect1> </refentry> <refentry id="function.ovrimos-execute"> <refnamediv> <refname>ovrimos_execute</refname> <refpurpose>Exécute une requête préparée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_execute</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>array <parameter><optional>parameters_array</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_execute</function> sert à exécuter une requête SQL. </para> <para> <function>ovrimos_execute</function> exécute une requête préparée. <function>ovrimos_execute</function> retourne &true; ou &false;. Si la requête préparée contient des paramètres (des points d'interrogations dans la requête), un nombre correct de paramètre doit être passé dans le tableau <parameter>parameters_array</parameter>. Notez que <function>ovrimos_execute</function> ne suit pas les conventions PHP qui placent les noms des paramètres entre crochets. L'auteur n'a pas pu s'y faire. </para> </refsect1> </refentry> <refentry id="function.ovrimos-cursor"> <refnamediv> <refname>ovrimos_cursor</refname> <refpurpose>Retourne le nom du curseur</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_cursor</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_cursor</function> sert à lire le nom du curseur </para> <para> <function>ovrimos_cursor</function> retourne le nom du curseur. Pratique, lorsqu'on veut faire des modifications ou des effacements avec des curseurs déjà positionnés. </para> </refsect1> </refentry> <refentry id="function.ovrimos-exec"> <refnamediv> <refname>ovrimos_exec</refname> <refpurpose>Exécute une requête SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_exec</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_exec</function> sert à exécuter une requête SQL. </para> <para> <function>ovrimos_exec</function> exécute une requête SQL (selection ou modification), et retourne un identifiant de résultat result_id (ou bien &false;, en cas d'échec). Evidemment, la requête SQL ne doit pas contenir de paramètres. </para> </refsect1> </refentry> <refentry id="function.ovrimos-fetch-into"> <refnamediv> <refname>ovrimos_fetch_into</refname> <refpurpose>Lit une ligne dans un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_fetch_into</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>array <parameter>result_array</parameter></paramdef> <paramdef>string <parameter><optional>how</optional></parameter> </paramdef> <paramdef>int <parameter><optional>rownumber</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_fetch_into</function> lit une ligne dans un résultat SQL. </para> <para> <function>ovrimos_fetch_into</function> lit une ligne dans le résultat <parameter>result_id</parameter>, qui doit être passé en référence. La ligne qui sera lue est déterminée par les deux paramètres <parameter><optional>how</optional></parameter> et <parameter><optional>rownumber</optional></parameter>. <parameter><optional>how</optional></parameter> peut prendre les valeurs de 'Next' (suivant, valeur par défaut), 'Prev' (précédent), 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La casse de <parameter><optional>how</optional></parameter> n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter> est optionnel, sauf dans le cas d''Absolute'. <function>ovrimos_fetch_into</function> retourne &true; ou &false;. </para> <para> <example> <title>Lit un exemple</title> <programlisting role="php"><?php$conn=ovrimos_connect("neptune", "8001", "admin", "password");if ($conn!=0) { echo "Connection établie!"; $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables"); if ($res != 0) { echo "Requête effectuée!"; if (ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; if (ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { echo "Next: erreur\n"; } } else { echo "First: erreur\n"; } ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple lis une ligne. </para> </refsect1> </refentry> <refentry id="function.ovrimos-fetch-row"> <refnamediv> <refname>ovrimos_fetch_row</refname> <refpurpose>Lit une ligne dans un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_fetch_row</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter><optional>how</optional></parameter> </paramdef> <paramdef>int <parameter><optional>row_number</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un résultat SQL. </para> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un résultat. Les colonnes doivent être lues par un autre appel. Retourne &true; en cas de succs et &false; sinon. </para> <para> <example> <title>Exemple de lecture de ligne</title> <programlisting role="php"><?php$conn = ovrimos_connect("remote.host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; if (ovrimos_fetch_row($res, "First")) { $table_id = ovrimos_result($res, 1); $table_name = ovrimos_result($res, 2); echo "table_id=".$table_id.", table_name=".$table_name."\n"; if (ovrimos_fetch_row($res, "Next")) { $table_id = ovrimos_result($res, "table_id"); $table_name = ovrimos_result($res, "table_name"); echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { echo "Next: erreur\n"; } } else { echo "First: erreur\n"; } ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple lit une ligne et l'affiche. </para> </refsect1> </refentry> <refentry id="function.ovrimos-result"> <refnamediv> <refname>ovrimos_result</refname> <refpurpose>Lit le contenu d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_result</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>mixed <parameter>field</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_result</function> sert à lire le contenu de l;a colonne <parameter>field</parameter> dans le rsultat <parameter>result_id</parameter>. </para> <para> <function>ovrimos_result</function> lit le contenu de la colonne <parameter>field</parameter> dans le résultat <parameter>result_id</parameter>. <parameter>field</parameter> peut être le nom de la colonne (une chaîne) ou bien le numéro de la colonne (la première colonne est alors 1). </para> </refsect1> </refentry> <refentry id="function.ovrimos-result-all"> <refnamediv> <refname>ovrimos_result_all</refname> <refpurpose> Affiche un résultat sous forme de table HTML </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>ovrimos_result_all</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>string <parameter><optional>format</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_result_all</function> sert à afficher tout le résultat d'une requête. </para> <para> <function>ovrimos_result_all</function> affiche le résultat de la requête représentée par <parameter>result_id</parameter>. <function>ovrimos_result_all</function> retourne &true; ou &false;. </para> <para> <example> <title>Prépare une requête, l'éxécute, et affiche le résultat</title> <programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_prepare($conn, "select table_id, table_name from sys.tables where table_id = 7"); if ($res != 0) { echo "Préparation faite!"; if (ovrimos_execute($res, array(3))) { echo "Exécution réussie!\n"; ovrimos_result_all($res); } else { echo "Exécution manquée!"; } ovrimos_free_result($res); } else { echo "Préparation manquée!\n"; } ovrimos_close($conn);}?> </programlisting> </example> Cet exemple exécute une requête SQL et affiche le résultat sous forme d'une table HTML. </para> <para> <example> <title><function>ovrimos_result_all</function> avec meta-information</title> <programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables where table_id = 1") if ($res != 0) { echo "Requête effectuée! cursor=".ovrimos_cursor($res)."\n"; $colnb = ovrimos_num_fields($res); echo "Output columns=".$colnb."\n"; for ($i=1; $i<=$colnb; $i++) { $name = ovrimos_field_name($res, $i); $type = ovrimos_field_type($res, $i); $len = ovrimos_field_len($res, $i); echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; } ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> </para> <para> <example> <title>Exemple avec <function>ovrimos_result_all</function></title> <programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_exec($conn, "update test set i=5"); if ($res != 0) { echo "Requête effectuée!"; echo ovrimos_num_rows($res)." lignes affectées\n"; ovrimos_free_result($res); } ovrimos_close($conn);}?> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.ovrimos-num-rows"> <refnamediv> <refname>ovrimos_num_rows</refname> <refpurpose> Retourne le nombre de lignes affectées par une modification </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_num_rows</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_num_rows</function> retourne le nombre de lignes affectées par une modification </para> </refsect1> </refentry> <refentry id="function.ovrimos-num-fields"> <refnamediv> <refname>ovrimos_num_fields</refname> <refpurpose>Retourne le nombre de colonnes</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_num_fields</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_num_fields</function> indique le nombre de colonnes du résultat <parameter>result_id</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-name"> <refnamediv> <refname>ovrimos_field_name</refname> <refpurpose>Retourne le nom d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_name</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>field_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_name</function> sert à obtenir le nom d'une colonne. </para> <para> <function>ovrimos_field_name</function> retourne le nom d'une colonne à partir de son numéro de colonne <parameter>field_number</parameter>, (la première colonne est à 1). </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-type"> <refnamediv> <refname>ovrimos_field_type</refname> <refpurpose> Retourne le type numérique d'une colonne </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_type</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>field_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_type</function> sert à connaître le type numérique d'une colonne. </para> <para> <function>ovrimos_field_type</function> retourne le type numérique d'une colonne, identifiée par son numéro <parameter>field_number</parameter> dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-len"> <refnamediv> <refname>ovrimos_field_len</refname> <refpurpose>Retourne la taille d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_len</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>int <parameter>field_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_len</function> sert à connaître la taille d'une colonne. </para> <para> <function>ovrimos_field_len</function> retourne la taille de la colonne <parameter>field_number</parameter>, dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-field-num"> <refnamediv> <refname>ovrimos_field_num</refname> <refpurpose>Retourne le numéro de colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_field_num</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>string <parameter>field_name</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_field_num</function> sert à connaître le nuémro de colonne, à partir de son nom. </para> <para> <function>ovrimos_field_num</function> retourne le numéro de la colonne <parameter>field_name</parameter> (la numérotation commence à 1), dans <parameter>result_id</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-free-result"> <refnamediv> <refname>ovrimos_free_result</refname> <refpurpose>Libère les ressources utilisées par un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_free_result</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_free_result</function> sert à effacer un résultat. </para> <para> <function>ovrimos_free_result</function> libère toutes les ressources prises par le résultat <parameter>result_id</parameter>. <function>ovrimos_free_result</function> retourne &true;. </para> </refsect1> </refentry> <refentry id="function.ovrimos-commit"> <refnamediv> <refname>ovrimos_commit</refname> <refpurpose>Valide une transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_commit</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_commit</function> sert à exécuter une transaction. </para> <para> <function>ovrimos_commit</function> exécute la transaction préparée sur la connexion <parameter>connection_id</parameter>. </para> </refsect1> </refentry> <refentry id="function.ovrimos-rollback"> <refnamediv> <refname>ovrimos_rollback</refname> <refpurpose>Annule une transaction</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>ovrimos_rollback</function></funcdef> <paramdef>int <parameter>connection_id</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>ovrimos_rollback</function> sert à annuler une transaction. </para> <para> <function>ovrimos_rollback</function> annule la transaction préparée sur la connexion <parameter>connection_id</parameter>. </para> </refsect1> </refentry> </reference><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tsgml-parent-document:nilsgml-default-dtd-file:"../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:--> \ No newline at end of file +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.7 $ --> +<reference id="ref.ovrimos"> + <title>Ovrimos SQL</title> + <titleabbrev>OvrimosSQL</titleabbrev> + <partintro> + <para> + Ovrimos SQL Server est une base de données relationnelle client/serveur + et transactionnelle, combinée avec des fonctionnalités web, et des + transactions rapides. + </para> + <para> + Ovrimos SQL Server est disponible à <ulink + url="&url.ovrimos;">www.ovrimos.com</ulink>. Pour activer le support + ovrimos de PHP, il suffit de compiler PHP avec l'option + <link linkend="install.configure.with-ovrimos"><option role="configure">--with-ovrimos</option></link> + du script de configuration. Vous devrez aussi installer la librairie sqlcli + disponible avec la distribution Ovrimos SQL Server. + </para> + <para> + <example> + <title> + Connection au serveur Ovrimos SQL Server et sélection d'une table système + </title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password"); +if ($conn != 0) { + echo ("Connection établie!"); + $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + ovrimos_result_all($res); + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple effectue une connexion réussie. + </para> + </partintro> + <refentry id="function.ovrimos-connect"> + <refnamediv> + <refname>ovrimos_connect</refname> + <refpurpose>Connexion à un serveur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>db</parameter></paramdef> + <paramdef>string <parameter>user</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_connect</function> sert à se connecter à un serveur + Ovrimos. + </para> + <para> + <function>ovrimos_connect</function> retourne un identifiant de connexion, + supérieur à 0, ou 0 en cas d'échec.<parameter>host</parameter> + est l'adresse IP de l'hôte Ovrimos, et <parameter>db</parameter> est soit + le nom d'une base de données, soit une chaîne contenant + le numéro de port. + </para> + <para> + <example> + <title>Exemple avec <function>ovrimos_connect</function></title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + ovrimos_result_all($res); + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + L'exemple ci-dessus montre comment se connecter à une base de données + et afficher le contenu d'une table. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-close"> + <refnamediv> + <refname>ovrimos_close</refname> + <refpurpose>Ferme une connexion</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>ovrimos_close</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_close</function> sert à ferme une connexion + à un serveur Ovrimos. + </para> + <para> + <function>ovrimos_close</function> ferme la connexion au serveur + Ovrimos. Toutes les transactions non validées sont annulées. + </para> + </refsect1> + </refentry> +<!-- + <refentry id="function.ovrimos-close-all"> + <refnamediv> + <refname>ovrimos_close_all</refname> + <refpurpose>Ferme toutes les connexions aux serveurs ovrimos</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>ovrimos_close_all</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_close_all</function> sert à ferme toutes les connexions. + </para> + <para> + <function>ovrimos_close_all</function> ferme toute les connexions à + Ovrimos. Toutes les transactions non validées sont annulées. + </para> + </refsect1> + </refentry> +--> + <refentry id="function.ovrimos-longreadlen"> + <refnamediv> + <refname>ovrimos_longreadlen</refname> + <refpurpose> + Indique la taille des données à lire dans une colonne de grande taille + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_longreadlen</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_longreadlen</function> sert à lire la taille des + données qui sera lues lors de l'accès une colonne de grande taille. + </para> + <para> + <function>ovrimos_longreadlen</function> indique le nombre d'octets + qui seront lus dans une colonne de grande taille (long varchar et long + varbinary). Par défaut, 0. Indépendemment du fait que + <function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>, + actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre + pour tous les résultats. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-prepare"> + <refnamediv> + <refname>ovrimos_prepare</refname> + <refpurpose>Prépare une requête SQL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_prepare</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_prepare</function> sert à préparer une requête SQL. + </para> + <para> + <function>ovrimos_prepare</function> prépare une requête SQL + et retourne un identifiant de résultat result_id (ou &false; en cas d'échec). + </para> + <para> + <example> + <title> + Connexion à un serveur Ovrimos SQL Server et préparation + d'une requête + </title> + <programlisting role="php"> +<?php +$conn=ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn!=0) { + echo "Connection établie!"; + $res=ovrimos_prepare($conn, "select table_id, table_name + from sys.tables where table_id=1"); + if ($res != 0) { + echo "Préparation faite!"; + if (ovrimos_execute($res)) { + echo "Exécution réussie!\n"; + ovrimos_result_all($res); + } else { + echo "Exécution manquée!"; + } + ovrimos_free_result($res); + } else { + echo "Préparation manquée!\n"; + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server, + comment préparer une requête SQL et l'exécuter. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-execute"> + <refnamediv> + <refname>ovrimos_execute</refname> + <refpurpose>Exécute une requête préparée</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_execute</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array + <parameter><optional>parameters_array</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_execute</function> sert à exécuter une requête SQL. + </para> + <para> + <function>ovrimos_execute</function> exécute une requête + préparée. <function>ovrimos_execute</function> + retourne &true; ou &false;. Si la requête préparée + contient des paramètres (des points d'interrogations dans la + requête), un nombre correct de paramètre doit être + passé dans le tableau <parameter>parameters_array</parameter>. Notez + que <function>ovrimos_execute</function> ne + suit pas les conventions PHP qui placent les noms des paramètres + entre crochets. L'auteur n'a pas pu s'y faire. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-cursor"> + <refnamediv> + <refname>ovrimos_cursor</refname> + <refpurpose>Retourne le nom du curseur</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_cursor</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_cursor</function> sert à lire le nom du curseur + </para> + <para> + <function>ovrimos_cursor</function> retourne le nom du curseur. + Pratique, lorsqu'on veut faire des modifications ou des effacements + avec des curseurs déjà positionnés. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-exec"> + <refnamediv> + <refname>ovrimos_exec</refname> + <refpurpose>Exécute une requête SQL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_exec</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_exec</function> sert à exécuter une + requête SQL. + </para> + <para> + <function>ovrimos_exec</function> exécute une requête SQL + (selection ou modification), et retourne un identifiant de résultat + result_id (ou bien &false;, en cas d'échec). Evidemment, la + requête SQL ne doit pas contenir de paramètres. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-fetch-into"> + <refnamediv> + <refname>ovrimos_fetch_into</refname> + <refpurpose>Lit une ligne dans un résultat</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_fetch_into</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array <parameter>result_array</parameter></paramdef> + <paramdef>string + <parameter><optional>how</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>rownumber</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_fetch_into</function> lit une ligne dans un résultat SQL. + </para> + <para> + <function>ovrimos_fetch_into</function> lit une ligne dans le + résultat <parameter>result_id</parameter>, qui doit être passé + en référence. La ligne qui sera lue est déterminée par les deux + paramètres <parameter><optional>how</optional></parameter> et + <parameter><optional>rownumber</optional></parameter>. + <parameter><optional>how</optional></parameter> peut prendre les valeurs de + 'Next' (suivant, valeur par défaut), 'Prev' (précédent), + 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La + casse de <parameter><optional>how</optional></parameter> + n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter> + est optionnel, sauf dans le cas d''Absolute'. + <function>ovrimos_fetch_into</function> retourne &true; ou &false;. + </para> + <para> + <example> + <title>Lit un exemple</title> + <programlisting role="php"> +<?php +$conn=ovrimos_connect("neptune", "8001", "admin", "password"); +if ($conn!=0) { + echo "Connection établie!"; + $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + if (ovrimos_fetch_into($res, &$row)) { + list ($table_id, $table_name) = $row; + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + if (ovrimos_fetch_into($res, &$row)) { + list ($table_id, $table_name) = $row; + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + } else { + echo "Next: erreur\n"; + } + } else { + echo "First: erreur\n"; + } + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple lis une ligne. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-fetch-row"> + <refnamediv> + <refname>ovrimos_fetch_row</refname> + <refpurpose>Lit une ligne dans un résultat</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_fetch_row</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int + <parameter><optional>how</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>row_number</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_fetch_row</function> lit une ligne dans un résultat SQL. + </para> + <para> + <function>ovrimos_fetch_row</function> lit une ligne dans un résultat. + Les colonnes doivent être lues par un autre appel. Retourne &true; en + cas de succès et &false; sinon. + </para> + <para> + <example> + <title>Exemple de lecture de ligne</title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("remote.host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); + if ($res != 0) { + echo "Requête effectuée!"; + if (ovrimos_fetch_row($res, "First")) { + $table_id = ovrimos_result($res, 1); + $table_name = ovrimos_result($res, 2); + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + if (ovrimos_fetch_row($res, "Next")) { + $table_id = ovrimos_result($res, "table_id"); + $table_name = ovrimos_result($res, "table_name"); + echo "table_id=".$table_id.", table_name=".$table_name."\n"; + } else { + echo "Next: erreur\n"; + } + } else { + echo "First: erreur\n"; + } + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple lit une ligne et l'affiche. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-result"> + <refnamediv> + <refname>ovrimos_result</refname> + <refpurpose>Lit le contenu d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_result</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>mixed <parameter>field</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_result</function> sert à lire le contenu de l;a + colonne <parameter>field</parameter> dans le résultat + <parameter>result_id</parameter>. + </para> + <para> + <function>ovrimos_result</function> lit le contenu de la colonne + <parameter>field</parameter> dans le résultat + <parameter>result_id</parameter>. <parameter>field</parameter> peut + être le nom de la colonne (une chaîne) ou bien le numéro + de la colonne (la première colonne est alors 1). + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-result-all"> + <refnamediv> + <refname>ovrimos_result_all</refname> + <refpurpose> + Affiche un résultat sous forme de table HTML + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>ovrimos_result_all</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>string + <parameter><optional>format</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_result_all</function> sert à afficher tout le résultat + d'une requête. + </para> + <para> + <function>ovrimos_result_all</function> affiche le résultat de la requête + représentée par <parameter>result_id</parameter>. + <function>ovrimos_result_all</function> retourne &true; ou &false;. + </para> + <para> + <example> + <title>Prépare une requête, l'éxécute, et affiche le résultat</title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res = ovrimos_prepare($conn, "select table_id, table_name + from sys.tables where table_id = 7"); + if ($res != 0) { + echo "Préparation faite!"; + if (ovrimos_execute($res, array(3))) { + echo "Exécution réussie!\n"; + ovrimos_result_all($res); + } else { + echo "Exécution manquée!"; + } + ovrimos_free_result($res); + } else { + echo "Préparation manquée!\n"; + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + Cet exemple exécute une requête SQL et affiche le résultat sous forme + d'une table HTML. + </para> + <para> + <example> + <title><function>ovrimos_result_all</function> avec meta-information</title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res = ovrimos_exec($conn, "select table_id, table_name + from sys.tables where table_id = 1") + if ($res != 0) { + echo "Requête effectuée! cursor=".ovrimos_cursor($res)."\n"; + $colnb = ovrimos_num_fields($res); + echo "Output columns=".$colnb."\n"; + for ($i=1; $i<=$colnb; $i++) { + $name = ovrimos_field_name($res, $i); + $type = ovrimos_field_type($res, $i); + $len = ovrimos_field_len($res, $i); + echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; + } + ovrimos_result_all($res); + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + </para> + <para> + <example> + <title>Exemple avec <function>ovrimos_result_all</function></title> + <programlisting role="php"> +<?php +$conn = ovrimos_connect("db_host", "8001", "admin", "password"); +if ($conn != 0) { + echo "Connection établie!"; + $res = ovrimos_exec($conn, "update test set i=5"); + if ($res != 0) { + echo "Requête effectuée!"; + echo ovrimos_num_rows($res)." lignes affectées\n"; + ovrimos_free_result($res); + } + ovrimos_close($conn); +} +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-num-rows"> + <refnamediv> + <refname>ovrimos_num_rows</refname> + <refpurpose> + Retourne le nombre de lignes affectées par une modification + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_num_rows</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_num_rows</function> retourne le nombre de lignes + affectées par une modification + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-num-fields"> + <refnamediv> + <refname>ovrimos_num_fields</refname> + <refpurpose>Retourne le nombre de colonnes</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_num_fields</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_num_fields</function> indique le nombre de colonnes + du résultat <parameter>result_id</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-name"> + <refnamediv> + <refname>ovrimos_field_name</refname> + <refpurpose>Retourne le nom d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_name</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_name</function> sert à obtenir le nom d'une + colonne. + </para> + <para> + <function>ovrimos_field_name</function> retourne le nom d'une colonne + à partir de son numéro de colonne <parameter>field_number</parameter>, + (la première colonne est à 1). + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-type"> + <refnamediv> + <refname>ovrimos_field_type</refname> + <refpurpose> + Retourne le type numérique d'une colonne + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_type</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_type</function> sert à connaître le type + numérique d'une colonne. + </para> + <para> + <function>ovrimos_field_type</function> retourne le type numérique + d'une colonne, identifiée par son numéro <parameter>field_number</parameter> + dans le résultat <parameter>field_number</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-len"> + <refnamediv> + <refname>ovrimos_field_len</refname> + <refpurpose>Retourne la taille d'une colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_len</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_len</function> sert à connaître la taille + d'une colonne. + </para> + <para> + <function>ovrimos_field_len</function> retourne la taille de la + colonne <parameter>field_number</parameter>, dans le résultat + <parameter>field_number</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-field-num"> + <refnamediv> + <refname>ovrimos_field_num</refname> + <refpurpose>Retourne le numéro de colonne</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_field_num</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>string <parameter>field_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_field_num</function> sert à connaître le nuémro de + colonne, à partir de son nom. + </para> + <para> + <function>ovrimos_field_num</function> retourne le numéro de la colonne + <parameter>field_name</parameter> (la numérotation commence à 1), dans + <parameter>result_id</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-free-result"> + <refnamediv> + <refname>ovrimos_free_result</refname> + <refpurpose>Libère les ressources utilisées par un résultat</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_free_result</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_free_result</function> sert à effacer un résultat. + </para> + <para> + <function>ovrimos_free_result</function> libère toutes les + ressources prises par le résultat <parameter>result_id</parameter>. + <function>ovrimos_free_result</function> retourne &true;. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-commit"> + <refnamediv> + <refname>ovrimos_commit</refname> + <refpurpose>Valide une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_commit</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_commit</function> sert à exécuter une + transaction. + </para> + <para> + <function>ovrimos_commit</function> exécute la transaction préparée + sur la connexion <parameter>connection_id</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.ovrimos-rollback"> + <refnamediv> + <refname>ovrimos_rollback</refname> + <refpurpose>Annule une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ovrimos_rollback</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ovrimos_rollback</function> sert à annuler une transaction. + </para> + <para> + <function>ovrimos_rollback</function> annule la transaction préparée sur + la connexion <parameter>connection_id</parameter>. + </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: +--> +