cvs: phpdoc /fr/functions mysql.xml nis.xml oci8.xml oracle.xml ovrimos.xml pcntl.xml

From:	Damien Seguy	Date:	Mon, 12 Nov 2001 23:37:23 +0000
Subject:	cvs: phpdoc /fr/functions mysql.xml nis.xml oci8.xml oracle.xml ovrimos.xml pcntl.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969338795@lists.php.net to get a copy of this message

dams Mon Nov 12 18:37:23 2001 EDT Added files: /phpdoc/fr/functions pcntl.xml Modified files: /phpdoc/fr/functions nis.xml oci8.xml oracle.xml ovrimos.xml mysql.xml Log: Added upades since july 1rst Minor typos corrections.

Index: phpdoc/fr/functions/nis.xml diff -u phpdoc/fr/functions/nis.xml:1.7 phpdoc/fr/functions/nis.xml:1.8 --- phpdoc/fr/functions/nis.xml:1.7 Sat Jul 7 18:22:17 2001 +++ phpdoc/fr/functions/nis.xml Mon Nov 12 18:37:22 2001 @@ -1,377 +1 @@ - <reference id="ref.nis"> - <title>NIS</title> - <titleabbrev>NIS</titleabbrev> - <partintro> - <para> - NIS (feu Yellow Pages / Pages jaunes) permet la gestion par le - réseau de fichiers d'administration importants (tel un - fichier de mot de passe). Pour plus d'informations, reportez - vous au manuel NIS, ou à - <ulink url="&url.nis;">Introduction to YP/NIS</ulink>Introduction to YP/NIS - (en anglais). Il existe un livre en anglais - <ulink url="&url.nis.book;">Managing NFS and NIS</ulink>" par Hal Stern. - </para> - <para> - Pour ajouter ces fonctionnalitées, vous devez compiler PHP - avec l'option <option role="configure">--with-yp</option>(PHP 3) ou - <option role="configure">--enable-yp</option>(PHP 4). - </para> - </partintro> - <refentry id="function.yp-get-default-domain"> - <refnamediv> - <refname>yp_get_default_domain</refname> - <refpurpose>Retourne le domaine NIS par défaut.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yp_get_default_domain</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yp_get_default_domain</function> retourne le nom de domaine NIS - par défaut. Ce nom de domaine peut être utilisé pour - les futurs appels NIS. - </para> - <para> - Un domaine NIS peut être décrit comme un regroupement - de cartes NIS. Tous les hôtes qui ont besoin d'informations, - s'attachent à un domaine. Référez vous aux documents - cités en début de document pour plus de détails. - </para> - <para> - <example> - <title>Exemple avec le domaine par défaut</title> - <programlisting role="php"> -<?php - $domain = yp_get_default_domain(); - echo "Le domaine par défaut est : " . $domain; -?> - </programlisting> - </example> - </para> - - </refsect1> - </refentry> - <refentry id="function.yp-order"> - <refnamediv> - <refname>yp_order</refname> - <refpurpose>Retourne le numéro d'ordre d'une carte.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yp_order</function></funcdef> - <paramdef>string <parameter>domain</parameter></paramdef> - <paramdef>string <parameter>map</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yp_order</function> retourne le numéro d'ordre d'une - carte ou &false;. - </para> - <para> - <example> - <title>Exemple d'ordre NIS </title> - <programlisting role="php"> -<?php - $number = yp_order($domain,$mapname); - echo "Le numéro d'ordre de cette carte est : " . $order; -?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>yp-get-default-domain</function>. - - </para> - </refsect1> - </refentry> - <refentry id="function.yp-master"> - <refnamediv> - <refname>yp_master</refname> - <refpurpose> - Retourne le nom de la machine maître pour une carte. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>yp_master</function></funcdef> - <paramdef>string <parameter>domain</parameter></paramdef> - <paramdef>string <parameter>map</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yp_master</function> retourne le nom de la machine maître - d'une carte. - </para> - <para> - <example> - <title>Exemple de maître NIS</title> - <programlisting role="php"> -<?php - $number = yp_master($domain, $mapname); - echo "Master for this map is: " . $master; -?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>yp-get-default-domain</function>. - - </para> - </refsect1> - </refentry> - <refentry id="function.yp-match"> - <refnamediv> - <refname>yp_match</refname> - <refpurpose>Retourne la ligne associée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>yp_match</function></funcdef> - <paramdef>string <parameter>domain</parameter></paramdef> - <paramdef>string <parameter>map</parameter></paramdef> - <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yp_match</function> retourne la valeur associée - à la clé passée en argument, pour la carte - spécifiée, ou &false;. La clé doit exister et - être exacte. - </para> - <para> - <example> - <title>Exemple de recherche NIS </title> - <programlisting role="php"> -<?php - $entry = yp_match($domain, "passwd.byname", "joe"); - echo "La valeur trouvée est: " . $entry; -?> - </programlisting> - </example> - </para> - <para> - Dans le cas présent, ce pourrait être: - joe:##joe:11111:100:Joe User:/home/j/joe:/usr/local/bin/bash - </para> - <para> - Voir aussi <function>yp-get-default-domain</function> - - </para> - </refsect1> - </refentry> - <refentry id="function.yp-first"> - <refnamediv> - <refname>yp_first</refname> - <refpurpose> - Retourne le premier couple (clé ; valeur) d'une carte donnée. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>yp_first</function></funcdef> - <paramdef>string <parameter>domain</parameter></paramdef> - <paramdef>string <parameter>map</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yp_first</function> retourne le premier couple - (clé ; valeur) d'une carte donnée, ou &false;. - </para> - <para> - <example> - <title>Exemple avec <function>yp_first</function></title> - <programlisting role="php"> -<?php -$entree = yp_first($domain, "passwd.byname"); -$cle = $entry ["key"]; -$valeur = $entry ["value"]; -echo "La première entrée de cette carte est " . $key - . " et sa valeur est " . $entry[$key]; -?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>yp-get-default-domain</function> - - </para> - </refsect1> - </refentry> - <refentry id="function.yp-next"> - <refnamediv> - <refname>yp_next</refname> - <refpurpose> - Retourne le couple (clé ; valeur) suivant d'une carte donnée. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>yp_next</function></funcdef> - <paramdef>string <parameter>domain</parameter></paramdef> - <paramdef>string <parameter>map</parameter></paramdef> - <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yp_next</function> retourne le couple (clé ; valeur) - suivant la clé donnée d'une carte donnée ou &false;. - </para> - <para> - <example> - <title>Exemple avec <function>yp_next</function></title> - <programlisting role="php"> -<?php - $entry = yp_next($domain, "passwd.byname", "joe"); - if(!$entry) { - echo "Plus d'autres entrées.\n"; -  } - $key = key($entry); - echo "L'entrée suivante après "joe" a la cl&eacute " . $key - . " et la valeur " . $entry[$key]; -?> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>yp-get-default-domain</function>. - - </para> - </refsect1> - </refentry> - - - </reference> - +<?xml version="1.0" encoding="iso-8859-1"?> <reference id="ref.nis"> <title>NIS</title> <titleabbrev>NIS</titleabbrev> <partintro> <para> NIS (feu Yellow Pages / Pages jaunes) permet la gestion par le réseau de fichiers d'administration importants (tel un fichier de mot de passe). Pour plus d'informations, reportez vous au manuel NIS, ou à <ulink url="&url.nis;">Introduction to YP/NIS</ulink>Introduction to YP/NIS (en anglais). Il existe un livre en anglais <ulink url="&url.nis.book;">Managing NFS and NIS</ulink>" par Hal Stern. </para> <para> Pour ajouter ces fonctionnalitées, vous devez compiler PHP avec l'option <link linkend="install.configure.with-yp"><option role="configure">--with-yp</option></link> (PHP 3) ou <link linkend="install.configure.enable-yp"><option role="configure">--enable-yp</option></link> (PHP 4). </para> </partintro> <refentry id="function.yp-get-default-domain"> <refnamediv> <refname>yp_get_default_domain</refname> <refpurpose>Retourne le domaine NIS par défaut.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>yp_get_default_domain</function></funcdef> <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> <function>yp_get_default_domain</function> retourne le nom de domaine NIS par défaut. Ce nom de domaine peut être utilisé pour les futurs appels NIS. </para> <para> Un domaine NIS peut être décrit comme un regroupement de cartes NIS. Tous les hôtes qui ont besoin d'informations, s'attachent à un domaine. Référez-vous aux documents cités en début de document pour plus de détails. </para> <para> <example> <title>Exemple avec le domaine par défaut</title> <programlisting role="php"><?php $domain = yp_get_default_domain(); echo "Le domaine par défaut est : " . $domain;?> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.yp-order"> <refnamediv> <refname>yp_order</refname> <refpurpose>Retourne le numéro d'ordre d'une carte.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>yp_order</function></funcdef> <paramdef>string <parameter>domain</parameter></paramdef> <paramdef>string <parameter>map</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>yp_order</function> retourne le numéro d'ordre d'une carte ou &false;. </para> <para> <example> <title>Exemple d'ordre NIS </title> <programlisting role="php"><?php$number = yp_order($domain,$mapname);echo "Le numéro d'ordre de cette carte est : " . $number;?> </programlisting> </example> </para> <para> Voir aussi <function>yp-get-default-domain</function>. </para> </refsect1> </refentry> <refentry id="function.yp-master"> <refnamediv> <refname>yp_master</refname> <refpurpose> Retourne le nom de la machine maître pour une carte. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>yp_master</function></funcdef> <paramdef>string <parameter>domain</parameter></paramdef> <paramdef>string <parameter>map</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>yp_master</function> retourne le nom de la machine maître d'une carte. </para> <para> <example> <title>Exemple de maître NIS</title> <programlisting role="php"><?php $number = yp_master($domain, $mapname); echo "Master for this map is: " . $master;?> </programlisting> </example> </para> <para> Voir aussi <function>yp-get-default-domain</function>. </para> </refsect1> </refentry> <refentry id="function.yp-match"> <refnamediv> <refname>yp_match</refname> <refpurpose>Retourne la ligne associée.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>yp_match</function></funcdef> <paramdef>string <parameter>domain</parameter></paramdef> <paramdef>string <parameter>map</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>yp_match</function> retourne la valeur associée à la clé passée en argument, pour la carte spécifiée, ou &false;. La clé doit exister et être exacte. </para> <para> <example> <title>Exemple de recherche NIS </title> <programlisting role="php"><?php $entry = yp_match($domain, "passwd.byname", "joe"); echo "La valeur trouvée est: " . $entry;?> </programlisting> </example> </para> <para> Dans le cas présent, ce pourrait être: joe:##joe:11111:100:Joe User:/home/j/joe:/usr/local/bin/bash </para> <para> Voir aussi <function>yp-get-default-domain</function>. </para> </refsect1> </refentry> <refentry id="function.yp-first"> <refnamediv> <refname>yp_first</refname> <refpurpose> Retourne le premier couple (clé ; valeur) d'une carte donnée. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>yp_first</function></funcdef> <paramdef>string <parameter>domain</parameter></paramdef> <paramdef>string <parameter>map</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>yp_first</function> retourne le premier couple (clé ; valeur) d'une carte donnée, ou &false;. </para> <para> <example> <title>Exemple avec <function>yp_first</function></title> <programlisting role="php"><?php$entree = yp_first($domain, "passwd.byname");$cle = $entry ["key"];$valeur = $entry ["value"];echo "La première entrée de cette carte est " . $key . " et sa valeur est " . $entry[$key];?> </programlisting> </example> </para> <para> Voir aussi <function>yp-get-default-domain</function>. </para> </refsect1> </refentry> <refentry id="function.yp-next"> <refnamediv> <refname>yp_next</refname> <refpurpose> Retourne le couple (clé ; valeur) suivant d'une carte donnée. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>yp_next</function></funcdef> <paramdef>string <parameter>domain</parameter></paramdef> <paramdef>string <parameter>map</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>yp_next</function> retourne le couple (clé ; valeur) suivant la clé donnée d'une carte donnée ou &false;. </para> <para> <example> <title>Exemple avec <function>yp_next</function></title> <programlisting role="php"><?php $entry = yp_next($domain, "passwd.byname", "joe"); if(!$entry) { echo "Plus d'autres entrées.\n";  } $key = key($entry); echo "L'entrée suivante après "joe" a la clé " . $key . " et la valeur " . $entry[$key];?> </programlisting> </example> </para> <para> Voir aussi <function>yp-get-default-domain</function>. </para> </refsect1> </refentry> </reference> \ No newline at end of file Index: phpdoc/fr/functions/oci8.xml diff -u phpdoc/fr/functions/oci8.xml:1.14 phpdoc/fr/functions/oci8.xml:1.15 --- phpdoc/fr/functions/oci8.xml:1.14 Fri Jul 20 03:58:17 2001 +++ phpdoc/fr/functions/oci8.xml Mon Nov 12 18:37:22 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> + <reference id="ref.oci8"> <title>Oracle 8</title> <titleabbrev>oci8</titleabbrev> @@ -383,7 +385,9 @@ </example> </para> <simpara> - Voir aussi <function>ociplogon</function> et <function>ocinlogon</function>. + Voir aussi + <function>ociplogon</function> et + <function>ocinlogon</function>. </simpara> </refsect1> </refentry> @@ -412,7 +416,9 @@ connexion. </para> <simpara> - Voir aussi <function>ocilogon</function> et <function>ocinlogon</function>. + Voir aussi + <function>ocilogon</function> et + <function>ocinlogon</function>. </simpara> </refsect1></refentry> <refentry id="function.ocinlogon"> @@ -523,7 +529,8 @@ </example> </para> <simpara> - Voir aussi <function>ocilogon</function> et + Voir aussi + <function>ocilogon</function> et <function>ociplogon</function>. </simpara> </refsect1> @@ -531,7 +538,7 @@ <refentry id="function.ocilogoff"> <refnamediv> <refname>ociLogOff</refname> - <refpurpose>Déconnexion d'un serveur Oracle </refpurpose> + <refpurpose>Déconnexion d'un serveur Oracle.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -549,7 +556,7 @@ <refentry id="function.ociexecute"> <refnamediv> <refname>ociexecute</refname> - <refpurpose>Exécute une commande </refpurpose> + <refpurpose>Exécute une commande.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -594,7 +601,7 @@ <refentry id="function.ocirollback"> <refnamediv> <refname>ociRollback</refname> - <refpurpose>Annule les transactions en cours </refpurpose> + <refpurpose>Annule les transactions en cours.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -633,14 +640,14 @@ oci_D_FILE, oci_D_LOB et oci_D_ROWID. </para> <example> - <title>ociNewDescriptor</title> + <title>ocinewdescriptor</title> <programlisting role="php"> <?php /* Ce script est fait pour être appelé dans un formulaire HTML * Il attends les variables $user, $password, $table, $where, et $commitsize * Le script efface alors les lignes sélectionnées avec ROWID et valide * l'effacement après chaque groupe de $commitsize lignes. - * (Utilisez avec prudences, car il n'y a pas d'annulation possible). + * (Utilisez avec prudence, car il n'y a pas d'annulation possible). */ $conn = ociLogon($user, $password); $stmt = ociparse($conn,"select rowid from $table $where"); @@ -697,6 +704,36 @@ ?> </programlisting> </example> + <example> + <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 : + * + * PROCEDURE save_data + * Nom de l'argument Type In/Out Default? + * ------------------------------ ----------------------- ------ -------- + * KEY NUMBER(38) IN + * DATA CLOB IN + * + */ + + $conn = OCILogon($user, $password); + $stmt = OCIParse($conn, "begin save_data(:key, :data); end;"); + $clob = OCINewDescriptor($conn, OCI_D_LOB); + OCIBindByName($stmt, ':key', $key); + OCIBindByName($stmt, ':data', $clob, -1, OCI_B_CLOB); + $clob->WriteTemporary($data); + OCIExecute($stmt, OCI_DEFAULT); + OCICommit($conn); + $clob->close(); + $clob->free(); + OCIFreeStatement($stmt); +?> + </programlisting> + </example> </refsect1> </refentry> <refentry id="function.ocirowcount"> @@ -792,7 +829,7 @@ <refentry id="function.ociresult"> <refnamediv> <refname>ociResult</refname> - <refpurpose>Retourne la valeur d'une colonne dans une ligne lue</refpurpose> + <refpurpose>Retourne la valeur d'une colonne</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -816,7 +853,7 @@ <refnamediv> <refname>ociFetch</refname> <refpurpose> - Modifie la prochaine ligne dans le pointeur interne de résultat. + Modifie la prochaine ligne dans le résultat. </refpurpose> </refnamediv> <refsect1> @@ -894,7 +931,7 @@ <funcprototype> <funcdef>int <function>ocifetchstatement</function></funcdef> <paramdef>resource <parameter>stmt</parameter></paramdef> - <paramdef>array &<parameter>variable</parameter></paramdef> + <paramdef>array &<parameter>variable</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -943,7 +980,7 @@ <refentry id="function.ocicolumnisnull"> <refnamediv> <refname>ociColumnIsNULL</refname> - <refpurpose>Teste si la valeur d'une colonne est NULL </refpurpose> + <refpurpose>Teste si la valeur d'une colonne est NULL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1142,7 +1179,8 @@ </example> </para> <simpara> - Voir aussi <function>ocinumcols</function>, + Voir aussi + <function>ocinumcols</function>, <function>ocicolumnname</function> et <function>ocicolumnsize</function>. </simpara> @@ -1182,7 +1220,7 @@ <refentry id="function.ocistatementtype"> <refnamediv> <refname>ociStatementType</refname> - <refpurpose>Retourne le type de commande oci.</refpurpose> + <refpurpose>Retourne le type de commande OCI.</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc/fr/functions/oracle.xml diff -u phpdoc/fr/functions/oracle.xml:1.10 phpdoc/fr/functions/oracle.xml:1.11 --- phpdoc/fr/functions/oracle.xml:1.10 Sat Nov 10 16:49:50 2001 +++ phpdoc/fr/functions/oracle.xml Mon Nov 12 18:37:22 2001 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> - + <reference id="ref.oracle"> <title>Oracle</title> <titleabbrev>Oracle</titleabbrev> @@ -266,8 +266,10 @@ <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> - Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, - et <function>ora_fetch</function>. + Voir aussi + <function>ora_parse</function>, + <function>ora_exec</function> et + <function>ora_fetch</function>. </para> </refsect1> </refentry> @@ -378,8 +380,10 @@ Lit une ligne de données sur le pointeur cursor. </para> <simpara> - Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, - et <function>ora_do</function>. + Voir aussi + <function>ora_parse</function>, + <function>ora_exec</function> et + <function>ora_do</function>. </simpara> </refsect1> </refentry> @@ -420,8 +424,11 @@ Notez que vous devez passer le tableau par référence; </para> <simpara> - Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, - <function>ora_fetch</function>, et <function>ora_do</function>. + Voir aussi + <function>ora_parse</function>, + <function>ora_exec</function>, + <function>ora_fetch</function> et + <function>ora_do</function>. </simpara> </refsect1> </refentry> @@ -565,8 +572,11 @@ significative qu'après une requête parse/exec/fetch. </para> <simpara> - Voir aussi <function>ora_parse</function>,<function>ora_exec</function>, - <function>ora_fetch</function>, et <function>ora_do</function>. + Voir aussi + <function>ora_parse</function>, + <function>ora_exec</function>, + <function>ora_fetch</function> et + <function>ora_do</function>. </simpara> </refsect1> </refentry> Index: phpdoc/fr/functions/ovrimos.xml diff -u phpdoc/fr/functions/ovrimos.xml:1.5 phpdoc/fr/functions/ovrimos.xml:1.6 --- phpdoc/fr/functions/ovrimos.xml:1.5 Sat Jul 7 18:22:19 2001 +++ phpdoc/fr/functions/ovrimos.xml Mon Nov 12 18:37:22 2001 @@ -1,789 +1 @@ - <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 transactionelle, 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 '--with-ovrimos' - du script de configuration. Vous devrez aussi installer la librairie sqlcli - disponbile avec la distribution Ovrimos SQL Server. - </para> - <para> - <example> - <title> - Connection au serveur Ovrimos SQL Server et selectionn 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 donnes, 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ée - 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 serveur 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. Retourne vrai. - </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>int <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. - 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>int <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 optionne, sauf dans le cas d''Absolute'. 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>int <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; ou &false;. - </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 d'une - colonne. - </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>int <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>. 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 à connaitre 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>. 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> - +<?xml version="1.0" encoding="iso-8859-1"?><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-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> \ No newline at end of file Index: phpdoc/fr/functions/mysql.xml diff -u phpdoc/fr/functions/mysql.xml:1.17 phpdoc/fr/functions/mysql.xml:1.18 --- phpdoc/fr/functions/mysql.xml:1.17 Sat Jul 7 18:22:16 2001 +++ phpdoc/fr/functions/mysql.xml Mon Nov 12 18:37:22 2001 @@ -1,1632 +1 @@ - <reference id="ref.mysql"> - <title>MySQL</title> - <titleabbrev>MySQL</titleabbrev> - <partintro> - <simpara> - Ces fonctions vous permettent d'accéder aux bases de données MySQL. - Afin de pouvoir les utiliser, vous devez compiler PHP avec le support - MySQL, en utilisant l'option <option role="configure">--with-mysql</option>. - Si vous utilisez cette fonction sans préciser le chemin - d'accès à la base MySQL, PHP utilisera les librairies cliente MySQL - fournies en standard. Les utilisateurs qui font tourner d'autres - applications qui utilisent elles-mêmes MySQL (par exemple, PHP 3 et - PHP 4 utilisés comme des modules concurents apache, ou encore - auth-mysql), devrait toujours spécifier le chemin jusqu'à MySQL : - <option role="configure">--with-mysql=/path/to/mysql</option>. - Cela va forcer PHP à utiliser les librairies clientes installées par - MySQL et évitera les conflits. - </simpara> - <simpara> - Plus d'informations sont disponibles à - <ulink url="http://www.mysql.com/">http://www.mysql.com/</ulink>. - </simpara> - <simpara> - La documentation de MySQL est disponibles à <ulink - url="&url.mysql.docs;">&url.mysql.docs;</ulink>, ainsi qu'en français - chez <ulink url="http://dev.nexen.net/docs/mysql/">nexen</ulink>. - </simpara> - </partintro> - <refentry id="function.mysql-affected-rows"> - <refnamediv> - <refname>mysql_affected_rows</refname> - <refpurpose> - Retourne le nombre de lignes affectées lors de la dernière - requête SQL. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_affected_rows</function></funcdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_affected_rows</function> retourne le nombre de lignes affectées - lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur - associé à l'identifiant de connexion. Si cet identifiant n'est pas - précisé, <function>mysql_affected_rows</function> utilise la - dernière connexion ouverte. - </para> - <note> - <para> - Si vous utilisez les transactions, vous devez appeler - <function>mysql_affected_rows</function> après votre INSERT, - UPDATE, ou DELETE et non après la validation. - </para> - </note> - <para> - Si la dernière requête était un DELETE sans clause WHERE, tous - les enregistrements ont été effacés, mais - <function>mysql_affected_rows</function> va retourner 0. - </para> - <para> - <function>mysql_affected_rows</function> n'est pas possible après un - SELECT, car elle ne fonctionne qu'après des commandes qui modifient - les enregistrements. Pour connaître le nombre de lignes - retournées par un SELECT, utilisez <function>mysql_num_rows</function>. - </para> - <para> - Si la dernière requête a échoué, - <function>mysql_affected_rows</function> retourne -1. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-change-user"> - <refnamediv> - <refname>mysql_change_user</refname> - <refpurpose> - Change le nom de session de l'utilisateur actif. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_change_user</function></funcdef> - <paramdef>string <parameter>user</parameter></paramdef> - <paramdef>string <parameter>password</parameter></paramdef> - <paramdef>string - <parameter> - <optional>database</optional> - </parameter> - </paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_change_user</function> change l'utilisateur en cours de la session - active, ou sur la connexion spécifiée avec l'option - <parameter>link_identifier</parameter>. - Si une base est spécifiée, elle deviendra la base par - défaut de l'utilisateur. Si une erreur de connexion survient, - la connexion en cours restera active. - </para> - <note> - <para> - <function>mysql_change_user</function> a été introduite - en PHP 3.0.13 et requiert MySQL 3.23.3 ou plus récent. - </para></note> - </refsect1> - </refentry> - <refentry id="function.mysql-close"> - <refnamediv> - <refname>mysql_close</refname> - <refpurpose>Ferme la connexion MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>mysql_close</function></funcdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_close</function> retourne &true; en cas - de succès et &false; sinon. - </para> - <para> - <function>mysql_close</function> ferme la connexion au serveur MySQL - associée à l'identifiant <parameter>link_identifier</parameter>. - Si cet identifiant n'est pas spécifié, cette commande s'applique - à la dernière connexion ouverte. - </para> - <note> - <para> - Notez que cette commande n'est pas nécessaire, car toutes les connexions non - persistantes seront automatiquement fermées à la fin du script. - </para> - </note> - <para> - <function>mysql_close</function> ne ferme pas les connexions persistantes - générées par <function>mysql_pconnect</function>. - </para> - <example> - <title>Exemple MySQL_close</title> - <programlisting role="php"> -<?php - $link = mysql_connect ("kraemer", "marliesle", "secret") { - or die ("Impossible de se connecter"); - } - print ("Connexion réussie"); - mysql_close ($link); -?> - </programlisting> - </example> - <para> - Voir aussi <function>mysql_connect</function> et <function>mysql_pconnect</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-connect"> - <refnamediv> - <refname>mysql_connect</refname> - <refpurpose>Ouvre une connexion à un serveur MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_connect</function></funcdef> - <paramdef>string - <parameter> - <optional>hostname - <optional>:port</optional> - <optional>:/path/to/socket</optional> - </optional> - </parameter> - </paramdef> - <paramdef>string - <parameter> - <optional>username</optional> - </parameter> - </paramdef> - <paramdef>string - <parameter> - <optional>password</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_connect</function> retourne un identifiant positif de - connexion en cas de succès, et sinon &false;. - </para> - <para> - <function>mysql_connect</function> établit une connexion à - un serveur MySQL. Tous les arguments sont optionnels, et s'ils manquent, - les valeurs par défaut sont utilisées ( ('localhost', nom - du propriétaire du process, mot de passe vide). - </para> - <para> - Le nom d'hôte peut aussi inclure un numéro de port, sous la forme : - "hostname:port" ou un chemin jusqu'à une socket sous la forme - ":/path/to/socket" pour l'hôte localhost. - <note> - <para> - Le support des ":port" a été ajouté à partir de la version 3.0B4. - </para> - <para> - Le support de ":/path/to/socket" a été ajouté à partir de la - version 3.0.10. - </para> - <para> - Vous pouvez supprimer le message d'erreur de connexion en ajoutant un arobase - '@' au nom de la fonction. - </para> - </note> - </para> - <para> - Si un second appel à <function>mysql_connect</function> est fait avec - les mêmes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va - retourner l'identifiant de la connexion déjà ouverte. - </para> - <para> - Le lien sera fermé automatiquement dès que l'exécution du script sera terminée, - à moins d'être fermé explicitement avec <function>mysql_close</function>. - </para> - <example> - <title>Exemple MySQL connect</title> - <programlisting role="php"> -<?php - $link = mysql_connect ("kraemer", "marliesle", "secret") { - or die ("Connexion impossible"); - } - print ("Connexion réussie"); - mysql_close ($link); -?> - </programlisting> - </example> - <para> Voir aussi <function>mysql_pconnect</function> et <function>mysql_close</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-create-db"> - <refnamediv> - <refname>mysql_create_db</refname> - <refpurpose>Crée une base de données MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_create_db</function></funcdef> - <paramdef>string <parameter>database name</parameter></paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_create_db</function> tente de créer une nouvelle - base de données sur le serveur associé à l'identifiant - <parameter>link_identifier</parameter>, - ou la dernière connexion ouverte. - </para> - <example> - <title>Exemple de création de base MySQL</title> - <programlisting role="php"> -<?php - $link = mysql_pconnect ("kron", "jutta", "geheim") { - or die ("Connexion impossible"); - } - if (mysql_create_db ("my_db")) { - print ("Base de données créée\n"); - } else { - printf ("Erreur lors de la création de la base: %s\n", mysql_error()); - } -?> - </programlisting> - </example> - <para> - Pour des raisons de compatibilité ascendante, mysql_createdb() est toujours - utilisable. - </para> - <para> - Voir aussi <function>mysql_drop_db</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-data-seek"> - <refnamediv> - <refname>mysql_data_seek</refname> - <refpurpose>Déplace le pointeur interne de résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_data_seek</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>row_number</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_data_seek</function> retourne &true; - en cas de succès et &false; sinon. - </para> - <para> - <function>mysql_data_seek</function> déplace le pointeur - interne de résultat, dans le résultat associé à - l'identifiant de résultat <parameter>result_identifier</parameter>. - Il le fait pointer à la ligne <parameter>row_number</parameter>. - Le prochain appel à <function>mysql_fetch_row</function> - retournera cette ligne. - </para> - <para> - <parameter>row_number</parameter> commence à 0. - </para> - <example> - <title>Exemple <function>mysql_data_seek</function></title> - <programlisting role="php"> -<?php - $link = mysql_pconnect ("kron", "jutta", "geheim") { - or die ("Connexion impossible"); - } - mysql_select_db ("samp_db") { - or die ("Selection de base impossible"); - } - $query = "SELECT last_name, first_name FROM friends"; - $result = mysql_query ($query) { - or die ("Requête impossible"); - } - # récupère les lignes dans l'ordre inverse - for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) { - if (!mysql_data_seek ($result, $i)) { - printf ("Impossible d'atteindre la ligne %d\n", $i); - continue; - } - if(!($row = mysql_fetch_object ($result))) - continue; - printf ("%s %s<BR>\n", $row->last_name, $row->first_name); - } - mysql_free_result ($result); -?> - </programlisting> - </example> - </refsect1> - </refentry> - <refentry id="function.mysql-db-name"> - <refnamediv> - <refname>mysql_db_name</refname> - <refpurpose>Lit les noms des bases de donné</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mysql_db_name</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed - <parameter> - <optional>field</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>mysql_db_name</function> prend comme premier argument - le pointeur de résultat <parameter>result_identifier</parameter>, - issu de <function>mysql_list_dbs</function>. - <parameter>row</parameter> est l'index dans le résultat. - </para> - <para> - Si une erreur survient, &false; est retourné. Utilisez - <function>mysql_errno</function> et - <function>mysql_error</function> pour connaître la nature de l'erreur. - </para> - <example> - <title>Exemple <function>mysql_db_name</function></title> - <programlisting role="php"> -<?php -error_reporting(E_ALL); -mysql_connect('dbhost', 'username', 'password'); -$db_list = mysql_list_dbs(); -$i = 0; -$cnt = mysql_num_rows($db_list); -while ($i < $cnt) { - echo mysql_db_name($db_list, $i) . "\n"; - $i++; -} -?> - </programlisting> - </example> - <para> - Pour des raisons de compatibilité ascendante, mysql_dbname() - est aussi accepté, mais obsolète. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-db-query"> - <refnamediv> - <refname>mysql_db_query</refname> - <refpurpose>Envoie une requête MySQL à un serveur MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>resource <function>mysql_db_query</function></funcdef> - <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_db_query</function> retourne un identifiant de - résultat si la requête réussit et - &false; sinon. - </para> - <para> - <function>mysql_db_query</function> sélectionne une base de données - et exécute une requête. Si l'identifiant de lien - <parameter>link_identifier</parameter> n'est pas précisé, - <function>mysql_db_query</function> prendra par défaut la dernière - connexion ouverte sur le serveur et si elle n'en trouve pas, elle tentera - de se connecter, en utilisant la fonction <function>mysql_connect</function>, - sans arguments. - </para> - <para> - Voir aussi <function>mysql_connect</function>. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql() peut aussi - être utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-drop-db"> - <refnamediv> - <refname>mysql_drop_db</refname> - <refpurpose>Efface une base de données MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>mysql_drop_db</function></funcdef> - <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_drop_db</function> retourne &true; - en cas de succès et &false; sinon. - </para> - <para> - <function>mysql_drop_db</function> essaie d'effacer une base - de données entière sur le serveur associé - à l'identifiant de connexion <parameter>link_identifier</parameter>. - </para> - <para> - Voir aussi <function>mysql_create_db</function>. - </para> - <para> - Pour des raisons de comptabilité ascendante, mysql_drop_db() est toujours - utilisable. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-errno"> - <refnamediv> - <refname>mysql_errno</refname> - <refpurpose> - Retourne le numéro de message d'erreur de la dernière - opération MySQL. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_errno</function></funcdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_errno</function> retourne le numéro de message - d'erreur de la dernière opération MySQL sur la connexion courante, - ou sur la connexion spécifiée avec l'option - <parameter>link_identifier</parameter>. Les erreurs qui - sont remontées depuis le serveur MySQL ne sont plus des alertes. - A la place, il faut utiliser <function>mysql_errno</function> pour - obtenir le numéro d'erreur. - <informalexample> - <programlisting role="php"> -<?php -mysql_connect("marliesle"); -echo mysql_errno().": ".mysql_error()."<BR>"; -mysql_select_db("nonexistentdb"); -echo mysql_errno().": ".mysql_error()."<BR>"; -$conn = mysql_query("SELECT * FROM nonexistenttable"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> - </programlisting> - </informalexample> - </para> - <para> - Voir aussi <function>mysql_error</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-error"> - <refnamediv> - <refname>mysql_error</refname> - <refpurpose> - Retourne le texte associée avec l'erreur générée - lors de la dernière requête. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>mysql_error</function></funcdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_error</function> retourne le dernier message - d'erreur MySQL sur la connexion courante, ou sur la connexion - spécifiée avec <parameter>link_identifier</parameter>. - </para> - <para> - Les erreurs générées par mySQL ne se - transforment plus en alerte. A la place, elles sont accessibles - via ces fonctions : - <informalexample> - <programlisting role="php"> -<?php -mysql_connect("marliesle"); -echo mysql_errno().": ".mysql_error()."<BR>"; -mysql_select_db("nonexistentdb"); -echo mysql_errno().": ".mysql_error()."<BR>"; -$conn = mysql_query("SELECT * FROM nonexistenttable"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> - </programlisting> - </informalexample> - </para> - <para> - Voir aussi <function>mysql_errno</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-fetch-array"> - <refnamediv> - <refname>mysql_fetch_array</refname> - <refpurpose> - Retourne une ligne de résultat sous la forme d'un tableau associatif. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>array <function>mysql_fetch_array</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int - <parameter> - <optional>result_type</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_fetch_array</function> retourne un tableau qui - contient la ligne demandée, ou &false; - si il ne reste plus de ligne. - </para> - <para> - <function>mysql_fetch_array</function> est une version étendue de - <function>mysql_fetch_row</function>. En plus d'enregistrer les données - sous forme d'un tableau à indice numérique, elle peut aussi - les enregistrer dans un tableau associatif, en utilisant les noms des - champs comme indices. - </para> - <para> - Si plusieurs colonnes ont le même nom, la dernière colonne - aura la priorité. Pour accéder aux autres colonnes du - même nom, vous devez utiliser l'index numériques, ou - faire un alias pour chaque colonne. - <informalexample> - <programlisting role="sql"> -select t1.f1 as foo t2.f1 as bar from t1, t2 - </programlisting> - </informalexample> - </para> - <para> - Il est important de souligne que <function>mysql_fetch_array</function> N'est PAS - plus lente que <function>mysql_fetch_row</function>, tandis qu'elle ajoute un - confort d'utilisation notable. - </para> - <para> - L'option <parameter>result_type</parameter> de - <function>mysql_fetch_array</function> est une constant qui peut prendre les - valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM et MYSQL_BOTH. - </para> - <para> - Pour plus de détails, voir aussi <function>mysql_fetch_row</function>. - </para> - <example> - <title>mysql fetch array</title> - <programlisting role="php"> -<?php -mysql_connect($host,$user,$password); -$result = mysql_db_query("database","select * from table"); -while($row = mysql_fetch_array($result)) { - echo $row["user_id"]; - echo $row["fullname"]; -} -mysql_free_result($result); -?> - </programlisting> - </example> - </refsect1> - </refentry> - <refentry id="function.mysql-fetch-assoc"> - <refnamediv> - <refname>mysql_fetch_assoc</refname> - <refpurpose> - Lit une ligne de résultat dans un tableau associatif - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>mysql_fetch_assoc</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>mysql_fetch_assoc</function> retourne un tableau associatif - qui contient la ligne lue, ou bien &false;, - si il ne reste plus de lignes. - </para> - <para> - <function>mysql_fetch_assoc</function> est équivalente à - <function>mysql_fetch_array</function> utilisée avec l'option MYSQL_ASSOC. - Elle ne retourne qu'un tableau associatif. C'est le fonctionnement - original de <function>mysql_fetch_array</function>. Si vous avez besoin - d'indices numériques, utilisez <function>mysql_fetch_array</function>. - </para> - <para> - Si plusieurs colonnes on le même nom, la dernière aura la priorité. - Pour accéder aux autres colonnes du même nom, vous devez utiliser - <function>mysql_fetch_array</function> et les indices numériques. - </para> - <para> - Une chose importante à noter est que <function>mysql_fetch_assoc</function> - n'est PAS significativement plus lente que - <function>mysql_fetch_row</function>, alors qu'elle apporte un confort - d'utilisation important. - </para> - <para> - Pour plus de détails, reportez vous à - <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. - </para> - <example> - <title><function>mysql_fetch_assoc</function></title> - <programlisting role="php"> -<?php -mysql_connect ($host, $user, $password); -$result = mysql_db_query ("database","select * from table"); -while ($row = mysql_fetch_assoc ($result)) { - echo $row["user_id"]; - echo $row["fullname"]; -} -mysql_free_result ($result); -?> - </programlisting> - </example> - </refsect1> - </refentry> - <refentry id="function.mysql-fetch-field"> - <refnamediv> - <refname>mysql_fetch_field</refname> - <refpurpose> - Retourne les données enregistrées dans une colonne - sous forme d'objet. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>object <function>mysql_fetch_field</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int - <parameter> - <optional>field_offset</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - Retourne un objet contenant les données. - </para> - <para> - <function>mysql_fetch_field</function> sert à obtenir des informations à propos - des champs, dans certaines requêtes. Si l'offset du champs n'est pas spécifié, - le champs suivant le dernier champs retourné, est retourné. - </para> - <para> - Les propriétés de l'objet sont : - <itemizedlist> - <listitem> - <simpara> - name - nom de la colonne - </simpara> - </listitem> - <listitem> - <simpara> - table - nom de la table de la colonne - </simpara> - </listitem> - <listitem> - <simpara> - max_length - taille maximale de la colonne - </simpara> - </listitem> - <listitem> - <simpara> - not_null - 1 si la colonne ne peut pas être &null; (attribut NOT &null;) - </simpara> - </listitem> - <listitem> - <simpara> - primary_key - 1 si la colonne est une clé primaire (attribut PRIMARY KEY) - </simpara> - </listitem> - <listitem> - <simpara> - unique_key - 1 si la colonne est une clé unique (attribut UNIQUE) - </simpara> - </listitem> - <listitem> - <simpara> - multiple_key - 1 si la colonne est une clé non-unique - </simpara> - </listitem> - <listitem> - <simpara> - numeric - 1 si la colonne est numérique - </simpara> - </listitem> - <listitem> - <simpara> - blob - 1 si la colonne est BLOB - </simpara> - </listitem> - <listitem> - <simpara> - type - le type de la colonne - </simpara> - </listitem> - <listitem> - <simpara> - unsigned - 1 si la colonne est non signé - </simpara> - </listitem> - <listitem> - <simpara> - zerofill - 1 si la colonne est complétée par des zéros. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Voir aussi <function>mysql_field_seek</function> - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-fetch-lengths"> - <refnamediv> - <refname>mysql_fetch_lengths</refname> - <refpurpose> - Retourne la taille de chaque colonne d'une ligne de résultat. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>array <function>mysql_fetch_lengths</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_fetch_lengths</function> retourne un tableau avec - la taille de chaque colonne de la dernière ligne retournée - par <function>mysql_fetch_row</function>, sinon &false;. - </para> - <para> - <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne - de la dernière ligne retournée par <function>mysql_fetch_row</function>, - <function>mysql_fetch_array</function> et - <function>mysql_fetch_object</function> dans un tableau, en commencant à la - position. - </para> - <para> - Voir aussi <function>mysql_fetch_row</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-fetch-object"> - <refnamediv> - <refname>mysql_fetch_object</refname> - <refpurpose>Retourne les lignes résultats sous la forme d'un objet.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>object <function>mysql_fetch_object</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int - <parameter> - <optional>result_type</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_fetch_object</function> retourne un objet dont les - propriétés correspondent à une ligne d'un - résultat, ou &false; si il n'y a plus - d'autres lignes. - </para> - <para> - <function>mysql_fetch_object</function> est identique à - <function>mysql_fetch_array</function>, à la - différence qu'elle retourne un objet à la place - d'un tableau. Vous pourrez ainsi accéder aux valeurs - des champs par leur nom, mais plus par leur offset (les - nombres ne sont pas des noms MySQL). - </para> - <para> - L'argument optionnel <parameter>result_type</parameter> est une constante qui - peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM et MYSQL_BOTH. - </para> - <para> - Concernant la vitesse, <function>mysql_fetch_object</function> est - aussi rapide que <function>mysql_fetch_array</function> et presque - aussi rapide que <function>mysql_fetch_row</function> (la - différence est insignifiante) - <example> - <title>mysql fetch object</title> - <programlisting role="php"> -<?php -mysql_connect($host,$user,$password); -$result = mysql_db_query("database","select * from table"); -while($row = mysql_fetch_object($result)) { - echo $row->user_id; - echo $row->fullname; -} -mysql_free_result($result); -?> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>mysql_fetch_array</function> et - <function>mysql_fetch_row</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-fetch-row"> - <refnamediv> - <refname>mysql_fetch_row</refname> - <refpurpose>Retourne une ligne de résultat sous la forme d'un tableau.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>array <function>mysql_fetch_row</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - </funcsynopsis> - <para> - Retourne un tableau énuméré qui correspond à la ligne demandée, ou &false; si il ne reste plus de ligne. - </para> - <para> - <function>mysql_fetch_row</function> va rechercher une ligne dans le résultat - associé à l'identifiant de résultat spécifié. La ligne est retournée sous la - forme d'un tableau. Chaque colonne est enregistré sous la forme d'un tableau - commencant à la position 0. - </para> - <para> - Les appels suivants à <function>mysql_fetch_row</function> retourneront la ligne - suivante dans le résultat, ou &false; si il n'y a plus de ligne disponible. - </para> - <para> - Voir aussi <function>mysql_fetch_array</function>, - <function>mysql_fetch_object</function>, - <function>mysql_data_seek</function>, - <function>mysql_fetch_lengths</function> et - <function>mysql_result</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-field-flags"> - <refnamediv> - <refname>mysql_field_flags</refname> - <refpurpose> - Retourne le sémaphore associé à la colonne - spécifiée dans le résultat courant. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>mysql_field_flags</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>field_offset</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_field_flags</function> retourne le sémaphore - associé au champs spécifié par - <parameter>field_offset</parameter>. Les sémaphores sont retournés - comme des mots, séparés par des espaces, ce qui les - rend facile à séparer, avec la commande <function>explode</function>. - </para> - <para> - Les valeurs suivantes (pour une version suffisamment récente de MySQL) sont - disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", - "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_fieldflags() peut encore être - utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-field-name"> - <refnamediv> - <refname>mysql_field_name</refname> - <refpurpose> - Retourne le nom d'une colonne - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>mysql_field_name</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>field_index</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_field_name</function> retourne le nom d'une colonne. - Les arguments de la fonction sont un identifiant de résultat - <parameter>result_identifier</parameter> et l'index du champs, - ie.<literal>mysql_field_name($result,2);</literal>. - </para> - <para> - <function>mysql_field_name</function> retournera le nom du - deuxième champs dans le résultat associé - à $result. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_fieldname() - peut encore être utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-field-len"> - <refnamediv> - <refname>mysql_field_len</refname> - <refpurpose> - Retourne la longueur du champs spécifié. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_field_len</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>field_offset</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_field_len</function> retourne la taille du champs - spécifié par son offset <parameter>field_offset</parameter>. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_fieldlen() - peut encore être utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-field-seek"> - <refnamediv> - <refname>mysql_field_seek</refname> - <refpurpose> - Place le pointeur de résultat à un offset donné - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_field_seek</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>field_offset</parameter></paramdef> - </funcsynopsis> - <para> - Place le pointeur de résultat sur le champs spécifié. Lors du prochain appel à - <function>mysql_fetch_field</function> qui n'aura pas d'argument d'index de - champs, le champs désormais pointé sera retourné. - </para> - <para> - Voir aussi <function>mysql_fetch_field</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-field-table"> - <refnamediv> - <refname>mysql_field_table</refname> - <refpurpose> - Retourne le nom de la table oú se trouve une colonne - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>mysql_field_table</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>field_offset</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_field_table</function> retourne le nom de la table - oú se trouve une colonne. Pour des raisons de compatibilité - ascendante, mysql_fieldtable() peut encore être utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-field-type"> - <refnamediv> - <refname>mysql_field_type</refname> - <refpurpose> - Retourne le type de la colonne spécifiée dans le résultat courant. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>mysql_field_type</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>field_offset</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_field_type</function> est similaire à la fonction - <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est - le type du champs qui est retourné. Il vaudra "int", "real", "string", "blob", ou - d'autres, comme détaillé dans la documentation MySQL. - <example> - <title>Types mysql field</title> - <programlisting role="php"> -<?php -mysql_connect("localhost:3306"); -mysql_select_db("wisconsin"); -$result = mysql_query("SELECT * FROM onek"); -$fields = mysql_num_fields($result); -$rows = mysql_num_rows($result); -$i = 0; -$table = mysql_field_table($result, $i); -echo "Your '".$table."' table has ".$fields." fields et ".$rows." records <BR>"; -echo "The table has the following fields <BR>"; -while ($i < $fields) { - $type = mysql_field_type($result, $i); - $name = mysql_field_name($result, $i); - $len = mysql_field_len($result, $i); - $flags = mysql_field_flags($result, $i); - echo $type." ".$name." ".$len." ".$flags."<BR>"; - $i++; -} -mysql_close(); -?> - </programlisting> - </example> - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_fieldtype() - peut encore être utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-free-result"> - <refnamediv> - <refname>mysql_free_result</refname> - <refpurpose>Efface le résultat de la mémoire.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_free_result</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_free_result</function> n'est à appeler que si - vous avez peur d'utiliser trop de mémoire durant l'exécution - de votre script. Toute la mémoire associée à - l'identifiant de résultat sera automatiquement libérée. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_freeresult() - peut encore être utilisé. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-insert-id"> - <refnamediv> - <refname>mysql_insert_id</refname> - <refpurpose> - Retourne l'identifiant généré par la dernière - requête INSERT. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_insert_id</function></funcdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_insert_id</function> retourne le dernier identifiant - généré par un champs de type AUTO_INCREMENT, - sur la connexion MySQL courante, ou bien sur la connexion - spécifiée par <parameter>link_identifier</parameter>. - <function>mysql_insert_id</function> ne prend aucun argument. Elle - retourne le dernier identifiant généré par la - dernière fonction INSERT effectuée. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-list-dbs"> - <refnamediv> - <refname>mysql_list_dbs</refname> - <refpurpose> - Liste les bases de données disponibles sur le serveur MySQL. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>resource <function>mysql_list_dbs</function></funcdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_list_dbs</function> retournera un identifiant de - résultat, qui contiendra les noms des bases de données - disponibles sur la connexion MySQL courante, ou bien sur la connexion - spécifiée par <parameter>link_identifier</parameter>. - Utilisez la fonction <function>mysql_tablename</function> pour lire - toutes les bases de données. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_listdbs() - est encore disponible. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-list-fields"> - <refnamediv> - <refname>mysql_list_fields</refname> - <refpurpose>Liste les champs du résultat MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>resource <function>mysql_list_fields</function></funcdef> - <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>string <parameter>table_name</parameter></paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_list_fields</function> recherche les informations - à propos de la table spécifiée sur la connexion - MySQL courante, ou bien sur la connexion spécifiée par - <parameter>link_identifier</parameter>. Les arguments - sont la base de données et le nom de la table. Un - pointeur de résultat est retourné et pourra - être passé à - <function>mysql_field_flags</function>, - <function>mysql_field_len</function>, - <function>mysql_field_name</function> et - <function>mysql_field_type</function>. - </para> - <para> - Un identifiant de résultat est un entier positif. La fonction retourne -1 - si une erreur survient. Une chaîne décrivant le problème - rencontré sera placée dans la variable - <literal>$phperrmsg</literal> et, à moins que la fonction n'ait - été appelée sous la forme <literal>@mysql()</literal>, - cette erreur sera aussi affichée. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_listfields() - est encore disponible. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-list-tables"> - <refnamediv> - <refname>mysql_list_tables</refname> - <refpurpose>Liste les tables d'une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>resource <function>mysql_list_tables</function></funcdef> - <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_list_tables</function> prend le nom d'une base de - données <parameter>database</parameter> et retourne un identifiant - de résultat, qui contiendra la liste des tables sur la connexion MySQL - courante, ou bien sur la connexion spécifiée par - <parameter>link_identifier</parameter>. La fonction - <function>mysql_tablename</function> est le meilleur moyen - d'extraire les noms des tables depuis l'identifiant de résultat. - </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_listtables() - est encore disponible. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-num-fields"> - <refnamediv> - <refname>mysql_num_fields</refname> - <refpurpose>Retourne le nombre de champs d'un résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_num_fields</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_num_fields</function> retourne le nombre de champs d'un résultat. - </para> - <para> - Voir aussi <function>mysql_db_query</function>, <function>mysql_query</function>, - <function>mysql_fetch_field</function>, <function>mysql_num_rows</function>. - </para> - <para> - Pour des raisons de compatibilité ascendante mysql_numfields() - est encore disponible. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-num-rows"> - <refnamediv> - <refname>mysql_num_rows</refname> - <refpurpose>Retourne le nombre de ligne d'un résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_num_rows</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_num_rows</function> retourne le nombre de lignes - d'un résultat. Cette commande n'est valide que pour les commandes - SELECT . Pour connaître le nombre de lignes retournées par INSERT, UPDATE - ou DELETE, utiliseez <function>mysql_affected_rows</function>. - </para> - <example> - <title> - Exemple <function>mysql_num_rows</function> par crubel@trilizio.org - </title> - <programlisting role="php"> -<?php -$conn = mysql_connect("adresse de l'hote", "utilisateur", "mot de passe"); -mysql_select_db("base",$conn); // nécessaire si vous avez plusieurs bases -$Resultfornummembers = mysql_query("SELECT * FROM Accounts",$conn); -$NumMembers = mysql_num_rows($Resultfornummembers); -echo "$NumMembers Membres"; -?> - </programlisting> - </example> - <para> - Voir aussi <function>mysql_db_query</function>, - <function>mysql_query</function> - et <function>mysql_fetch_row</function>. - </para> - <para> - Pour des raisons de compatibilité ascendante mysql_numrows() est encore - disponible. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-pconnect"> - <refnamediv> - <refname>mysql_pconnect</refname> - <refpurpose> - Ouvre une connexion persistante à un serveur MySQL. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>resource <function>mysql_pconnect</function></funcdef> - <paramdef>string - <parameter> - <optional>hostname - <optional>:port</optional> - <optional>:/path/to/socket</optional> - </optional> - </parameter> - </paramdef> - <paramdef>string - <parameter><optional>username</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>password</optional></parameter> - </paramdef> - </funcsynopsis> - <para> - Retourne un lien persistant positif en cas de succès et sinon &false; en cas - d'erreur. - </para> - <para> - <function>mysql_pconnect</function> établit une connexion - persistante à un serveur MySQL. Tous les arguments sont - optionnels et des valeurs par défaut seront utilisérs - en cas d'omission ('localhost', nom d'utilisateur propriétaire - du processus, mot de passe vide). - </para> - <para> - Le nom de l'hôte peut aussi inclure le numéro de port, c'est - à dire "hostname:port" ou un chemin jusqu'à la - socket ":/path/to/socket" pour l'hôte local. - <note> - <para> - Le support de ":port" a été ajouté à - partir de la version 3.0B4. - </para> - <para> - Le support de ":/path/to/socket" a été ajouté - à partir de la version 3.0.10. - </para> - </note> - </para> - <para> - <function>mysql_pconnect</function> se comporte exactement comme - <function>mysql_connect</function>, mais avec deux différences majeures : - </para> - <para> - Premièrement, lors de la connexion, la fonction essaie de trouver une - connexion permanante déjà ouverte sur cet hote, avec le - même nom d'utilisateur et de mot de passe. Si une telle connexion - est trouvée, son identifiant est retourné, sans ouvrir de - nouvelle connexion. - </para> - <para> - Deuxièmement, la connexion au serveur MySQL ne sera pas terminée avec la fin - du script. Au lieu de cela, le lien sera conservé pour un prochain accès - (<function>mysql_close</function> ne terminera pas une connexion persistante - établie par <function>mysql_pconnect</function>). - </para> - <para> - C'est pourquoi ce type de connexion est dite 'persistante'. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-query"> - <refnamediv> - <refname>mysql_query</refname> - <refpurpose>Envoie une requête SQL à un serveur MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>resource <function>mysql_query</function></funcdef> - <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>resource - <parameter><optional>link_identifier</optional></parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_query</function> envoie une requête SQL à - la base de données actuellement active sur le serveur MysQL. Si - <parameter>link_identifier</parameter> n'est pas précisé, - la dernière connexion est utilisée. Si aucune connexion n'a - été ouverte, la fonction tentera d'en ouvrir une, avec la fonction - <function>mysql_connect</function> mais sans aucun paramètre - (c'est à dire avec les valeurs par défaut). - </para> - <para> - <function>mysql_connect</function> - </para> - <para> - <function>mysql_query</function> retourne &true; ou - &false;, pour indiquer le succès ou l'échec - de la requête. En cas de retour &true;, la - requête était valide et a pu être exécuté - sur le serveur. Cela n'indique pas le nombre de ligne affectées, - ou retournées. Il est parfaitement possible qu'une requête - valide n'affecte aucune ligne ou ne retourne aucune ligne. - </para> - <para> - L'exemple suivant est syntaxiquement invalide, ce qui conduit - <function>mysql_query</function> à l'échec et retourne - &false;: - <example> - <title><function>mysql_query</function></title> - <programlisting role="php"> -<?php -$result = mysql_query ("SELECT * WHERE 1=1") - or die ("Requete invalide"); -?> - </programlisting> - </example> - </para> - <para> - L'exemple suivant est sémantiquement invalide si <literal>my_col</literal> - n'est pas une colonne de la table <literal>my_tbl</literal>, ce qui conduit - <function>mysql_query</function> à l'échec et retourne &false; : - <example> - <title><function>mysql_query</function></title> - <programlisting role="php"> -<?php -$result = mysql_query ("SELECT my_col FROM my_tbl") - or die ("Invalid query"); -?> - </programlisting> - </example> - </para> - <para> - <function>mysql_query</function> échouera aussi et retournera aussi &false; si les - droits d'accès ne sont pas suffisants. - </para> - <para> - En supposant que la requête réussisse, vous pouvez appeler - <function>mysql_affected_rows</function> pour connaître le nombre de lignes - affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). - Pour les commandes SELECT , <function>mysql_query</function> retourne un - identifiant de résultat que vous pouvez passer à - <function>mysql_result</function>. Lorsque vous avez terminé - avec le résultat, libérez la mémoire avec - <function>mysql_free_result</function>. - </para> - <para> - Voir aussi - <function>mysql_affected_rows</function>, - <function>mysql_db_query</function>, - <function>mysql_free_result</function>, - <function>mysql_result</function>, - <function>mysql_select_db</function> et - <function>mysql_connect</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-result"> - <refnamediv> - <refname>mysql_result</refname> - <refpurpose>Retourne un champs d'un résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>mixed <function>mysql_result</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed - <parameter> - <optional>field</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_result</function> retourne le contenu d'un champs dans - le résultat MySQL <parameter>result_identifier</parameter>. - L'argument <parameter>row</parameter> peut-être un offset de champs, - ou le nom d'un champs, ou le nom de - la table + point + le nom du champs ("table.champs"). Si la colonne a - été aliasée, utilisez de préférence - l'alias. - </para> - <para> - Lorsque vous travaillez sur des résultats de grande taille, vous - devriez utiliser une des fonctions qui vont rechercher une ligne - entière dans un tableau. Ces fonctions sont NETTEMENT plus - rapides. De plus, l'utilisation d'un offset numériques est - aussi beaucoup plus rapide que de spécifier un nom litéral. - </para> - <para> - Les appels <function>mysql_result</function> ne devraient pas être - mélangés avec d'autres fonctions qui travaillent aussi sur - le résultat. - </para> - <para> - Alternatives à haut rendement, RECOMMANDEES : - <function>mysql_fetch_row</function>, - <function>mysql_fetch_array</function> et - <function>mysql_fetch_object</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-select-db"> - <refnamediv> - <refname>mysql_select_db</refname> - <refpurpose>Sélectionne une base de données MySQL.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>int <function>mysql_select_db</function></funcdef> - <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>resource - <parameter> - <optional>link_identifier</optional> - </parameter> - </paramdef> - </funcsynopsis> - <para> - <function>mysql_select_db</function> retourne &true; - en cas de succès, &false; sinon. - </para> - <para> - <function>mysql_select_db</function> change la base de données - active sur la connexion représentée par - <parameter>link_identifier</parameter>. Si aucun identifiant - n'est spécifié, la - dernière connexion est utilisée. S'il n'y a pas de dernière - connexion, la fonction tentera de se connecter seule, avec - <function>mysql_connect</function> et les paramètres par défaut. - </para> - <para> - Toutes les requêtes suivantes avec <function>mysql_query</function> - seront faites avec la base de données active. - </para> - <para> - Voir aussi - <function>mysql_connect</function>, - <function>mysql_pconnect</function> et - <function>mysql_query</function>. - </para> - <para> - Pour des raisons de compatibilité ascendante mysql_selectdb() est - encore disponible. - </para> - </refsect1> - </refentry> - <refentry id="function.mysql-tablename"> - <refnamediv> - <refname>mysql_tablename</refname> - <refpurpose> - Lit le nom de la table qui contient le champs spécifié. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>string <function>mysql_tablename</function></funcdef> - <paramdef>resource <parameter>result_identifier</parameter></paramdef> - <paramdef>int <parameter>i</parameter></paramdef> - </funcsynopsis> - <para> - <function>mysql_tablename</function> prend le pointeur de résultat - obtenu avec <function>mysql_list_tables</function> ou bien un index entier - et retourne le nom de la table. La fonction <function>mysql_num_rows</function> - peut être utilisée pour déterminer le nombre de - tables dans le pointeur de résultat. - <example> - <title>Exemple <function>mysql_tablename</function></title> - <programlisting role="php"> -<?php -mysql_connect ("localhost:3306"); -$result = mysql_list_tables ("wisconsin"); -$i = 0; -while ($i < mysql_num_rows($result)) { - $tb_names[$i] = mysql_tablename ($result, $i); - echo $tb_names[$i] . "<BR>"; - $i++; -} -?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - </reference> - +<?xml version="1.0" encoding="iso-8859-1"?><reference id="ref.mysql"> <title>MySQL</title> <titleabbrev>MySQL</titleabbrev> <partintro> <simpara> Ces fonctions vous permettent d'accéder aux bases de données MySQL. Afin de pouvoir les utiliser, vous devez compiler PHP avec le support MySQL, en utilisant l'option <link linkend="install.configure.with-mysql"> <option role="configure">--with-mysql</option></link>. Si vous utilisez cette fonction sans préciser le chemin d'accès à la base MySQL, PHP utilisera les librairies clientes MySQL fournies en standard. Les utilisateurs qui font tourner d'autres applications qui utilisent elles-mêmes MySQL (par exemple, PHP 3 et PHP 4 utilisés comme des modules concurrents apache, ou encore auth-mysql), devraient toujours spécifier le chemin jusqu'à MySQL : <link linkend="install.configure.with-mysql"><option role="configure">--with-mysql=/path/to/mysql</option></link>. Cela va forcer PHP à utiliser les librairies clientes installées par MySQL et évitera les conflits. </simpara> <simpara> Plus d'informations sont disponible à <ulink url="&url.mysql;">&url.mysql;</ulink>. </simpara> <simpara> La documentation de MySQL est disponibles à <ulink url="&url.mysql.docs;">&url.mysql.docs;</ulink>, ainsi qu'en français chez <ulink url="&url.mysql.docs.fr;">nexen</ulink>. </simpara> <para> Cet exemple simple montre comment se connecter, exécuter une requête, lire les informations obtenues et se déconnecter d'une base de données MySQL. <example> <title>Exemple d'introduction</title> <programlisting role="php"><?php $link = mysql_connect("hote_mysql", "login_mysql", "mot_de_passe_mysql") or die ("Impossible de se connecter"); print ("Connexion réussie"); mysql_select_db ("ma_base") or die ("Impossible d'accéder à la base de données"); $query = "SELECT * FROM ma_table"; $result = mysql_query ($query) or die ("La requête a échoué");// Affichage du résultat au format HTML print "<table>\n"; while($line = mysql_fetch_array($result)){ print "\t<tr>\n"; while(list($col_name, $col_value) = each($line)){ print "\t\t<td>$col_value</td>\n"; } print "\t</tr>\n"; } print "</table>\n"; mysql_close($link);?> </programlisting> </example> </para> </partintro> <refentry id="function.mysql-affected-rows"> <refnamediv> <refname>mysql_affected_rows</refname> <refpurpose> Retourne le nombre de lignes affectées lors de la dernière requête SQL. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_affected_rows</function></funcdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_affected_rows</function> retourne le nombre de lignes affectées lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur associé à l'identifiant de connexion. Si cet identifiant n'est pas précisé, <function>mysql_affected_rows</function> utilise la dernière connexion ouverte. </para> <note> <para> Si vous utilisez les transactions, vous devez appeler <function>mysql_affected_rows</function> après votre INSERT, UPDATE, ou DELETE et non après la validation. </para> </note> <para> Si la dernière requête était un DELETE sans clause WHERE, tous les enregistrements ont été effacés, mais <function>mysql_affected_rows</function> va retourner 0. </para> <para> <function>mysql_affected_rows</function> n'est pas possible après un SELECT, car elle ne fonctionne qu'après des commandes qui modifient les enregistrements. Pour connaître le nombre de lignes retournées par un SELECT, utilisez <function>mysql_num_rows</function>. </para> <para> Si la dernière requête a échoué, <function>mysql_affected_rows</function> retourne -1. </para> </refsect1> </refentry> <refentry id="function.mysql-change-user"> <refnamediv> <refname>mysql_change_user</refname> <refpurpose> Change le nom de session de l'utilisateur actif. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_change_user</function></funcdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> <paramdef>string <parameter> <optional>database</optional> </parameter> </paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_change_user</function> change l'utilisateur de la session courante, ou sur la connexion spécifiée avec l'option <parameter>link_identifier</parameter>. Si une base est spécifiée, elle deviendra la base par défaut de l'utilisateur. Si une erreur de connexion survient, la connexion en cours restera active. </para> <note> <para> <function>mysql_change_user</function> a été introduite en PHP 3.0.13 et requiert MySQL 3.23.3 ou plus récent. </para></note> </refsect1> </refentry> <refentry id="function.mysql-close"> <refnamediv> <refname>mysql_close</refname> <refpurpose>Ferme la connexion MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>mysql_close</function></funcdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_close</function> retourne &true; en cas de succès et &false; sinon. </para> <para> <function>mysql_close</function> ferme la connexion au serveur MySQL associée à l'identifiant <parameter>link_identifier</parameter>. Si cet identifiant n'est pas spécifié, cette commande s'applique à la dernière connexion ouverte. </para> <note> <para> Notez que cette commande n'est pas nécessaire, car toutes les connexions non persistantes seront automatiquement fermées à la fin du script. </para> </note> <para> <function>mysql_close</function> ne ferme pas les connexions persistantes générées par <function>mysql_pconnect</function>. </para> <example> <title>Exemple MySQL_close</title> <programlisting role="php"><?php $link = mysql_connect("kraemer", "marliesle", "secret") { or die("Impossible de se connecter"); } print("Connexion réussie"); mysql_close($link);?> </programlisting> </example> <para> Voir aussi <function>mysql_connect</function> et <function>mysql_pconnect</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-connect"> <refnamediv> <refname>mysql_connect</refname> <refpurpose>Ouvre une connexion à un serveur MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_connect</function></funcdef> <paramdef>string <parameter> <optional>hostname <optional>:port</optional> <optional>:/path/to/socket</optional> </optional> </parameter> </paramdef> <paramdef>string <parameter> <optional>username</optional> </parameter> </paramdef> <paramdef>string <parameter> <optional>password</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_connect</function> retourne un identifiant positif de connexion en cas de succès, et sinon &false;. </para> <para> <function>mysql_connect</function> établit une connexion à un serveur MySQL. Tous les arguments sont optionnels, et s'ils manquent, les valeurs par défaut sont utilisées ( ('localhost', nom du propriétaire du processus, mot de passe vide). </para> <para> Le nom d'hôte peut aussi inclure un numéro de port, sous la forme : "hostname:port" ou un chemin jusqu'à une socket sous la forme ":/path/to/socket" pour l'hôte localhost. <note> <para> Le support des ":port" a été ajouté à partir de la version 3.0B4. </para> <para> Le support de ":/path/to/socket" a été ajouté à partir de la version 3.0.10. </para> <para> Vous pouvez supprimer le message d'erreur de connexion en ajoutant une arobase '@' au nom de la fonction. </para> </note> </para> <para> Si un second appel à <function>mysql_connect</function> est fait avec les mêmes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va retourner l'identifiant de la connexion déjà ouverte. </para> <para> Le lien sera fermé automatiquement dès que l'exécution du script sera terminée, à moins d'être fermé explicitement avec <function>mysql_close</function>. </para> <example> <title>Exemple MySQL connect</title> <programlisting role="php"><?php $link = mysql_connect("kraemer", "marliesle", "secret") { or die("Connexion impossible"); } print("Connexion réussie"); mysql_close($link);?> </programlisting> </example> <para> Voir aussi <function>mysql_pconnect</function> et <function>mysql_close</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-create-db"> <refnamediv> <refname>mysql_create_db</refname> <refpurpose>Crée une base de données MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_create_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_create_db</function> tente de créer une nouvelle base de données nommée <parameter>database_name</parameter> sur le serveur associé à l'identifiant <parameter>link_identifier</parameter>, ou sur la dernière connexion ouverte. </para> <example> <title>Exemple de création de base MySQL</title> <programlisting role="php"><?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } if (mysql_create_db ("my_db")) { print ("Base de données créée\n"); } else { echo "Erreur lors de la création de la base: ".mysql_error(); }?> </programlisting> </example> <para> Pour des raisons de compatibilité ascendante, mysql_createdb() est toujours utilisable. </para> <para> Voir aussi <function>mysql_drop_db</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-data-seek"> <refnamediv> <refname>mysql_data_seek</refname> <refpurpose>Déplace le pointeur interne de résultat.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_data_seek</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_data_seek</function> retourne &true; en cas de succès et &false; sinon. </para> <para> <function>mysql_data_seek</function> déplace le pointeur interne de résultat, dans le résultat associé à l'identifiant de résultat <parameter>result_identifier</parameter>. Il le fait pointer à la ligne <parameter>row_number</parameter>. Le prochain appel à <function>mysql_fetch_row</function> retournera cette ligne. </para> <para> <parameter>row_number</parameter> commence à 0. </para> <example> <title>Exemple <function>mysql_data_seek</function></title> <programlisting role="php"><?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } mysql_select_db ("samp_db") { or die ("Sélection de base impossible"); } $query = "SELECT last_name, first_name FROM friends"; $result = mysql_query ($query) { or die ("Requête impossible"); }// récupère les lignes dans l'ordre inverse for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) { if (!mysql_data_seek ($result, $i)) { echo "Impossible d'atteindre la ligne $i\n"; continue; } if(!($row = mysql_fetch_object ($result))) continue; echo "{$row->last_name} {$row->last_name$row->first_name}<br>\n"; } mysql_free_result ($result);?> </programlisting> </example> </refsect1> </refentry> <refentry id="function.mysql-db-name"> <refnamediv> <refname>mysql_db_name</refname> <refpurpose>Lit les noms des bases de données</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_db_name</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_db_name</function> prend comme premier argument le pointeur de résultat <parameter>result_identifier</parameter>, issu de <function>mysql_list_dbs</function>. <parameter>row</parameter> est l'index dans le résultat. </para> <para> Si une erreur survient, &false; est retourné. Utilisez <function>mysql_errno</function> et <function>mysql_error</function> pour connaître la nature de l'erreur. </para> <example> <title>Exemple <function>mysql_db_name</function></title> <programlisting role="php"><?php error_reporting(E_ALL); mysql_connect('dbhost', 'username', 'password'); $db_list = mysql_list_dbs(); $i = 0; $cnt = mysql_num_rows($db_list); while ($i < $cnt) { echo mysql_db_name($db_list, $i) . "\n"; $i++; }?> </programlisting> </example> <para> Pour des raisons de compatibilité ascendante, mysql_dbname() est aussi accepté, mais obsolète. </para> </refsect1> </refentry> <refentry id="function.mysql-db-query"> <refnamediv> <refname>mysql_db_query</refname> <refpurpose>Envoie une requête MySQL à un serveur MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_db_query</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_db_query</function> retourne un identifiant de résultat si la requête réussit et &false; sinon. </para> <para> <function>mysql_db_query</function> sélectionne une base de données et exécute une requête. Si l'identifiant de lien <parameter>link_identifier</parameter> n'est pas précisé, <function>mysql_db_query</function> prendra par défaut la dernière connexion ouverte sur le serveur et si elle n'en trouve pas, elle tentera de se connecter, en utilisant la fonction <function>mysql_connect</function>, sans arguments. </para> <para> Voir aussi <function>mysql_connect</function> et <function>mysql_query</function>. </para> <note> <simpara> Cette fonction est obsolète, et abandonnée depuis PHP 4.0.6. Ne l'utilisez plus (ou pas!). Alternative recommandée : <function>mysql_select_db</function> et <function>mysql_query</function>. </simpara> </note> </refsect1> </refentry> <refentry id="function.mysql-drop-db"> <refnamediv> <refname>mysql_drop_db</refname> <refpurpose>Efface une base de données MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>mysql_drop_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_drop_db</function> retourne &true; en cas de succès et &false; sinon. </para> <para> <function>mysql_drop_db</function> essaie d'effacer une base de données entière sur le serveur associé à l'identifiant de connexion <parameter>link_identifier</parameter>. </para> <para> Voir aussi <function>mysql_create_db</function>. </para> <para> Pour des raisons de compatibilité ascendante, mysql_drop_db() est toujours utilisable. </para> </refsect1> </refentry> <refentry id="function.mysql-errno"> <refnamediv> <refname>mysql_errno</refname> <refpurpose> Retourne le numéro de message d'erreur de la dernière opération MySQL. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_errno</function></funcdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_errno</function> retourne le numéro de message d'erreur de la dernière opération MySQL sur la connexion courante, ou sur la connexion spécifiée avec l'option <parameter>link_identifier</parameter>. Les erreurs qui sont remontées depuis le serveur MySQL ne sont plus des alertes. A la place, il faut utiliser <function>mysql_errno</function> pour obtenir le numéro d'erreur. <informalexample> <programlisting role="php"><?php mysql_connect("marliesle"); echo mysql_errno().": ".mysql_error()."<br>"; mysql_select_db("nonexistentdb"); echo mysql_errno().": ".mysql_error()."<br>"; $conn = mysql_query("SELECT * FROM nonexistenttable"); echo mysql_errno().": ".mysql_error()."<br>";?> </programlisting> </informalexample> </para> <para> Voir aussi <function>mysql_error</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-error"> <refnamediv> <refname>mysql_error</refname> <refpurpose> Retourne le texte associé avec l'erreur générée lors de la dernière requête. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_error</function></funcdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_error</function> retourne le dernier message d'erreur MySQL sur la connexion courante, ou sur la connexion spécifiée avec <parameter>link_identifier</parameter>. </para> <para> Les erreurs générées par mySQL ne se transforment plus en alerte. A la place, elles sont accessibles via ces fonctions : <informalexample> <programlisting role="php"><?php mysql_connect("marliesle"); echo mysql_errno().": ".mysql_error()."<br>"; mysql_select_db("nonexistentdb"); echo mysql_errno().": ".mysql_error()."<br>"; $conn = mysql_query("SELECT * FROM nonexistenttable"); echo mysql_errno().": ".mysql_error()."<br>";?> </programlisting> </informalexample> </para> <para> Voir aussi <function>mysql_errno</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-escape-string"> <refnamediv> <refname>mysql_escape_string</refname> <refpurpose> Protège une chaîne pour la passer à mysql_query. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_escape_string</function></funcdef> <paramdef>string <parameter>unescaped_string</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_escape_string</function> va protéger tous les caractères de la chaîne <parameter>unescaped_string</parameter>, pour pouvoir l'utiliser directement dans une requête <function>mysql_query</function>. Elle retourne la chaîne modifiée. </para> <note> <simpara> <function>mysql_escape_string</function> n'échappe pas les caractères pourcentage <literal>%</literal> ou <literal>_</literal>. </simpara> </note> </refsect1> </refentry> <refentry id="function.mysql-fetch-array"> <refnamediv> <refname>mysql_fetch_array</refname> <refpurpose> Retourne une ligne de résultat sous la forme d'un tableau associatif. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_array</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter> <optional>result_type</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_fetch_array</function> retourne un tableau qui contient la ligne demandée, ou &false; si il ne reste plus de ligne. </para> <para> <function>mysql_fetch_array</function> est une version étendue de <function>mysql_fetch_row</function>. En plus d'enregistrer les données sous forme d'un tableau à indice numérique, elle peut aussi les enregistrer dans un tableau associatif, en utilisant les noms des champs comme indices. </para> <para> Si plusieurs colonnes portent le même nom, la dernière colonne aura la priorité. Pour accéder aux autres colonnes du même nom, vous devez utiliser l'index numérique, ou faire un alias pour chaque colonne. <informalexample> <programlisting role="sql">select t1.f1 as foo t2.f1 as bar from t1, t2 </programlisting> </informalexample> </para> <para> Il est important de souligner que <function>mysql_fetch_array</function> N'est PAS plus lente que <function>mysql_fetch_row</function>, tandis qu'elle ajoute un confort d'utilisation notable. </para> <para> L'option <parameter>result_type</parameter> de <function>mysql_fetch_array</function> est une constante qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM et MYSQL_BOTH. </para> <para> Voir aussi <function>mysql_fetch_row</function>. </para> <example> <title>mysql fetch array</title> <programlisting role="php"><?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_array($result)) { echo $row["user_id"]; echo $row["fullname"]; } mysql_free_result($result);?> </programlisting> </example> </refsect1> </refentry> <refentry id="function.mysql-fetch-assoc"> <refnamediv> <refname>mysql_fetch_assoc</refname> <refpurpose> Lit une ligne de résultats dans un tableau associatif </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_assoc</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_fetch_assoc</function> retourne un tableau associatif qui contient la ligne lue, ou bien &false;, si il ne reste plus de lignes. </para> <para> <function>mysql_fetch_assoc</function> est équivalente à <function>mysql_fetch_array</function> utilisée avec l'option MYSQL_ASSOC. Elle ne retourne qu'un tableau associatif. C'est le fonctionnement original de <function>mysql_fetch_array</function>. Si vous avez besoin d'indices numériques, utilisez <function>mysql_fetch_array</function>. </para> <para> Si plusieurs colonnes portent le même nom, la dernière aura la priorité. Pour accéder aux autres colonnes du même nom, vous devez utiliser <function>mysql_fetch_array</function> et les indices numériques. </para> <para> Une chose importante à noter est que <function>mysql_fetch_assoc</function> n'est PAS significativement plus lente que <function>mysql_fetch_row</function>, alors qu'elle apporte un confort d'utilisation important. </para> <para> Pour plus de détails, reportez-vous à <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. </para> <example> <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"><?php mysql_connect($host, $user, $password); $result = mysql_db_query("database","select * from table"); while ($row = mysql_fetch_assoc ($result)) { echo $row["user_id"]; echo $row["fullname"]; } mysql_free_result ($result);?> </programlisting> </example> </refsect1> </refentry> <refentry id="function.mysql-fetch-field"> <refnamediv> <refname>mysql_fetch_field</refname> <refpurpose> Retourne les données enregistrées dans une colonne sous forme d'objet. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>object <function>mysql_fetch_field</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter> <optional>field_offset</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_fetch_field</function> retourne un objet contenant les données, lu dans le résultat <parameter>result_identifier</parameter>. </para> <para> <function>mysql_fetch_field</function> sert à obtenir des informations à propos des champs, dans certaines requêtes. Si l'offset du champs n'est pas spécifié, le champs suivant le dernier champs retourné, est retourné. </para> <para> Les propriétés de l'objet sont : <itemizedlist> <listitem> <simpara> name - nom de la colonne </simpara> </listitem> <listitem> <simpara> table - nom de la table de la colonne </simpara> </listitem> <listitem> <simpara> max_length - taille maximale de la colonne </simpara> </listitem> <listitem> <simpara> not_null - 1 si la colonne ne peut pas être &null; (attribut NOT &null;) </simpara> </listitem> <listitem> <simpara> primary_key - 1 si la colonne est une clé primaire (attribut PRIMARY KEY) </simpara> </listitem> <listitem> <simpara> unique_key - 1 si la colonne est une clé unique (attribut UNIQUE) </simpara> </listitem> <listitem> <simpara> multiple_key - 1 si la colonne est une clé non-unique </simpara> </listitem> <listitem> <simpara> numeric - 1 si la colonne est numérique </simpara> </listitem> <listitem> <simpara> blob - 1 si la colonne est BLOB </simpara> </listitem> <listitem> <simpara> type - le type de la colonne </simpara> </listitem> <listitem> <simpara> unsigned - 1 si la colonne est non signée </simpara> </listitem> <listitem> <simpara> zerofill - 1 si la colonne est complétée par des zéros. </simpara> </listitem> </itemizedlist> </para> <para> Voir aussi <function>mysql_field_seek</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-fetch-lengths"> <refnamediv> <refname>mysql_fetch_lengths</refname> <refpurpose> Retourne la taille de chaque colonne d'une ligne de résultat. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_lengths</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_fetch_lengths</function> retourne un tableau avec la taille de chaque colonne de la dernière ligne retournée par <function>mysql_fetch_row</function>, sinon &false;. </para> <para> <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne de la dernière ligne retournée par <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et <function>mysql_fetch_object</function> dans un tableau, en commençant à la position. </para> <para> Voir aussi <function>mysql_fetch_row</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-fetch-object"> <refnamediv> <refname>mysql_fetch_object</refname> <refpurpose>Retourne les lignes résultats sous la forme d'un objet.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>object <function>mysql_fetch_object</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter> <optional>result_type</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_fetch_object</function> retourne un objet dont les propriétés correspondent à une ligne d'un résultat, ou &false; si il n'y a plus d'autres lignes. </para> <para> <function>mysql_fetch_object</function> est identique à <function>mysql_fetch_array</function>, à la différence qu'elle retourne un objet à la place d'un tableau. Vous pourrez ainsi accéder aux valeurs des champs par leur nom, mais plus par leur offset (les nombres ne sont pas des noms MySQL). </para> <para> L'argument optionnel <parameter>result_type</parameter> est une constante qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM et MYSQL_BOTH. </para> <para> Concernant la vitesse, <function>mysql_fetch_object</function> est aussi rapide que <function>mysql_fetch_array</function> et presque aussi rapide que <function>mysql_fetch_row</function> (la différence est insignifiante) <example> <title>mysql fetch object</title> <programlisting role="php"><?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_object($result)) { echo $row->user_id; echo $row->fullname; } mysql_free_result($result);?> </programlisting> </example> </para> <para> Voir aussi <function>mysql_fetch_array</function> et <function>mysql_fetch_row</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-fetch-row"> <refnamediv> <refname>mysql_fetch_row</refname> <refpurpose>Retourne une ligne de résultat sous la forme d'un tableau.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_row</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_fetch_row</function> retourne un tableau énuméré qui correspond à la ligne demandée, ou &false; s'il ne reste plus de ligne. </para> <para> <function>mysql_fetch_row</function> va rechercher une ligne dans le résultat associé à l'identifiant de résultat spécifié. La ligne est retournée sous la forme d'un tableau. Chaque colonne est enregistrée sous la forme d'un tableau commençant à la position <literal>0</literal>. </para> <para> Les appels suivants à <function>mysql_fetch_row</function> retourneront la ligne suivante dans le résultat, ou &false; si il n'y a plus de ligne disponible. </para> <para> Voir aussi <function>mysql_fetch_array</function>, <function>mysql_fetch_object</function>, <function>mysql_data_seek</function>, <function>mysql_fetch_lengths</function> et <function>mysql_result</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-field-flags"> <refnamediv> <refname>mysql_field_flags</refname> <refpurpose> Retourne le sémaphore associé à la colonne spécifiée dans le résultat courant. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_flags</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_field_flags</function> retourne le sémaphore associé au champs spécifié par <parameter>field_offset</parameter>. Les sémaphores sont retournés comme des mots, séparés par des espaces, ce qui les rend faciles à séparer, avec la commande <function>explode</function>. </para> <para> Les valeurs suivantes (pour une version suffisamment récente de MySQL) sont disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldflags() peut encore être utilisé. </para> </refsect1> </refentry> <refentry id="function.mysql-field-name"> <refnamediv> <refname>mysql_field_name</refname> <refpurpose> Retourne le nom d'une colonne </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_name</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>field_index</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_field_name</function> retourne le nom d'une colonne. Les arguments de la fonction sont un identifiant de résultat <parameter>result_identifier</parameter> et l'index du champs, ie.<literal>mysql_field_name($result,2);</literal>. </para> <para> <function>mysql_field_name</function> retournera le nom du deuxième champs dans le résultat associé à $result. </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldname() peut encore être utilisé. </para> </refsect1> </refentry> <refentry id="function.mysql-field-len"> <refnamediv> <refname>mysql_field_len</refname> <refpurpose> Retourne la longueur du champs spécifié. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_field_len</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_field_len</function> retourne la taille du champs spécifié par son offset <parameter>field_offset</parameter>. </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldlen() peut encore être utilisé. </para> </refsect1> </refentry> <refentry id="function.mysql-field-seek"> <refnamediv> <refname>mysql_field_seek</refname> <refpurpose> Déplace le pointeur de résultat </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_field_seek</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Place le pointeur de résultat sur le champs spécifié. Lors du prochain appel à <function>mysql_fetch_field</function> qui n'aura pas d'argument d'index de champs, le champs désormais pointé sera retourné. </para> <para> Voir aussi <function>mysql_fetch_field</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-field-table"> <refnamediv> <refname>mysql_field_table</refname> <refpurpose> Retourne le nom de la table où se trouve une colonne </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_table</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_field_table</function> retourne le nom de la table où se trouve une colonne. Pour des raisons de compatibilité ascendante, mysql_fieldtable() peut encore être utilisé. </para> </refsect1> </refentry> <refentry id="function.mysql-field-type"> <refnamediv> <refname>mysql_field_type</refname> <refpurpose> Retourne le type de la colonne spécifiée dans le résultat courant. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_type</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_field_type</function> est similaire à la fonction <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est le type du champs qui est retourné. Il vaudra "int", "real", "string", "blob", ou d'autres, comme détaillé dans la documentation MySQL. <example> <title>Types mysql field</title> <programlisting role="php"><?php mysql_connect("localhost:3306"); mysql_select_db("wisconsin"); $result = mysql_query("SELECT * FROM onek"); $fields = mysql_num_fields($result); $rows = mysql_num_rows($result); $i = 0; $table = mysql_field_table($result, $i); echo "Your '".$table."' table has ".$fields." fields et ".$rows." records <br>"; echo "The table has the following fields <br>"; while ($i < $fields) { $type = mysql_field_type($result, $i); $name = mysql_field_name($result, $i); $len = mysql_field_len($result, $i); $flags = mysql_field_flags($result, $i); echo $type." ".$name." ".$len." ".$flags."<br>"; $i++; } mysql_close();?> </programlisting> </example> </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldtype() peut encore être utilisé. </para> </refsect1> </refentry> <refentry id="function.mysql-free-result"> <refnamediv> <refname>mysql_free_result</refname> <refpurpose>Efface le résultat de la mémoire.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_free_result</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_free_result</function> n'est à appeler que si vous avez peur d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire associée à l'identifiant de résultat sera automatiquement libérée. </para> <para> Pour des raisons de compatibilité ascendante, mysql_freeresult() peut encore être utilisé. </para> </refsect1> </refentry> <refentry id="function.mysql-insert-id"> <refnamediv> <refname>mysql_insert_id</refname> <refpurpose> Retourne l'identifiant généré par la dernière requête INSERT. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_insert_id</function></funcdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_insert_id</function> retourne le dernier identifiant généré par un champs de type AUTO_INCREMENT, sur la connexion MySQL courante, ou bien sûr la connexion spécifiée par <parameter>link_identifier</parameter>. <function>mysql_insert_id</function> ne prend aucun argument. Elle retourne le dernier identifiant généré par la dernière fonction INSERT effectuée. </para> </refsect1> </refentry> <refentry id="function.mysql-list-dbs"> <refnamediv> <refname>mysql_list_dbs</refname> <refpurpose> Liste les bases de données disponibles sur le serveur MySQL. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_list_dbs</function></funcdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_list_dbs</function> retournera un identifiant de résultat, qui contiendra les noms des bases de données disponibles sur la connexion MySQL courante, ou bien sûr la connexion spécifiée par <parameter>link_identifier</parameter>. Utilisez la fonction <function>mysql_tablename</function> pour lire toutes les bases de données. </para> <para> Pour des raisons de compatibilité ascendante, mysql_listdbs() est encore disponible. </para> </refsect1> </refentry> <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> <refpurpose>Liste les champs du résultat MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_list_fields</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>string <parameter>table_name</parameter></paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_list_fields</function> recherche les informations relatives à la table <parameter>table_name</parameter> sur la connexion MySQL courante, ou bien sûr la connexion spécifiée par <parameter>link_identifier</parameter>. Les arguments sont la base de données et le nom de la table. Un pointeur de résultat est retourné et pourra être passé à <function>mysql_field_flags</function>, <function>mysql_field_len</function>, <function>mysql_field_name</function> et <function>mysql_field_type</function>. </para> <para> Un identifiant de résultat est un entier positif. La fonction retourne -1 si une erreur survient. Une chaîne décrivant le problème rencontré sera placée dans la variable <literal>$phperrmsg</literal> et, à moins que la fonction n'ait été appelée sous la forme <literal>@mysql()</literal>, cette erreur sera aussi affichée. </para> <para> Pour des raisons de compatibilité ascendante, mysql_listfields() est encore disponible. </para> </refsect1> </refentry> <refentry id="function.mysql-list-tables"> <refnamediv> <refname>mysql_list_tables</refname> <refpurpose>Liste les tables d'une base de données.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_list_tables</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_list_tables</function> prend le nom d'une base de données <parameter>database</parameter> et retourne un identifiant de résultat, qui contiendra la liste des tables sur la connexion MySQL courante, ou bien sûr la connexion spécifiée par <parameter>link_identifier</parameter>. La fonction <function>mysql_tablename</function> est le meilleur moyen d'extraire les noms des tables depuis l'identifiant de résultat. </para> <para> Pour des raisons de compatibilité ascendante, mysql_listtables() est encore disponible. </para> </refsect1> </refentry> <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> <refpurpose>Retourne le nombre de champs d'un résultat.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_num_fields</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_num_fields</function> retourne le nombre de champs du résultat <parameter>result_identifier</parameter>. </para> <para> Voir aussi <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function> et <function>mysql_num_rows</function>. </para> <para> Pour des raisons de compatibilité ascendante mysql_numfields() est encore disponible. </para> </refsect1> </refentry> <refentry id="function.mysql-num-rows"> <refnamediv> <refname>mysql_num_rows</refname> <refpurpose>Retourne le nombre de lignes d'un résultat.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_num_rows</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_num_rows</function> retourne le nombre de lignes d'un résultat. Cette commande n'est valide que pour les commandes SELECT . Pour connaître le nombre de lignes retournées par INSERT, UPDATE ou DELETE, utilisez <function>mysql_affected_rows</function>. </para> <example> <title> Exemple <function>mysql_num_rows</function> par crubel@trilizio.org </title> <programlisting role="php"><?php $conn = mysql_connect("adresse de l'hôte", "utilisateur", "mot de passe"); mysql_select_db("base",$conn); // nécessaire si vous avez plusieurs bases $Resultfornummembers = mysql_query("SELECT * FROM Accounts",$conn); $NumMembers = mysql_num_rows($Resultfornummembers); echo "$NumMembers Membres";?> </programlisting> </example> <para> Voir aussi <function>mysql_db_query</function>, <function>mysql_query</function> et <function>mysql_fetch_row</function>. </para> <para> Pour des raisons de compatibilité ascendante mysql_numrows() est encore disponible. </para> </refsect1> </refentry> <refentry id="function.mysql-pconnect"> <refnamediv> <refname>mysql_pconnect</refname> <refpurpose> Ouvre une connexion persistante à un serveur MySQL. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_pconnect</function></funcdef> <paramdef>string <parameter> <optional>hostname <optional>:port</optional> <optional>:/path/to/socket</optional> </optional> </parameter> </paramdef> <paramdef>string <parameter><optional>username</optional></parameter> </paramdef> <paramdef>string <parameter><optional>password</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_pconnect</function> retourne un lien persistant positif en cas de succès et sinon &false; en cas d'erreur. </para> <para> <function>mysql_pconnect</function> établit une connexion persistante à un serveur MySQL. Tous les arguments sont optionnels et des valeurs par défaut seront utilisér en cas d'omission ('<literal>localhost</literal>', nom d'utilisateur propriétaire du processus, mot de passe vide). </para> <para> Le nom de l'hôte peut aussi inclure le numéro de port, c'est-à-dire "hostname:port" ou un chemin jusqu'à la socket <literal>:/path/to/socket</literal> pour l'hôte local. <note> <para> Le support de ":port" a été ajouté à partir de la version 3.0B4. </para> <para> Le support de ":/path/to/socket" a été ajouté à partir de la version 3.0.10. </para> </note> </para> <para> <function>mysql_pconnect</function> se comporte exactement comme <function>mysql_connect</function>, mais avec deux différences majeures : </para> <para> Premièrement, lors de la connexion, la fonction essaie de trouver une connexion permanente déjà ouverte sur cet hôte, avec le même nom d'utilisateur et de mot de passe. Si une telle connexion est trouvée, son identifiant est retourné, sans ouvrir de nouvelle connexion. </para> <para> Deuxièmement, la connexion au serveur MySQL ne sera pas terminée avec la fin du script. Au lieu de cela, le lien sera conservé pour un prochain accès (<function>mysql_close</function> ne terminera pas une connexion persistante établie par <function>mysql_pconnect</function>). </para> <para> C'est pourquoi ce type de connexion est dite 'persistante'. </para> </refsect1> </refentry> <refentry id="function.mysql-unbuffered-query"> <refnamediv> <refname>mysql_unbuffered_query</refname> <refpurpose> Exécute une requête SQL sans mobiliser les résultats </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_unbuffered_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> <paramdef>int <parameter><optional>result_mode</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_unbuffered_query</function> envoie la requête SQL <parameter>query</parameter> au serveur MySQL identifié par <parameter>link_identifier</parameter>, sans préparer les résultats pour la lecture, comme le fait <function>mysql_query</function>. D'une part, cela réduit considérablement la consommation de mémoire par MySQL, lorsque les requêtes génère des résultats de grandes tailles. D'autre part, vous pourrez utiliser les résultats dès que la première ligne aura été lue : pas besoin d'attendre que la requête ait complètement été exécutée. </para> <note> <para> L'intérêt de <function>mysql_unbuffered_query</function> est tempéré par une limitation : <function>mysql_num_rows</function> ne fonctionne pas sur une ressource retournée par <function>mysql_unbuffered_query</function>. Vous devez aussi lire tous les résultats d'une première requête exécutée avec <function>mysql_unbuffered_query</function>, avant de pouvoir en exécuter une autre. </para> </note> <para> Voir aussi <function>mysql_query</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> <refpurpose>Envoie une requête SQL à un serveur MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>mysql_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_query</function> envoie une requête SQL à la base de données actuellement active sur le serveur MysQL. Si <parameter>link_identifier</parameter> n'est pas précisé, la dernière connexion est utilisée. Si aucune connexion n'a été ouverte, la fonction tentera d'en ouvrir une, avec la fonction <function>mysql_connect</function> mais sans aucun paramètre (c'est-à-dire avec les valeurs par défaut). </para> <para> <function>mysql_query</function> retourne &true; ou &false;, pour indiquer le succès ou l'échec de la requête. En cas de retour &true;, la requête était valide et a pu être exécuté sur le serveur. Cela n'indique pas le nombre de lignes affectées, ou retournées. Il est parfaitement possible qu'une requête valide n'affecte aucune ligne ou ne retourne aucune ligne. </para> <para> L'exemple suivant est syntaxiquement invalide, ce qui conduit <function>mysql_query</function> à l'échec et retourne &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"><?php $result = mysql_query ("SELECT * WHERE 1=1") or die ("Requête invalide");?> </programlisting> </example> </para> <para> L'exemple suivant est sémantiquement invalide si <literal>my_col</literal> n'est pas une colonne de la table <literal>my_tbl</literal>, ce qui conduit <function>mysql_query</function> à l'échec et retourne &false; : <example> <title><function>mysql_query</function></title> <programlisting role="php"><?php $result = mysql_query ("SELECT my_col FROM my_tbl") or die ("Requête invalide");?> </programlisting> </example> </para> <para> <function>mysql_query</function> échouera aussi et retournera aussi &false; si les droits d'accès ne sont pas suffisants. </para> <para> En supposant que la requête réussisse, vous pouvez appeler <function>mysql_affected_rows</function> pour connaître le nombre de lignes affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). Pour les commandes SELECT , <function>mysql_query</function> retourne un identifiant de résultat que vous pouvez passer à <function>mysql_result</function>. Lorsque vous avez terminé avec le résultat, libérez la mémoire avec <function>mysql_free_result</function>. </para> <para> Voir aussi <function>mysql_affected_rows</function>, <function>mysql_unbuffered_query</function>, <function>mysql_db_query</function>, <function>mysql_free_result</function>, <function>mysql_result</function>, <function>mysql_select_db</function> et <function>mysql_connect</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-result"> <refnamediv> <refname>mysql_result</refname> <refpurpose>Retourne un champs d'un résultat.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>mysql_result</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_result</function> retourne le contenu d'un champs dans le résultat MySQL <parameter>result_identifier</parameter>. L'argument <parameter>row</parameter> peut-être un offset de champs, ou le nom d'un champs, ou le nom de la table + point + le nom du champs ("table.champs"). Si la colonne a été aliasée, utilisez de préférence l'alias. </para> <para> Lorsque vous travaillez sur des résultats de grande taille, il est conseillé d'utiliser une des fonctions qui vont rechercher une ligne entière dans un tableau. Ces fonctions sont NETTEMENT plus rapides. De plus, utiliser un offset numériques est aussi beaucoup plus rapide que spécifier un nom littéral. </para> <para> Les appels <function>mysql_result</function> ne devraient pas être mélangés avec d'autres fonctions qui travaillent aussi sur le résultat. </para> <para> Alternatives à haut rendement, RECOMMANDEES : <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et <function>mysql_fetch_object</function>. </para> </refsect1> </refentry> <refentry id="function.mysql-select-db"> <refnamediv> <refname>mysql_select_db</refname> <refpurpose>Sélectionne une base de données MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_select_db</function> retourne &true; en cas de succès, &false; sinon. </para> <para> <function>mysql_select_db</function> change la base de données active sur la connexion représentée par <parameter>link_identifier</parameter>. Si aucun identifiant n'est spécifié, la dernière connexion est utilisée. S'il n'y a pas de dernière connexion, la fonction tentera de se connecter seule, avec <function>mysql_connect</function> et les paramètres par défaut. </para> <para> Toutes les requêtes suivantes avec <function>mysql_query</function> seront faites avec la base de données active. </para> <para> Voir aussi <function>mysql_connect</function>, <function>mysql_pconnect</function> et <function>mysql_query</function>. </para> <para> Pour des raisons de compatibilité ascendante mysql_selectdb() est encore disponible. </para> </refsect1> </refentry> <refentry id="function.mysql-tablename"> <refnamediv> <refname>mysql_tablename</refname> <refpurpose> Lit le nom de la table qui contient le champs spécifié. </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_tablename</function></funcdef> <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_tablename</function> prend le pointeur de résultat obtenu avec <function>mysql_list_tables</function> ou bien un index entier et retourne le nom de la table. La fonction <function>mysql_num_rows</function> peut être utilisée pour déterminer le nombre de tables dans le pointeur de résultat. <example> <title>Exemple <function>mysql_tablename</function></title> <programlisting role="php"><?php mysql_connect("localhost:3306"); $result = mysql_list_tables ("wisconsin"); $i = 0; while ($i < mysql_num_rows($result)) { $tb_names[$i] = mysql_tablename ($result, $i); echo $tb_names[$i] . "<br>"; $i++; }?> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.mysql-get-client-info"> <refnamediv> <refname>mysql_get_client_info</refname> <refpurpose>Lit les informations sur le client MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_get_client_info</function></funcdef> <paramdef>void <parameter></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_get_client_info</function> retourne une chaîne qui représente le numéro de version du client utilisé par PHP. </para> <para> <function>mysql_get_client_info</function> a été ajoutée en PHP 4.0.5. </para> </refsect1> </refentry> <refentry id="function.mysql-get-host-info"> <refnamediv> <refname>mysql_get_host_info</refname> <refpurpose>Lit les informations sur l'hôte MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_get_host_info</function></funcdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_get_host_info</function>retourne une chaîne qui représente le type de connexion utilisé avec la connexion <parameter>link_identifier</parameter>, y compris le nom du serveur hôte. Si <parameter>link_identifier</parameter> est omis, la dernière connexion ouverte est utilisée. </para> <para> <function>mysql_get_host_info</function> a été ajoutée en PHP 4.0.5. </para> </refsect1> </refentry> <refentry id="function.mysql-get-proto-info"> <refnamediv> <refname>mysql_get_proto_info</refname> <refpurpose>Lit les informations sur le protocole MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_get_proto_info</function></funcdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_get_proto_info</function> retourne une chaîne qui représente la version du protocole utilisé par la connexion <parameter>link_identifier</parameter>. Si <parameter>link_identifier</parameter> est omis, la dernière connexion ouverte est utilisée. </para> <para> <function>mysql_get_proto_info</function> a été ajoutée en PHP 4.0.5. </para> </refsect1> </refentry> <refentry id="function.mysql-get-server-info"> <refnamediv> <refname>mysql_get_server_info</refname> <refpurpose>Lit les informations sur le serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_get_server_info</function></funcdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mysql_get_server_info</function> retourne une chaîne qui représente la version du serveur, dont la connexion est Si <parameter>link_identifier</parameter> est omis, la dernière connexion ouverte est utilisée. </para> <para> <function>mysql_get_server_info</function> a été ajoutée en PHP 4.0.5. </para> </refsect1> </refentry> </reference>  \ No newline at end of file Index: phpdoc/fr/functions/pcntl.xml +++ phpdoc/fr/functions/pcntl.xml <?xml encoding="iso-8859-1"?>  <reference id="ref.pcntl"> <title>Contrôle des processus</title> <titleabbrev>PCNTL</titleabbrev> <partintro> <para> Le gestionnaire de contrôle des processus n'est pas activé par défaut. Il faut utiliser l'option de configuration <link linkend="install.configure.enable-pcntl">--enable-pcntl</link> lors de la compilation de PHP pour l'activer. </para> <para> La liste suivante rassemble tous les signaux qui sont actuellement supportés par les fonctions de gestion des processus de PHP. Reportez vous à votre manuel pour plus de détails sur les comportements de ces signaux. <table> <title>Signaux supportés</title> <tgroup cols="2"> <tbody> <row> <entry><literal>SIG_IGN</literal></entry> <entry><literal>SIGFPE</literal></entry> <entry><literal>SIGCONT</literal></entry> </row> <row> <entry><literal>SIG_DFL</literal></entry> <entry><literal>SIGKILL</literal></entry> <entry><literal>SIGSTOP</literal></entry> </row> <row> <entry><literal>SIG_ERR</literal></entry> <entry><literal>SIGUSR1</literal></entry> <entry><literal>SIGTSTP</literal></entry> </row> <row> <entry><literal>SIGHUP</literal></entry> <entry><literal>SIGUSR2</literal></entry> <entry><literal>SIGTTIN</literal></entry> </row> <row> <entry><literal>SIGINT</literal></entry> <entry><literal>SIGSEGV</literal></entry> <entry><literal>SIGTTOU</literal></entry> </row> <row> <entry><literal>SIGQUIT</literal></entry> <entry><literal>SIGPIPE</literal></entry> <entry><literal>SIGURG</literal></entry> </row> <row> <entry><literal>SIGILL</literal></entry> <entry><literal>SIGALRM</literal></entry> <entry><literal>SIGXCPU</literal></entry> </row> <row> <entry><literal>SIGTRAP</literal></entry> <entry><literal>SIGTERM</literal></entry> <entry><literal>SIGXFSZ</literal></entry> </row> <row> <entry><literal>SIGABRT</literal></entry> <entry><literal>SIGSTKFLT</literal></entry> <entry><literal>SIGVTALRM</literal></entry> </row> <row> <entry><literal>SIGIOT</literal></entry> <entry><literal>SIGCHLD</literal></entry> <entry><literal>SIGPROF</literal></entry> </row> <row> <entry><literal>SIGBUS</literal></entry> <entry><literal>SIGCLD</literal></entry> <entry><literal>SIGWINCH</literal></entry> </row> <row> <entry><literal>SIGPOLL</literal></entry> <entry><literal>SIGIO</literal></entry> <entry><literal>SIGPWR</literal></entry> </row> <row> <entry><literal>SIGSYS</literal></entry> <entry><literal></literal></entry> <entry><literal></literal></entry> </row> </tbody> </tgroup> </table> </para> <sect1 id="pcntl-example"> <title>Exemple de contrôle de processus</title> <para> Cet exemple effectue un fork du processus démon grâce à un gestionnaire de signaux. </para> <example> <title>Process Control Example</title> <programlisting role="php"> <?php $pid = pcntl_fork(); if ($pid == -1) { die("could not fork"); } else if ($pid) { exit(); // we are the parent } else { // we are the child } // detatch from the controlling terminal if (!posix_setsid()) { die("could not detach from terminal"); } // setup signal handlers pcntl_signal(SIGTERM, "sig_handler"); pcntl_signal(SIGHUP, "sig_handler"); // loop forever performing tasks while(1) { // do something interesting here } function sig_handler($signo) { switch($signo) { case SIGTERM: // handle shutdown tasks exit; break; case SIGHUP: // handle restart tasks break; default: // handle all other signals } } ?< </programlisting> </example> </sect1> </partintro> <refentry id="function.pcntl-fork"> <refnamediv> <refname>pcntl_fork</refname> <refpurpose>Forks the currently running process</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_fork</function></funcdef> <void/> </funcprototype> </funcsynopsis> <para> <function>pcntl_fork</function> crée un processus fils, qui ne diffère du processus père que par l'identifiant de processus et l'identifiant PPID. Reportez vous à la page de man fork(2) pour avoir des détails sur le comportement de cette fonction sur votre système. </para> <para> En cas de succès, le PID (identifiant de processus) du fils est retourné dans le processus père, et 0 est retourné dans le processus fils. En cas d'échec, -1 est retourné dans le contexte du père, aucun processu fils ne sera créé et PHP lèvera une erreur. </para> <para> Voir aussi <function>pcntl_waitpid</function> et <function>pcntl_signal</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-signal"> <refnamediv> <refname>pcntl_signal</refname> <refpurpose>Installe un gestionnaire de signaux</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>pcntl_signal</function></funcdef> <paramdef>int <parameter>signo</parameter></paramdef> <paramdef>mixed <parameter>handle</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>pcntl_signal</function> installe un nouveau gestionnaire de signaux opur le signal indiqué par le paramètre <parameter>signo</parameter>. Le gestionnaire de signaux est affecté à <parameter>handler</parameter> qui peut être le nom d'une fonction utilisateur, ou bien l'une des deux constantes globales <constant>SIG_IGN</constant> et <constant>SIG_DFL</constant>. </para> <para> <function>pcntl_signal</function> retourne &true; en cas de succès et &false; en cas d'échec. </para> <para> Voir aussi <function>pcntl_fork</function> et <function>pcntl_waitpid</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-waitpid"> <refnamediv> <refname>pcntl_waitpid</refname> <refpurpose>Attend la fin de l'exécution d'un processus fils</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_waitpid</function></funcdef> <paramdef>int <parameter>pid</parameter></paramdef> <paramdef>int <parameter>status</parameter></paramdef> <paramdef>int <parameter>options</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>pcntl_waitpid</function> suspend l'exécution du processus courant jusqu'à ce que un processus fils spécifié par le paramètre <parameter>pid</parameter> ait terminé, ou bien qu'un signal ait mis fin à ce processus ou qu'un signal ait appelé un gestionnaire de signaux. Si le processus fils identifié par <parameter>pid</parameter> est déjà terminé au moment de l'appel de cette fonction (on les appelle des processus "zombie"), la fonction se termine immédiatement. Toute ressource système utilisé par le processus fils est libérée. Reportez vous à la page de man waitpid(2) pour avoir des détails sur le comportement de cette fonction sur votre système. </para> <para> <function>pcntl_waitpid</function> retourne l'identifiant de processus du processus fils qui s'est terminé, ou bien -1 en cas d'erreur ou encore zéro si <constant>WNOHANG</constant> a été utilisée et qu'aucun processus fils n'était disponible. </para> <para> Le paramètre <parameter>pid</parameter> peut prendre l'une des valeurs suivantes : <table> <title>Valeurs possibles de <parameter>pid</parameter></title> <tgroup cols="2"> <tbody> <row> <entry><literal>< -1</literal></entry> <entry> attend que tous les processus fils dont l'identifiant de groupe est égal à la valeur absolue de <parameter>pid</parameter> soient terminés. </entry> </row> <row> <entry><literal>-1</literal></entry> <entry> attend que tous les processus fils soient terminés. Ceci est le même comportement que celui de la fonction <function>wait</function>. </entry> </row> <row> <entry><literal>0</literal></entry> <entry> attend que tous les processus fils dont l'identifiant de groupe est égal à celui du processus courant soient terminés. </entry> </row> <row> <entry><literal>> 0</literal></entry> <entry> attend que le processus fils dont l'identifiant est égal à <parameter>pid</parameter> soit terminé. </entry> </row> </tbody> </tgroup> </table> </para> <para> <function>pcntl_waitpid</function> enregistrera des informations sur le statut courant du processus dans le paramètre <parameter>status</parameter>, qui peut être accédé avec les fonctions suivantes : <function>pcntl_wifexited</function>, <function>pcntl_wifstopped</function>, <function>pcntl_wifsignaled</function>, <function>pcntl_wexitstatus</function>, <function>pcntl_wtermsig</function> et <function>pcntl_wstopsig</function>. </para> <para> Le paramètre <parameter>options</parameter> peut prendre la valeur de zéro, ou plusieurs des constantes globales suivantes (combinez les avec l'opérateur <literal>OR</literal>) : <table> <title>Valeurs possibles de <parameter>options</parameter></title> <tgroup cols="2"> <tbody> <row> <entry><literal>WNOHANG</literal></entry> <entry> retourne immédiatement si aucun processus fils ne s'est terminé. </entry> </row> <row> <entry><literal>WUNTRACED</literal></entry> <entry> retourne lorsque les processus fils sont arrêtés et que leur status n'a pas été mis à jour. </entry> </row> </tbody> </tgroup> </table> </para> <para> Voir aussi <function>pcntl_fork</function>, <function>pcntl_signal</function>, <function>pcntl_wifexited</function>, <function>pcntl_wifstopped</function>, <function>pcntl_wifsignaled</function>, <function>pcntl_wexitstatus</function>, <function>pcntl_wtermsig</function> et <function>pcntl_wstopsig</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-wexitstatus"> <refnamediv> <refname>pcntl_wexitstatus</refname> <refpurpose> Retourne le code d'un processus fils terminé </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_wexitstatus</function></funcdef> <paramdef>int <parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>pcntl_wexitstatus</function> retourne le code de retour du processus fils. Cette fonction n'est utile que si la fonction <function>pcntl_wifexited</function> a retourné &true;. </para> <para> Le paramètre <parameter>status</parameter> est le paramètre fourni à la fonction <function>pcntl_waitpid</function>, qui avait réussi. </para> <para> Voir aussi <function>pcntl_waitpid</function> et <function>pcntl_wifexited</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-wifexited"> <refnamediv> <refname>pcntl_wifexited</refname> <refpurpose> Retourne &true; si le code de retour représente une fin normale </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_wifexited</function></funcdef> <paramdef>int <parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>pcntl_wifexited</function> retourne &true; si le processus fils a retourné un code qui représente une fin normale. </para> <para> Le paramètre <parameter>status</parameter> est le paramètre fourni à la fonction <function>pcntl_waitpid</function>, qui avait réussi. </para> <para> Voir aussi <function>pcntl_waitpid</function> et <function>pcntl_wexitstatus</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-wifsignaled"> <refnamediv> <refname>pcntl_wifsignaled</refname> <refpurpose> Returns &true; if status code represents a termination due to a signal </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_wifsignaled</function></funcdef> <paramdef>int <parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Returns &true; if the child process exited because of a signal which was not caught. </para> <para> Le paramètre <parameter>status</parameter> est le paramètre fourni à la fonction <function>pcntl_waitpid</function>, qui avait réussi. </para> <para> Voir aussi <function>pcntl_waitpid</function> et <function>pcntl_signal</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-wifstopped"> <refnamediv> <refname>pcntl_wifstopped</refname> <refpurpose> Returns &true; if child process is currently stopped </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_wifstopped</function></funcdef> <paramdef>int <parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Returns &true; if the child process which caused the return is currently stopped; this is only possible if the call to <function>pcntl_waitpid</function> was done using the option <literal>WUNTRACED</literal>. </para> <para> Le paramètre <parameter>status</parameter> est le paramètre fourni à la fonction <function>pcntl_waitpid</function>, qui avait réussi. </para> <para> Voir aussi <function>pcntl_waitpid</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-wstopsig"> <refnamediv> <refname>pcntl_wstopsig</refname> <refpurpose> Returns the signal which caused the child to stop </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_wstopsig</function></funcdef> <paramdef>int <parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Returns the number of the signal which caused the child to stop. This function is only useful if <function>pcntl_wifstopped</function> returned &true;. </para> <para> Le paramètre <parameter>status</parameter> est le paramètre fourni à la fonction <function>pcntl_waitpid</function>, qui avait réussi. </para> <para> Voir aussi <function>pcntl_waitpid</function> et <function>pcntl_wifstopped</function>. </para> </refsect1> </refentry> <refentry id="function.pcntl-wtermsig"> <refnamediv> <refname>pcntl_wtermsig</refname> <refpurpose> Returns the signal which caused the child to terminate </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> <funcdef>int <function>pcntl_wtermsig</function></funcdef> <paramdef>int <parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Returns the number of the signal that caused the child process to terminate. This function is only useful if <function>pcntl_wifsignaled</function> returned &true;. </para> <para> Le paramètre <parameter>status</parameter> est le paramètre fourni à la fonction <function>pcntl_waitpid</function>, qui avait réussi. </para> <para> Voir aussi <function>pcntl_waitpid</function>, <function>pcntl_signal</function> et <function>pcntl_wifsignaled</function>. </para> </refsect1> </refentry> </reference>