cvs: phpdoc-fr /reference/mysql reference.xml /reference/mysql/functions mysql-change-user.xml mysql-close.xml mysql-connect.xml mysql-create-db.xml
mysql-data-seek.xml mysql-db-name.xml mysql-db-query.xml mysql-drop-db.xml mysql-fetch-array.xml mysql-fetch-assoc.xml mysql-fetch-field.xml
mysql-fetch-lengths.xml mysql-fetch-object.xml mysql-fetch-row.xml mysql-field-flags.xml mysql-field-len.xml mysql-field-name.xml mysql-field-seek.xml
mysql-field-table.xml mysql-field-type.xml mysql-free-result.xml mysql-get-client-info.xml mysql-get-proto-info.xml mysql-list-dbs.xml
mysql-list-fields.xml mysql-list-tables.xml mysql-num-fields.xml mysql-num-rows.xml mysql-pconnect.xml mysql-query.xml mysql-result.xml
mysql-select-db.xml mysql-tablename.xml
| From: | Damien Seguy | Date: | Fri, 07 Feb 2003 18:10:11 +0000 |
| Subject: | cvs: phpdoc-fr /reference/mysql reference.xml /reference/mysql/functions mysql-change-user.xml mysql-close.xml mysql-connect.xml mysql-create-db.xml mysql-data-seek.xml mysql-db-name.xml mysql-db-query.xml mysql-drop-db.xml mysql-fetch-array.xml mysql-fetch-assoc.xml mysql-fetch-field.xml mysql-fetch-lengths.xml mysql-fetch-object.xml mysql-fetch-row.xml mysql-field-flags.xml mysql-field-len.xml mysql-field-name.xml mysql-field-seek.xml mysql-field-table.xml mysql-field-type.xml mysql-free-result.xml mysql-get-client-info.xml mysql-get-proto-info.xml mysql-list-dbs.xml mysql-list-fields.xml mysql-list-tables.xml mysql-num-fields.xml mysql-num-rows.xml mysql-pconnect.xml mysql-query.xml mysql-result.xml mysql-select-db.xml mysql-tablename.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-239@lists.php.net to get a copy of this message | ||
dams Fri Feb 7 13:10:11 2003 EDT
Modified files:
/phpdoc-fr/reference/mysql reference.xml
/phpdoc-fr/reference/mysql/functions mysql-change-user.xml
mysql-close.xml
mysql-connect.xml
mysql-create-db.xml
mysql-data-seek.xml
mysql-db-name.xml
mysql-db-query.xml
mysql-drop-db.xml
mysql-fetch-array.xml
mysql-fetch-assoc.xml
mysql-fetch-field.xml
mysql-fetch-lengths.xml
mysql-fetch-object.xml
mysql-fetch-row.xml
mysql-field-flags.xml
mysql-field-len.xml
mysql-field-name.xml
mysql-field-seek.xml
mysql-field-table.xml
mysql-field-type.xml
mysql-free-result.xml
mysql-get-client-info.xml
mysql-get-proto-info.xml
mysql-list-dbs.xml
mysql-list-fields.xml
mysql-list-tables.xml
mysql-num-fields.xml
mysql-num-rows.xml
mysql-pconnect.xml
mysql-query.xml
mysql-result.xml
mysql-select-db.xml
mysql-tablename.xml
Log:
Keeping up
Index: phpdoc-fr/reference/mysql/reference.xml diff -u phpdoc-fr/reference/mysql/reference.xml:1.3 phpdoc-fr/reference/mysql/reference.xml:1.4 --- phpdoc-fr/reference/mysql/reference.xml:1.3 Thu Feb 6 17:58:09 2003 +++ phpdoc-fr/reference/mysql/reference.xml Fri Feb 7 13:10:10 2003 @@ -1,66 +1,90 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<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 disponibles à - <ulink url="&url.mysql;">&url.mysql;</ulink>. - </simpara> - <simpara> - La documentation de MySQL est disponible à <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> +<!-- $Revision: 1.4 $ --> + <reference id="ref.mysql"> + <title>MySQL</title> + <titleabbrev>MySQL</titleabbrev> + + <partintro> + <section id="mysql.intro"> + &reftitle.intro; + <para> + Ces fonctions vous permettent d'accéder aux bases de données + MySQL. Le site officiel de cette base est + <ulink url="&url.mysql;">&url.mysql;</ulink>. + </para> + <para> + La documentation de MySQL est disponible à + <ulink url="&url.mysql.docs;">&url.mysql.docs;</ulink>. + </para> + </section> + + <section id="mysql.requirements"> + &reftitle.required; + <para> + Afin de pouvoir les utiliser, vous devez compiler PHP avec le support + MySQL. + </para> + </section> + + &reference.mysql.configure; + + &reference.mysql.ini; + + <section id="mysql.resources"> + &reftitle.resources; + <para> + There are two resource types used in the MySQL module. The first one + is the link identifier for a database connection, the second a resource + which holds the result of a query. + </para> + </section> + + &reference.mysql.constants; + + <section id="mysql.examples"> + &reftitle.examples; + <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"; + <example> + <title>Exemple de présentation de l'extension MySQL</title> + <programlisting role="php"> +<![CDATA[ +<?php + /* Connexion et sélection de la base */ + $link = mysql_connect("mysql_host", "mysql_user", "mysql_password") + or die("Could not connect"); + print "Connected successfully"; + mysql_select_db("my_database") or die("Could not select database"); + + /* Exécuter des requêtes SQL */ + $query = "SELECT * FROM my_table"; + $result = mysql_query($query) or die("Query failed"); + + /* Afficher des résultats en HTML */ + print "<table>\n"; + while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) { + print "\t<tr>\n"; + foreach ($line as $col_value) { + print "\t\t<td>$col_value</td>\n"; + } + print "\t</tr>\n"; } - print "\t</tr>\n"; - } - print "</table>\n"; - mysql_close($link); -?> - </programlisting> - </example> - </para> - </partintro> + print "</table>\n"; + + /* Libération des résultats */ + mysql_free_result($result); + + /* Fermeture de la connexion */ + mysql_close($link); +?> +]]> + </programlisting> + </example> + </para> + </section> + </partintro> &reference.mysql.functions; Index: phpdoc-fr/reference/mysql/functions/mysql-change-user.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-change-user.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-change-user.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-change-user.xml:1.1 Sun Apr 14 20:34:05 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-change-user.xml Fri Feb 7 13:10:11 2003 @@ -4,9 +4,7 @@ <refentry id="function.mysql-change-user"> <refnamediv> <refname>mysql_change_user</refname> - <refpurpose> - Change le nom de session de l'utilisateur actif. - </refpurpose> + <refpurpose>Change le nom de session de l'utilisateur actif</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,12 +12,8 @@ <type>int</type><methodname>mysql_change_user</methodname> <methodparam><type>string</type><parameter>user</parameter></methodparam> <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - database - </parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter> - link_identifier - </parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> <function>mysql_change_user</function> change l'utilisateur de la session @@ -29,11 +23,15 @@ défaut de l'utilisateur. Si une erreur de connexion survient, la connexion en cours restera active. </para> + <para> + &return.success; + </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> + </para> + </note> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-close.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-close.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-close.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-close.xml:1.1 Sun Apr 14 20:34:05 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-close.xml Fri Feb 7 13:10:11 2003 @@ -4,26 +4,25 @@ <refentry id="function.mysql-close"> <refnamediv> <refname>mysql_close</refname> - <refpurpose>Ferme la connexion MySQL.</refpurpose> + <refpurpose>Ferme la connexion MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>mysql_close</methodname> + <type>bool</type><methodname>mysql_close</methodname> <methodparam choice="opt"><type>resource</type><parameter> link_identifier </parameter></methodparam> </methodsynopsis> <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> + <para> + &return.success; + </para> <note> <para> Notez que cette commande n'est pas nécessaire, car toutes les connexions non @@ -37,13 +36,15 @@ <example> <title>Exemple MySQL_close</title> <programlisting role="php"> -<?php - $link = mysql_connect("kraemer", "marliesle", "secret") { +<![CDATA[ +<?php + $link = mysql_connect("serveur.mysql.com", "utilisateur", "secret") or die("Impossible de se connecter"); - } + print("Connexion réussie"); mysql_close($link); -?> +?> +]]> </programlisting> </example> <para> Index: phpdoc-fr/reference/mysql/functions/mysql-connect.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-connect.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-connect.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-connect.xml:1.1 Sun Apr 14 20:34:05 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-connect.xml Fri Feb 7 13:10:11 2003 @@ -4,25 +4,21 @@ <refentry id="function.mysql-connect"> <refnamediv> <refname>mysql_connect</refname> - <refpurpose>Ouvre une connexion à un serveur MySQL.</refpurpose> + <refpurpose>Ouvre une connexion à un serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_connect</methodname> - <methodparam choice="opt"><type>string</type><parameter> - server - </parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - username - </parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - password - </parameter></methodparam> + <type>resource</type><methodname>mysql_connect</methodname> + <methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>new_link</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_connect</function> retourne un identifiant positif de - connexion en cas de succès, et sinon &false;. + <function>mysql_connect</function> retourne une ressource de connexion + au serveur MySQL en cas de succès, et sinon &false;. </para> <para> <function>mysql_connect</function> établit une connexion à @@ -52,21 +48,40 @@ 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. + Le paramètre <parameter>new_link</parameter> modifie ce comportement et permet + que <function>mysql_connect</function> ouvre une nouvelle connexion + même si <function>mysql_connect</function> a été appelée auparavant + avec les mêmes paramètres. Le paramètre <parameter>client_flags</parameter> + peut être une combinaison des constantes suivantes : + <constant>MYSQL_CLIENT_SSL</constant>, <constant>MYSQL_CLIENT_COMPRESS</constant>, + <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> et <constant>MYSQL_CLIENT_INTERACTIVE</constant>. </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>. + <note> + <para> + La paramètre <parameter>new_link</parameter> a été ajouté en + &php; 4.2.0. + </para> + <para> + La paramètre <parameter>client_flags</parameter> a été ajouté en + &php; 4.3.0 + </para> + </note> <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> + <title>Exemple avec <function>mysql_connect</function></title> <programlisting role="php"> -<?php - $link = mysql_connect("kraemer", "marliesle", "secret") { - or die("Connexion impossible"); - } - print("Connexion réussie"); - mysql_close($link); -?> +<![CDATA[ +<?php + $link = mysql_connect("localhost", "mysql_user", "mysql_password") + or die("Impossible de se connecter : " . mysql_error()); + print ("Connexion réussie."); + mysql_close($link); +?> +]]> </programlisting> </example> <para> Index: phpdoc-fr/reference/mysql/functions/mysql-create-db.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-create-db.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-create-db.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-create-db.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-create-db.xml Fri Feb 7 13:10:11 2003 @@ -4,15 +4,15 @@ <refentry id="function.mysql-create-db"> <refnamediv> <refname>mysql_create_db</refname> - <refpurpose>Crée une base de données MySQL.</refpurpose> + <refpurpose>Crée une base de données MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_create_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <type>bool</type><methodname>mysql_create_db</methodname> + <methodparam><type>string</type><parameter>database name</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter> - link_identifier + link_identifier </parameter></methodparam> </methodsynopsis> <para> @@ -22,10 +22,16 @@ <parameter>link_identifier</parameter>, ou sur la dernière connexion ouverte. </para> + <para> + &return.success; + </para> <example> - <title>Exemple de création de base MySQL</title> + <title> + Exemple de création de base MySQL avec <function>mysql_create_db</function> + </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } @@ -34,16 +40,25 @@ } 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> + <note> + <para> + La fonction <function>mysql_create_db</function> est obsolète. Il + est préférable d'utiliser la fonction <function>mysql_query</function>, + avec une commande SQL "CREATE DATABASE". + </para> + </note> <para> Voir aussi - <function>mysql_drop_db</function>. + <function>mysql_drop_db</function> et + <function>mysql_query</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml Fri Feb 7 13:10:11 2003 @@ -4,20 +4,16 @@ <refentry id="function.mysql-data-seek"> <refnamediv> <refname>mysql_data_seek</refname> - <refpurpose>Déplace le pointeur interne de résultat.</refpurpose> + <refpurpose>Déplace le pointeur interne de résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_data_seek</methodname> + <type>bool</type><methodname>mysql_data_seek</methodname> <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> <methodparam><type>int</type><parameter>row_number</parameter></methodparam> </methodsynopsis> <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>. @@ -26,12 +22,25 @@ retournera cette ligne. </para> <para> - <parameter>row_number</parameter> commence à 0. + &return.success; + </para> + <para> + <parameter>row_number</parameter> commence à 0. + <parameter>row_number</parameter> doit être une valeur qui + va de 0 à <function>mysql_num_rows</function> - 1. </para> + <note> + <para> + La fonction <function>mysql_data_seek</function> peut être utilisée + en conjonction avec <function>mysql_query</function>, mais pas + avec la fonction <function>mysql_unbuffered_query</function>. + </para> + </note> <example> <title>Exemple <function>mysql_data_seek</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } @@ -53,9 +62,15 @@ echo "{$row->last_name} {$row->last_name$row->first_name}<br>\n"; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>mysql_query</function> et + <function>mysql_num_rows</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-db-name.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-db-name.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-db-name.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-db-name.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-db-name.xml Fri Feb 7 13:10:11 2003 @@ -9,12 +9,10 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_db_name</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <type>string</type><methodname>mysql_db_name</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>row</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter> - field - </parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> </methodsynopsis> <para> <function>mysql_db_name</function> prend comme premier argument @@ -30,7 +28,8 @@ <example> <title>Exemple <function>mysql_db_name</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php error_reporting(E_ALL); mysql_connect('dbhost', 'username', 'password'); $db_list = mysql_list_dbs(); @@ -40,7 +39,8 @@ echo mysql_db_name($db_list, $i) . "\n"; $i++; } -?> +?> +]]> </programlisting> </example> <para> Index: phpdoc-fr/reference/mysql/functions/mysql-db-query.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-db-query.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-db-query.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-db-query.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-db-query.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-db-query"> <refnamediv> <refname>mysql_db_query</refname> - <refpurpose>Envoie une requête MySQL à un serveur MySQL.</refpurpose> + <refpurpose>Envoie une requête MySQL à un serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml Fri Feb 7 13:10:11 2003 @@ -4,25 +4,24 @@ <refentry id="function.mysql-drop-db"> <refnamediv> <refname>mysql_drop_db</refname> - <refpurpose>Efface une base de données MySQL.</refpurpose> + <refpurpose>Efface une base de données MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>mysql_drop_db</methodname> + <type>bool</type><methodname>mysql_drop_db</methodname> <methodparam><type>string</type><parameter>database_name</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter> link_identifier </parameter></methodparam> </methodsynopsis> <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> + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml:1.1 Sun Apr 14 20:34:07 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml Fri Feb 7 13:10:11 2003 @@ -13,10 +13,8 @@ <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_array</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - result_type - </parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> </methodsynopsis> <para> <function>mysql_fetch_array</function> retourne un tableau qui @@ -36,11 +34,14 @@ 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> + <example> + <title>Requête avec duplication de nom de colonnes</title> <programlisting role="sql"> -select t1.f1 as foo t2.f1 as bar from t1, t2 +<![CDATA[ + select table1.field as foo table2.field as bar from table1, table2 +]]> </programlisting> - </informalexample> + </example> </para> <para> Il est important de souligner que <function>mysql_fetch_array</function> N'est PAS @@ -50,26 +51,84 @@ <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. + valeurs suivantes : <constant>MYSQL_ASSOC</constant>, + <constant>MYSQL_NUM</constant> et <constant>MYSQL_BOTH</constant>.Cette + fonctionnalité a été ajoutée en &php; 3.0.7. <constant>MYSQL_BOTH</constant> + est la valeur par défaut de cet argument. </para> <para> - Voir aussi - <function>mysql_fetch_row</function>. + En utilisant <constant>MYSQL_BOTH</constant>, vos obtiendrez un tableau + qui sera à la fois associatif et indexé numériquement. En utilisant + <constant>MYSQL_ASSOC</constant>, vous obtiendrez un tableau + associatif (tout comme le fait <function>mysql_fetch_assoc</function>), + et en utilisant <constant>MYSQL_NUM</constant>, vous obtiendrez un tableau + indexé nuériquement (comme le fait <function>mysql_fetch_row</function>). </para> <example> - <title>mysql fetch array</title> + <title>Exemple de <function>mysql_fetch_array</function> avec <constant>MYSQL_NUM</constant></title> + <programlisting role="php"> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + mysql_select_db("mydb"); + + $result = mysql_query("SELECT id, name FROM mytable"); + + while ($row = mysql_fetch_array($result, MYSQL_NUM)) { + printf ("ID: %s Name: %s", $row[0], $row[1]); + } + + mysql_free_result($result); +?> +]]> + </programlisting> + </example> + <example> + <title>Exemple de <function>mysql_fetch_array</function> avec <constant>MYSQL_ASSOC</constant></title> + <programlisting role="php"> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + mysql_select_db("mydb"); + + $result = mysql_query("SELECT id, name FROM mytable"); + + while ($row = mysql_fetch_array($result, MYSQL_ASSOC)) { + printf ("ID: %s Name: %s", $row["id"], $row["name"]); + } + + mysql_free_result($result); +?> +]]> + </programlisting> + </example> + <example> + <title>Exemple de <function>mysql_fetch_array</function> avec <constant>MYSQL_BOTH</constant></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); -?> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + mysql_select_db("mydb"); + + $result = mysql_query("SELECT id, name FROM mytable"); + + while ($row = mysql_fetch_array($result, MYSQL_BOTH)) { + printf ("ID: %s Name: %s", $row[0], $row["name"]); + } + + mysql_free_result($result); +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>mysql_fetch_row</function> et + <function>mysql_fetch_assoc</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml Fri Feb 7 13:10:11 2003 @@ -12,12 +12,12 @@ <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_assoc</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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. + qui contient la ligne lue dans le résultat <parameter>result</parameter>, + ou bien &false;, s'il ne reste plus de lignes à lire. </para> <para> <function>mysql_fetch_assoc</function> est équivalente à @@ -43,19 +43,62 @@ <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. </para> <example> - <title><function>mysql_fetch_assoc</function></title> + <title>Exemple avec <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); -?> +<![CDATA[ +<?php + $conn = mysql_connect("localhost", "mysql_user", "mysql_password"); + + if (!$conn) { + echo "Impossible de se connecter à la base de données : " . mysql_error(); + exit; + } + + if (!mysql_select_db("mydbname")) { + echo "Impossible d'accéder à la base de données : " . mysql_error(); + exit; + } + + $sql = "SELECT id as userid, fullname, userstatus + FROM sometable + WHERE userstatus = 1"; + + $result = mysql_query($sql); + + if (!$result) { + echo "Impossible d'exécuter la requête ($sql) dans la base : " . mysql_error(); + exit; + } + + if (mysql_num_rows($result) == 0) { + echo "Aucune ligne trouvées, rien à afficher."; + exit; + } + + // Tant qu'une ligne existe, place cette ligne dans la variable $row + // sous la forme d'un tableau associatif. + // Note : Si vous n'attendez qu'une seule ligne, oubliez la boucle + // Note : Si vous utilisez extract($row); dans la boucle suivante + // vous créerez then create $userid, $fullname, and $userstatus + while ($row = mysql_fetch_assoc($result)) { + echo $row["userid"]; + echo $row["fullname"]; + echo $row["userstatus"]; + } + + mysql_free_result($result); + +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>mysql_fetch_row</function>, + <function>mysql_fetch_array</function>, + <function>mysql_query</function> et + <function>mysql_error</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml Fri Feb 7 13:10:11 2003 @@ -13,14 +13,12 @@ <title>Description</title> <methodsynopsis> <type>object</type><methodname>mysql_fetch_field</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - field_offset - </parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> <function>mysql_fetch_field</function> retourne un objet contenant - les données, lu dans le résultat <parameter>result_identifier</parameter>. + les données, lu dans le résultat <parameter>result</parameter>. </para> <para> <function>mysql_fetch_field</function> sert à obtenir des @@ -94,6 +92,45 @@ </listitem> </itemizedlist> </para> + <example> + <title>Exemple avec <function>mysql_fetch_field</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +mysql_connect('localhost:3306', $user, $password) + or die("Impossible de se connecter : " . mysql_error()); +mysql_select_db("database"); +$result = mysql_query("select * from table") + or die("Query failed: " . mysql_error()); +/* Lecture des méta données de la colonne */ +$i = 0; +while ($i < mysql_num_fields($result)) { + echo "Détails sur la colonne $i :<br />\n"; + $meta = mysql_fetch_field($result); + if (!$meta) { + echo "Aucun détail disponible<br />\n"; + } + echo "<pre> +blob: $meta->blob +max_length: $meta->max_length +multiple_key: $meta->multiple_key +name: $meta->name +not_null: $meta->not_null +numeric: $meta->numeric +primary_key: $meta->primary_key +table: $meta->table +type: $meta->type +unique_key: $meta->unique_key +unsigned: $meta->unsigned +zerofill: $meta->zerofill +</pre>"; + $i++; +} +mysql_free_result($result); +?> +]]> + </programlisting> + </example> <para> Voir aussi <function>mysql_field_seek</function>. Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml Fri Feb 7 13:10:11 2003 @@ -5,26 +5,28 @@ <refnamediv> <refname>mysql_fetch_lengths</refname> <refpurpose> - Retourne la taille de chaque colonne d'une ligne de résultat. + Retourne la taille de chaque colonne d'une ligne de résultat </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_lengths</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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;. + par <function>mysql_fetch_row</function>, et lue dans le résultat + <parameter>result</parameter>, 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>, + 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. + position 0. </para> <para> Voir aussi Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml Fri Feb 7 13:10:11 2003 @@ -4,21 +4,18 @@ <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> + <refpurpose>Retourne une ligne de résultat MySQL sous la forme d'un objet</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>object</type><methodname>mysql_fetch_object</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - result_type - </parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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 + propriétés correspondent à une ligne du + résultat <parameter>result</parameter>, ou &false; si il n'y a plus d'autres lignes. </para> <para> @@ -30,6 +27,20 @@ nombres ne sont pas des noms MySQL). </para> <para> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Ceci est valide */ +echo $row->field; +/* Ceci est invalide */ +echo $row->0; + +?> +]]> + </programlisting> + </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> @@ -39,17 +50,20 @@ aussi rapide que <function>mysql_fetch_row</function> (la différence est insignifiante) <example> - <title>mysql fetch object</title> + <title>Exemple avec <function>mysql_fetch_object</function></title> <programlisting role="php"> -<?php - mysql_connect($host,$user,$password); - $result = mysql_db_query("database","select * from table"); - while($row = mysql_fetch_object($result)) { +<![CDATA[ +<?php +mysql_connect("hostname", "user", "password"); +mysql_select_db($db); +$result = mysql_query("select * from table"); +while ($row = mysql_fetch_object($result)) { echo $row->user_id; echo $row->fullname; - } - mysql_free_result($result); -?> +} +mysql_free_result($result); +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml Fri Feb 7 13:10:11 2003 @@ -4,18 +4,19 @@ <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> + <refpurpose>Retourne une ligne de résultat MySQL sous la forme d'un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_row</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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. + indexé numériquement, qui correspond à la prochaine ligne + du résultat MySQL <parameter>result</parameter>, ou bien &false; + s'il ne reste plus de ligne. </para> <para> <function>mysql_fetch_row</function> va rechercher une ligne dans le Index: phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml Fri Feb 7 13:10:11 2003 @@ -5,15 +5,14 @@ <refnamediv> <refname>mysql_field_flags</refname> <refpurpose> - Retourne le sémaphore associé à la colonne - spécifiée dans le résultat courant. + Retourne des détails sur une colonne MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_flags</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> @@ -25,8 +24,9 @@ </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". + 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() Index: phpdoc-fr/reference/mysql/functions/mysql-field-len.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-len.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-len.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-len.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-len.xml Fri Feb 7 13:10:11 2003 @@ -4,20 +4,19 @@ <refentry id="function.mysql-field-len"> <refnamediv> <refname>mysql_field_len</refname> - <refpurpose> - Retourne la longueur du champs spécifié. - </refpurpose> + <refpurpose>Retourne la taille d'un champs de résultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_field_len</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> <function>mysql_field_len</function> retourne la taille du champs - spécifié par son offset <parameter>field_offset</parameter>. + <parameter>field_offset</parameter>-ième champs dans le résultat + <parameter>result</parameter>. Les champs sont indexés à partir de 0. </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldlen() Index: phpdoc-fr/reference/mysql/functions/mysql-field-name.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-name.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-name.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-name.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-name.xml Fri Feb 7 13:10:11 2003 @@ -12,19 +12,54 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_name</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_index</parameter></methodparam> </methodsynopsis> <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>. + <function>mysql_field_name</function> retourne le nom de la + <parameter>field_index</parameter>-ième colonne du résulat MySQL + <parameter>result</parameter>. <parameter>result</parameter> doit + être une ressource de résultat MySQL et <parameter>field_index</parameter> + est un offset numérique du champs. </para> + <note> + <para> + <parameter>field_index</parameter> commence à 0. + </para> + <para> + e.g. L'index du troisième champs sera en fait l'offset 2, + et l'index du quatrième champs sera en fait l'offset 3, etc.... + </para> + </note> <para> - <function>mysql_field_name</function> retournera le nom du - deuxième champs dans le résultat associé - à $result. + <example> + <title>Exemple avec <function>mysql_field_name</function></title> + <programlisting role="php"> +<![CDATA[ +/* Supposons que la table utilisée contienne trois champs : + * user_id + * username + * password. + */ +$link = mysql_connect('localhost', "mysql_user", "mysql_password"); +mysql_select_db($dbname, $link) + or die("Impossible de se connecter à la base $dbname : " . mysql_error()); +$res = mysql_query("select * from users", $link); + +echo mysql_field_name($res, 0) . "\n"; +echo mysql_field_name($res, 2); +]]> + </programlisting> + <para> + L'exemple ci-dessus va afficher : + <screen> +<![CDATA[ +user_id +password +]]> + </screen> + </para> + </example> </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldname() Index: phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml Fri Feb 7 13:10:11 2003 @@ -12,13 +12,14 @@ <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_field_seek</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <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é. + 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 Index: phpdoc-fr/reference/mysql/functions/mysql-field-table.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-table.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-table.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-table.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-table.xml Fri Feb 7 13:10:11 2003 @@ -12,13 +12,18 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_table</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> <function>mysql_field_table</function> retourne le nom de la table - où se trouve une colonne. Pour des raisons de compatibilité + où se trouve la colonne d'offset <parameter>field_offset</parameter>, + dans le résultat MySQL <parameter>result</parameter>. + </para> + <para> + Pour des raisons de compatibilité ascendante, mysql_fieldtable() peut encore être utilisé. + Toutes fois, elle est obsolète. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-field-type.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-type.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-type.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-type.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-type.xml Fri Feb 7 13:10:11 2003 @@ -4,51 +4,64 @@ <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> + <refpurpose>Retourne le type de la colonne courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_type</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <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. + <function>mysql_field_name</function>. Les arguments sont identiques : c'est + le type du champs qui est retourné. Il vaudra + "int", "real", "string", "blob" ou d'autres, comme détaillé + <ulink url="&url.mysql.docs;">dans la documentation MySQL</ulink>. <example> - <title>Types mysql field</title> + <title>Types MySQL</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(); -?> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_utilisateur", "mysql_mot_de_passe"); + mysql_select_db("mysql"); + $result = mysql_query("SELECT * FROM func"); + $fields = mysql_num_fields($result); + $rows = mysql_num_rows($result); + $table = mysql_field_table($result, 0); + echo "Votre table '".$table."' dispose de ".$fields." colonnes et ".$rows." ligne(s)\n"; + echo "Les colonnes sont les suivantes : \n"; + for ($i=0; $i < $fields; $i++) { + $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."\n"; + } + mysql_free_result($result); + mysql_close(); +?> +]]> </programlisting> </example> </para> <para> + L'exemple ci-dessus produit l'affichage suivant : + <screen> +<![CDATA[ +Votre table 'func' dispose de 4 colonnes et 1 ligne(s) +Les colonnes sont les suivantes : +string name 64 not_null primary_key binary +int ret 1 not_null +string dl 128 not_null +string type 9 not_null enum +]]> + </screen> + </para> + <para> Pour des raisons de compatibilité ascendante, mysql_fieldtype() - peut encore être utilisé. + peut encore être utilisé. Toutes fois, elle est obsolète. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-free-result.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-free-result.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-free-result.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-free-result.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-free-result.xml Fri Feb 7 13:10:11 2003 @@ -4,19 +4,26 @@ <refentry id="function.mysql-free-result"> <refnamediv> <refname>mysql_free_result</refname> - <refpurpose>Efface le résultat de la mémoire.</refpurpose> + <refpurpose>Efface le résultat de la mémoire</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_free_result</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <type>bool</type><methodname>mysql_free_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> + <function>mysql_free_result</function> libère toute la mémoire et + les ressources utilisées par la ressource de résultat <parameter>result</parameter>. + </para> + <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> + &return.success; </para> <para> Pour des raisons de compatibilité ascendante, mysql_freeresult() Index: phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml Fri Feb 7 13:10:11 2003 @@ -10,14 +10,35 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_get_client_info</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <void/> </methodsynopsis> <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> + <example> + <title>Exemple avec <function>mysql_get_client_info</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + printf ("Détails sur le client MySQL : %s\n", mysql_get_client_info()); +?> +]]> + </programlisting> + <para> + L'exemple ci-dessus pourrait afficher par exemple : + </para> + <screen> +<![CDATA[ +Détails sur le client MySQL : 3.23.39 +]]> + </screen> + </example> <para> - <function>mysql_get_client_info</function> a été ajoutée en PHP 4.0.5. + Voir aussi + <function>mysql_get_host_info</function>, + <function>mysql_get_proto_info</function> et + <function>mysql_get_server_info</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml:1.1 Sun Apr 14 20:34:12 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml Fri Feb 7 13:10:11 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>string</type><methodname>mysql_get_proto_info</methodname> + <type>int</type><methodname>mysql_get_proto_info</methodname> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> @@ -19,8 +19,31 @@ Si <parameter>link_identifier</parameter> est omis, la dernière connexion ouverte est utilisée. </para> + <example> + <title>Exemple avec <function>mysql_get_proto_info</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + printf ("Version du protocole MySQL : %s\n", mysql_get_proto_info()); +?> +]]> + </programlisting> + <para> + L'exemple ci-dessus pourrait afficher : + </para> + <screen> +<![CDATA[ +Version du protocole MySQL : 10 +]]> + </screen> + </example> <para> - <function>mysql_get_proto_info</function> a été ajoutée en PHP 4.0.5. + Voir aussi + <function>mysql_get_client_info</function>, + <function>mysql_get_host_info</function> et + <function>mysql_get_server_info</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml:1.1 Sun Apr 14 20:34:14 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml Fri Feb 7 13:10:11 2003 @@ -5,28 +5,66 @@ <refnamediv> <refname>mysql_list_dbs</refname> <refpurpose> - Liste les bases de données disponibles sur le serveur MySQL. + Liste les bases de données disponibles sur le serveur MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>mysql_list_dbs</methodname> - <methodparam choice="opt"><type>resource</type><parameter> - link_identifier - </parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <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 + 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. + La fonction <function>mysql_tablename</function>, + ainsi que toutes les fonctions d'accès aux résultats comme + <function>mysql_fetch_array</function> peuvent être utilisées + pour déterminer le nom des bases dans le pointeur de résultat. </para> <para> + <example> + <title>Exemple avec <function>mysql_list_dbs</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$link = mysql_connect('localhost', 'utilisateur_mysql', 'mot_de_passe_mysql'); +$db_list = mysql_list_dbs($link); + +while ($row = mysql_fetch_object($db_list)) { + echo $row->Database . "\n"; +} +?> +]]> + </programlisting> + <para> + L'exemple ci-dessus va afficher : + <screen> +<![CDATA[ +database1 +database2 +database3 +... +]]> + </screen> + </para> + </example> + </para> + <note> + <para> + The above code would just as easily work with + <function>mysql_fetch_row</function> or other similar functions. + </para> + </note> + <para> Pour des raisons de compatibilité ascendante, mysql_listdbs() est encore disponible. + </para> + <para> + Voir aussi + <function>mysql_db_name</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml:1.1 Sun Apr 14 20:34:15 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> - <refpurpose>Liste les champs du résultat MySQL.</refpurpose> + <refpurpose>Liste les champs du résultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml:1.1 Sun Apr 14 20:34:15 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-list-tables"> <refnamediv> <refname>mysql_list_tables</refname> - <refpurpose>Liste les tables d'une base de données.</refpurpose> + <refpurpose>Liste les tables d'une base de données</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -20,13 +20,54 @@ 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. + <parameter>link_identifier</parameter>. La fonction <function>mysql_tablename</function>, + ainsi que toutes les fonctions d'accès aux résultats comme + <function>mysql_fetch_array</function> peuvent être utilisées + pour déterminer le nom des tables dans le pointeur de résultat. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listtables() - est encore disponible. + Le paramètre <parameter>database</parameter> est le nom de la base de données + à utiliser pour lister les tables. En cas d'échec, + <function>mysql_list_tables</function> retourne &false;. + </para> + <para> + Pour des raisons de compatibilité ascendante, la fonction + mysql_listtables() est toujours disponible. Elle est désormais + obsolète. + </para> + <example> + <title>Exemple avec <function>mysql_list_tables</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $dbname = 'test'; + + if (!mysql_connect('serveur_mysql', 'utilisateur_mysql', 'mot_de_passe_mysql') { + print 'Impossible de se connecter à MySQL'; + exit; + } + + $result = mysql_list_tables($dbname); + + if (!$result) { + print "Erreur : impossible de lister les bases de données\n"; + print 'Erreur MySQL : ' . mysql_error(); + exit; + } + + while ($row = mysql_fetch_row($result)) { + print "Table : $row[0]\n"; + } + + mysql_free_result($result); +?> +]]> + </programlisting> + </example> + <para> + Voir aussi + <function>mysql_list_dbs</function> et + <function>mysql_tablename</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml:1.1 Sun Apr 14 20:34:16 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml Fri Feb 7 13:10:11 2003 @@ -4,17 +4,17 @@ <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> - <refpurpose>Retourne le nombre de champs d'un résultat.</refpurpose> + <refpurpose>Retourne le nombre de champs d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_num_fields</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>mysql_num_fields</function> retourne le nombre de champs du - résultat <parameter>result_identifier</parameter>. + résultat <parameter>result</parameter>. </para> <para> Voir aussi Index: phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml:1.1 Sun Apr 14 20:34:16 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml Fri Feb 7 13:10:11 2003 @@ -4,35 +4,48 @@ <refentry id="function.mysql-num-rows"> <refnamediv> <refname>mysql_num_rows</refname> - <refpurpose>Retourne le nombre de lignes d'un résultat.</refpurpose> + <refpurpose>Retourne le nombre de lignes d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_num_rows</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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>. + INSERT, UPDATE ou DELETE, utilisez <function>mysql_affected_rows</function>. </para> <example> <title> - Exemple <function>mysql_num_rows</function> par crubel@trilizio.org + Exemple <function>mysql_num_rows</function> </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"; -?> +<![CDATA[ +<?php + +$link = mysql_connect("localhost", "mysql_user", "mysql_password"); +mysql_select_db("database", $link); + +$result = mysql_query("SELECT * FROM table1", $link); +$num_rows = mysql_num_rows($result); + +echo "$num_rows Rows\n"; + +?> +]]> </programlisting> </example> + <note> + <para> + Si vous utilisez <function>mysql_unbuffered_query</function>, + <function>mysql_num_rows</function> ne retournera pas le nombre + correct de lignes lues tant que vous n'aurez pas lu toutes les + lignes de la base. + </para> + </note> <para> Voir aussi <function>mysql_db_query</function>, Index: phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml:1.1 Sun Apr 14 20:34:16 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml Fri Feb 7 13:10:11 2003 @@ -12,11 +12,10 @@ <title>Description</title> <methodsynopsis> <type>resource</type><methodname>mysql_pconnect</methodname> - <methodparam choice="opt"><type>string</type><parameter> - server - </parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam> </methodsynopsis> <para> <function>mysql_pconnect</function> retourne un lien persistant positif en @@ -64,6 +63,21 @@ <para> C'est pourquoi ce type de connexion est dite 'persistante'. </para> + <note> + <para> + Notez que les connexions persitantes ne fonctionnent que si vous utilisez + &php; en version module. Voyez la section sur les + <link linkend="features.persistent-connections">connexions persistantes aux bases de données</link> + pour plus d'informations. + </para> + </note> + <warning> + <para> + L'utilisation des connexions persistantes requiert des paramétrages + d'Apache et de MySQL pour vous assurer que vous n'atteindrez pas + la limite maximale de nombre de connexions simultanées. + </para> + </warning> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-query.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.1 Sun Apr 14 20:34:17 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-query.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> - <refpurpose>Envoie une requête SQL à un serveur MySQL.</refpurpose> + <refpurpose>Envoie une requête SQL à un serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -12,6 +12,7 @@ <type>resource</type><methodname>mysql_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>result_mode</parameter></methodparam> </methodsynopsis> <para> <function>mysql_query</function> envoie une requête SQL à @@ -23,41 +24,62 @@ (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. + Le paramètre optionnel <parameter>result_mode</parameter> peut prendre + les valeurs de <constant>MYSQL_USE_RESULT</constant> ou <constant>MYSQL_STORE_RESULT</constant>. Par défaut, + il vaut <constant>MYSQL_STORE_RESULT</constant>, ce qui fait que le résultat est mis + dans un buffer. Voyez aussi la fonction + <function>mysql_unbuffered_query</function> pour comprendre cas + où le résultat n'est pas mis en buffer. + </para> + <note> + <para> + La requête ne doit pas être terminée par un point-virgule. + </para> + </note> + <para> + Seules les requêtes SQL SELECT,SHOW,EXPLAIN et DESCRIBE, + utilisée avec <function>mysql_query</function> + retourne une ressource de résultat MySQL, ou bien &false; si + la requête n'a pu être exécuté correctement. Pour les autres + types de requêtes SQL, <function>mysql_query</function> retourne &true; + en cas de succès et &false; en cas d'erreur. Un résultat différent de + &false;, la valeur signifie que la requête soumise est valide + et qu'elle a pu être exécutée correctement. Cela n'apporte aucune + indication sur le nombre de lignes affectées. Il est parfaitement + possible qu'une requête soit réussie, mais qu'elle ne modifie + aucune ligne, ou qu'elle n'en retourne aucune. </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> + <title>Exemple avec <function>mysql_query</function></title> <programlisting role="php"> -<?php - $result = mysql_query ("SELECT * WHERE 1=1") +<![CDATA[ +<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 + <literal>ma_colonne</literal> n'est pas une colonne de la table + <literal>my_table</literal>, ce qui conduit <function>mysql_query</function> à l'échec et retourne &false; : <example> - <title><function>mysql_query</function></title> + <title>Exemple avec <function>mysql_query</function> (2)</title> <programlisting role="php"> -<?php - $result = mysql_query ("SELECT my_col FROM my_tbl") +<![CDATA[ +<?php +$result = mysql_query("SELECT ma_colonne FROM ma_table") or die ("Requête invalide"); -?> +?> +]]> </programlisting> </example> </para> @@ -70,20 +92,27 @@ <function>mysql_affected_rows</function> pour connaître le nombre de lignes affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). + </para> + <para> + 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é + <function>mysql_fetch_array</function>, ou n'importe quelle autre + fonction de lecture de résultat. 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_num_rows</function>, <function>mysql_affected_rows</function>, <function>mysql_unbuffered_query</function>, - <function>mysql_db_query</function>, <function>mysql_free_result</function>, + <function>mysql_fetch_array</function>, + <function>mysql_fetch_row</function>, + <function>mysql_fetch_assoc</function>, <function>mysql_result</function>, - <function>mysql_select_db</function> et + <function>mysql_select_db</function> et <function>mysql_connect</function>. </para> </refsect1> Index: phpdoc-fr/reference/mysql/functions/mysql-result.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-result.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-result.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-result.xml:1.1 Sun Apr 14 20:34:18 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-result.xml Fri Feb 7 13:10:11 2003 @@ -4,17 +4,15 @@ <refentry id="function.mysql-result"> <refnamediv> <refname>mysql_result</refname> - <refpurpose>Retourne un champs d'un résultat.</refpurpose> + <refpurpose>Retourne un champs d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>mysql_result</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>row</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter> - field - </parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> </methodsynopsis> <para> <function>mysql_result</function> retourne le contenu d'un champs dans Index: phpdoc-fr/reference/mysql/functions/mysql-select-db.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-select-db.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-select-db.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-select-db.xml:1.1 Sun Apr 14 20:34:19 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-select-db.xml Fri Feb 7 13:10:11 2003 @@ -4,22 +4,16 @@ <refentry id="function.mysql-select-db"> <refnamediv> <refname>mysql_select_db</refname> - <refpurpose>Sélectionne une base de données MySQL.</refpurpose> + <refpurpose>Sélectionne une base de données MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_select_db</methodname> + <type>bool</type><methodname>mysql_select_db</methodname> <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter> - link_identifier - </parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <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 @@ -30,6 +24,9 @@ défaut. </para> <para> + &return.success; + </para> + <para> Toutes les requêtes suivantes avec <function>mysql_query</function> seront faites avec la base de données active. </para> @@ -41,7 +38,7 @@ </para> <para> Pour des raisons de compatibilité ascendante mysql_selectdb() est - encore disponible. + encore disponible. Elle est toutes fois obsolète. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-tablename.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-tablename.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-tablename.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-tablename.xml:1.1 Sun Apr 14 20:34:19 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-tablename.xml Fri Feb 7 13:10:11 2003 @@ -4,38 +4,42 @@ <refentry id="function.mysql-tablename"> <refnamediv> <refname>mysql_tablename</refname> - <refpurpose> - Lit le nom de la table qui contient le champs spécifié. - </refpurpose> + <refpurpose>Lit le nom de la table qui contient un champs</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_tablename</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>i</parameter></methodparam> </methodsynopsis> <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. + et retourne le nom de la table. La fonction <function>mysql_tablename</function>, + ainsi que toutes les fonctions d'accès aux résultats comme + <function>mysql_fetch_array</function> peuvent être utilisées + pour déterminer le nom des tables dans le pointeur de résultat. <example> - <title>Exemple <function>mysql_tablename</function></title> + <title>Exemple avec <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++; - } -?> +<![CDATA[ +<?php + mysql_connect("localhost", "utilisateur_mysql", "mot_de_passe_mysql"); + $result = mysql_list_tables("ma_bdd"); + + for ($i = 0; $i < mysql_num_rows($result); $i++) + printf ("Table : %s\n", mysql_tablename($result, $i)); + + mysql_free_result($result); +?> +]]> </programlisting> </example> + </para> + <para> + Voir aussi + <function>mysql_list_tables</function>. </para> </refsect1> </refentry>
Index: phpdoc-fr/reference/mysql/reference.xml diff -u phpdoc-fr/reference/mysql/reference.xml:1.3 phpdoc-fr/reference/mysql/reference.xml:1.4 --- phpdoc-fr/reference/mysql/reference.xml:1.3 Thu Feb 6 17:58:09 2003 +++ phpdoc-fr/reference/mysql/reference.xml Fri Feb 7 13:10:10 2003 @@ -1,66 +1,90 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<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 disponibles à - <ulink url="&url.mysql;">&url.mysql;</ulink>. - </simpara> - <simpara> - La documentation de MySQL est disponible à <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> +<!-- $Revision: 1.4 $ --> + <reference id="ref.mysql"> + <title>MySQL</title> + <titleabbrev>MySQL</titleabbrev> + + <partintro> + <section id="mysql.intro"> + &reftitle.intro; + <para> + Ces fonctions vous permettent d'accéder aux bases de données + MySQL. Le site officiel de cette base est + <ulink url="&url.mysql;">&url.mysql;</ulink>. + </para> + <para> + La documentation de MySQL est disponible à + <ulink url="&url.mysql.docs;">&url.mysql.docs;</ulink>. + </para> + </section> + + <section id="mysql.requirements"> + &reftitle.required; + <para> + Afin de pouvoir les utiliser, vous devez compiler PHP avec le support + MySQL. + </para> + </section> + + &reference.mysql.configure; + + &reference.mysql.ini; + + <section id="mysql.resources"> + &reftitle.resources; + <para> + There are two resource types used in the MySQL module. The first one + is the link identifier for a database connection, the second a resource + which holds the result of a query. + </para> + </section> + + &reference.mysql.constants; + + <section id="mysql.examples"> + &reftitle.examples; + <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"; + <example> + <title>Exemple de présentation de l'extension MySQL</title> + <programlisting role="php"> +<![CDATA[ +<?php + /* Connexion et sélection de la base */ + $link = mysql_connect("mysql_host", "mysql_user", "mysql_password") + or die("Could not connect"); + print "Connected successfully"; + mysql_select_db("my_database") or die("Could not select database"); + + /* Exécuter des requêtes SQL */ + $query = "SELECT * FROM my_table"; + $result = mysql_query($query) or die("Query failed"); + + /* Afficher des résultats en HTML */ + print "<table>\n"; + while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) { + print "\t<tr>\n"; + foreach ($line as $col_value) { + print "\t\t<td>$col_value</td>\n"; + } + print "\t</tr>\n"; } - print "\t</tr>\n"; - } - print "</table>\n"; - mysql_close($link); -?> - </programlisting> - </example> - </para> - </partintro> + print "</table>\n"; + + /* Libération des résultats */ + mysql_free_result($result); + + /* Fermeture de la connexion */ + mysql_close($link); +?> +]]> + </programlisting> + </example> + </para> + </section> + </partintro> &reference.mysql.functions; Index: phpdoc-fr/reference/mysql/functions/mysql-change-user.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-change-user.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-change-user.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-change-user.xml:1.1 Sun Apr 14 20:34:05 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-change-user.xml Fri Feb 7 13:10:11 2003 @@ -4,9 +4,7 @@ <refentry id="function.mysql-change-user"> <refnamediv> <refname>mysql_change_user</refname> - <refpurpose> - Change le nom de session de l'utilisateur actif. - </refpurpose> + <refpurpose>Change le nom de session de l'utilisateur actif</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,12 +12,8 @@ <type>int</type><methodname>mysql_change_user</methodname> <methodparam><type>string</type><parameter>user</parameter></methodparam> <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - database - </parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter> - link_identifier - </parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> <function>mysql_change_user</function> change l'utilisateur de la session @@ -29,11 +23,15 @@ défaut de l'utilisateur. Si une erreur de connexion survient, la connexion en cours restera active. </para> + <para> + &return.success; + </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> + </para> + </note> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-close.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-close.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-close.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-close.xml:1.1 Sun Apr 14 20:34:05 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-close.xml Fri Feb 7 13:10:11 2003 @@ -4,26 +4,25 @@ <refentry id="function.mysql-close"> <refnamediv> <refname>mysql_close</refname> - <refpurpose>Ferme la connexion MySQL.</refpurpose> + <refpurpose>Ferme la connexion MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>mysql_close</methodname> + <type>bool</type><methodname>mysql_close</methodname> <methodparam choice="opt"><type>resource</type><parameter> link_identifier </parameter></methodparam> </methodsynopsis> <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> + <para> + &return.success; + </para> <note> <para> Notez que cette commande n'est pas nécessaire, car toutes les connexions non @@ -37,13 +36,15 @@ <example> <title>Exemple MySQL_close</title> <programlisting role="php"> -<?php - $link = mysql_connect("kraemer", "marliesle", "secret") { +<![CDATA[ +<?php + $link = mysql_connect("serveur.mysql.com", "utilisateur", "secret") or die("Impossible de se connecter"); - } + print("Connexion réussie"); mysql_close($link); -?> +?> +]]> </programlisting> </example> <para> Index: phpdoc-fr/reference/mysql/functions/mysql-connect.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-connect.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-connect.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-connect.xml:1.1 Sun Apr 14 20:34:05 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-connect.xml Fri Feb 7 13:10:11 2003 @@ -4,25 +4,21 @@ <refentry id="function.mysql-connect"> <refnamediv> <refname>mysql_connect</refname> - <refpurpose>Ouvre une connexion à un serveur MySQL.</refpurpose> + <refpurpose>Ouvre une connexion à un serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_connect</methodname> - <methodparam choice="opt"><type>string</type><parameter> - server - </parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - username - </parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - password - </parameter></methodparam> + <type>resource</type><methodname>mysql_connect</methodname> + <methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>new_link</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_connect</function> retourne un identifiant positif de - connexion en cas de succès, et sinon &false;. + <function>mysql_connect</function> retourne une ressource de connexion + au serveur MySQL en cas de succès, et sinon &false;. </para> <para> <function>mysql_connect</function> établit une connexion à @@ -52,21 +48,40 @@ 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. + Le paramètre <parameter>new_link</parameter> modifie ce comportement et permet + que <function>mysql_connect</function> ouvre une nouvelle connexion + même si <function>mysql_connect</function> a été appelée auparavant + avec les mêmes paramètres. Le paramètre <parameter>client_flags</parameter> + peut être une combinaison des constantes suivantes : + <constant>MYSQL_CLIENT_SSL</constant>, <constant>MYSQL_CLIENT_COMPRESS</constant>, + <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> et <constant>MYSQL_CLIENT_INTERACTIVE</constant>. </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>. + <note> + <para> + La paramètre <parameter>new_link</parameter> a été ajouté en + &php; 4.2.0. + </para> + <para> + La paramètre <parameter>client_flags</parameter> a été ajouté en + &php; 4.3.0 + </para> + </note> <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> + <title>Exemple avec <function>mysql_connect</function></title> <programlisting role="php"> -<?php - $link = mysql_connect("kraemer", "marliesle", "secret") { - or die("Connexion impossible"); - } - print("Connexion réussie"); - mysql_close($link); -?> +<![CDATA[ +<?php + $link = mysql_connect("localhost", "mysql_user", "mysql_password") + or die("Impossible de se connecter : " . mysql_error()); + print ("Connexion réussie."); + mysql_close($link); +?> +]]> </programlisting> </example> <para> Index: phpdoc-fr/reference/mysql/functions/mysql-create-db.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-create-db.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-create-db.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-create-db.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-create-db.xml Fri Feb 7 13:10:11 2003 @@ -4,15 +4,15 @@ <refentry id="function.mysql-create-db"> <refnamediv> <refname>mysql_create_db</refname> - <refpurpose>Crée une base de données MySQL.</refpurpose> + <refpurpose>Crée une base de données MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_create_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <type>bool</type><methodname>mysql_create_db</methodname> + <methodparam><type>string</type><parameter>database name</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter> - link_identifier + link_identifier </parameter></methodparam> </methodsynopsis> <para> @@ -22,10 +22,16 @@ <parameter>link_identifier</parameter>, ou sur la dernière connexion ouverte. </para> + <para> + &return.success; + </para> <example> - <title>Exemple de création de base MySQL</title> + <title> + Exemple de création de base MySQL avec <function>mysql_create_db</function> + </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } @@ -34,16 +40,25 @@ } 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> + <note> + <para> + La fonction <function>mysql_create_db</function> est obsolète. Il + est préférable d'utiliser la fonction <function>mysql_query</function>, + avec une commande SQL "CREATE DATABASE". + </para> + </note> <para> Voir aussi - <function>mysql_drop_db</function>. + <function>mysql_drop_db</function> et + <function>mysql_query</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-data-seek.xml Fri Feb 7 13:10:11 2003 @@ -4,20 +4,16 @@ <refentry id="function.mysql-data-seek"> <refnamediv> <refname>mysql_data_seek</refname> - <refpurpose>Déplace le pointeur interne de résultat.</refpurpose> + <refpurpose>Déplace le pointeur interne de résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_data_seek</methodname> + <type>bool</type><methodname>mysql_data_seek</methodname> <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> <methodparam><type>int</type><parameter>row_number</parameter></methodparam> </methodsynopsis> <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>. @@ -26,12 +22,25 @@ retournera cette ligne. </para> <para> - <parameter>row_number</parameter> commence à 0. + &return.success; + </para> + <para> + <parameter>row_number</parameter> commence à 0. + <parameter>row_number</parameter> doit être une valeur qui + va de 0 à <function>mysql_num_rows</function> - 1. </para> + <note> + <para> + La fonction <function>mysql_data_seek</function> peut être utilisée + en conjonction avec <function>mysql_query</function>, mais pas + avec la fonction <function>mysql_unbuffered_query</function>. + </para> + </note> <example> <title>Exemple <function>mysql_data_seek</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } @@ -53,9 +62,15 @@ echo "{$row->last_name} {$row->last_name$row->first_name}<br>\n"; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>mysql_query</function> et + <function>mysql_num_rows</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-db-name.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-db-name.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-db-name.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-db-name.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-db-name.xml Fri Feb 7 13:10:11 2003 @@ -9,12 +9,10 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_db_name</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <type>string</type><methodname>mysql_db_name</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>row</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter> - field - </parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> </methodsynopsis> <para> <function>mysql_db_name</function> prend comme premier argument @@ -30,7 +28,8 @@ <example> <title>Exemple <function>mysql_db_name</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php error_reporting(E_ALL); mysql_connect('dbhost', 'username', 'password'); $db_list = mysql_list_dbs(); @@ -40,7 +39,8 @@ echo mysql_db_name($db_list, $i) . "\n"; $i++; } -?> +?> +]]> </programlisting> </example> <para> Index: phpdoc-fr/reference/mysql/functions/mysql-db-query.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-db-query.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-db-query.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-db-query.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-db-query.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-db-query"> <refnamediv> <refname>mysql_db_query</refname> - <refpurpose>Envoie une requête MySQL à un serveur MySQL.</refpurpose> + <refpurpose>Envoie une requête MySQL à un serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml:1.1 Sun Apr 14 20:34:06 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-drop-db.xml Fri Feb 7 13:10:11 2003 @@ -4,25 +4,24 @@ <refentry id="function.mysql-drop-db"> <refnamediv> <refname>mysql_drop_db</refname> - <refpurpose>Efface une base de données MySQL.</refpurpose> + <refpurpose>Efface une base de données MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>mysql_drop_db</methodname> + <type>bool</type><methodname>mysql_drop_db</methodname> <methodparam><type>string</type><parameter>database_name</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter> link_identifier </parameter></methodparam> </methodsynopsis> <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> + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml:1.1 Sun Apr 14 20:34:07 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-array.xml Fri Feb 7 13:10:11 2003 @@ -13,10 +13,8 @@ <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_array</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - result_type - </parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> </methodsynopsis> <para> <function>mysql_fetch_array</function> retourne un tableau qui @@ -36,11 +34,14 @@ 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> + <example> + <title>Requête avec duplication de nom de colonnes</title> <programlisting role="sql"> -select t1.f1 as foo t2.f1 as bar from t1, t2 +<![CDATA[ + select table1.field as foo table2.field as bar from table1, table2 +]]> </programlisting> - </informalexample> + </example> </para> <para> Il est important de souligner que <function>mysql_fetch_array</function> N'est PAS @@ -50,26 +51,84 @@ <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. + valeurs suivantes : <constant>MYSQL_ASSOC</constant>, + <constant>MYSQL_NUM</constant> et <constant>MYSQL_BOTH</constant>.Cette + fonctionnalité a été ajoutée en &php; 3.0.7. <constant>MYSQL_BOTH</constant> + est la valeur par défaut de cet argument. </para> <para> - Voir aussi - <function>mysql_fetch_row</function>. + En utilisant <constant>MYSQL_BOTH</constant>, vos obtiendrez un tableau + qui sera à la fois associatif et indexé numériquement. En utilisant + <constant>MYSQL_ASSOC</constant>, vous obtiendrez un tableau + associatif (tout comme le fait <function>mysql_fetch_assoc</function>), + et en utilisant <constant>MYSQL_NUM</constant>, vous obtiendrez un tableau + indexé nuériquement (comme le fait <function>mysql_fetch_row</function>). </para> <example> - <title>mysql fetch array</title> + <title>Exemple de <function>mysql_fetch_array</function> avec <constant>MYSQL_NUM</constant></title> + <programlisting role="php"> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + mysql_select_db("mydb"); + + $result = mysql_query("SELECT id, name FROM mytable"); + + while ($row = mysql_fetch_array($result, MYSQL_NUM)) { + printf ("ID: %s Name: %s", $row[0], $row[1]); + } + + mysql_free_result($result); +?> +]]> + </programlisting> + </example> + <example> + <title>Exemple de <function>mysql_fetch_array</function> avec <constant>MYSQL_ASSOC</constant></title> + <programlisting role="php"> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + mysql_select_db("mydb"); + + $result = mysql_query("SELECT id, name FROM mytable"); + + while ($row = mysql_fetch_array($result, MYSQL_ASSOC)) { + printf ("ID: %s Name: %s", $row["id"], $row["name"]); + } + + mysql_free_result($result); +?> +]]> + </programlisting> + </example> + <example> + <title>Exemple de <function>mysql_fetch_array</function> avec <constant>MYSQL_BOTH</constant></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); -?> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + mysql_select_db("mydb"); + + $result = mysql_query("SELECT id, name FROM mytable"); + + while ($row = mysql_fetch_array($result, MYSQL_BOTH)) { + printf ("ID: %s Name: %s", $row[0], $row["name"]); + } + + mysql_free_result($result); +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>mysql_fetch_row</function> et + <function>mysql_fetch_assoc</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-assoc.xml Fri Feb 7 13:10:11 2003 @@ -12,12 +12,12 @@ <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_assoc</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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. + qui contient la ligne lue dans le résultat <parameter>result</parameter>, + ou bien &false;, s'il ne reste plus de lignes à lire. </para> <para> <function>mysql_fetch_assoc</function> est équivalente à @@ -43,19 +43,62 @@ <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. </para> <example> - <title><function>mysql_fetch_assoc</function></title> + <title>Exemple avec <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); -?> +<![CDATA[ +<?php + $conn = mysql_connect("localhost", "mysql_user", "mysql_password"); + + if (!$conn) { + echo "Impossible de se connecter à la base de données : " . mysql_error(); + exit; + } + + if (!mysql_select_db("mydbname")) { + echo "Impossible d'accéder à la base de données : " . mysql_error(); + exit; + } + + $sql = "SELECT id as userid, fullname, userstatus + FROM sometable + WHERE userstatus = 1"; + + $result = mysql_query($sql); + + if (!$result) { + echo "Impossible d'exécuter la requête ($sql) dans la base : " . mysql_error(); + exit; + } + + if (mysql_num_rows($result) == 0) { + echo "Aucune ligne trouvées, rien à afficher."; + exit; + } + + // Tant qu'une ligne existe, place cette ligne dans la variable $row + // sous la forme d'un tableau associatif. + // Note : Si vous n'attendez qu'une seule ligne, oubliez la boucle + // Note : Si vous utilisez extract($row); dans la boucle suivante + // vous créerez then create $userid, $fullname, and $userstatus + while ($row = mysql_fetch_assoc($result)) { + echo $row["userid"]; + echo $row["fullname"]; + echo $row["userstatus"]; + } + + mysql_free_result($result); + +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>mysql_fetch_row</function>, + <function>mysql_fetch_array</function>, + <function>mysql_query</function> et + <function>mysql_error</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-field.xml Fri Feb 7 13:10:11 2003 @@ -13,14 +13,12 @@ <title>Description</title> <methodsynopsis> <type>object</type><methodname>mysql_fetch_field</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - field_offset - </parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> <function>mysql_fetch_field</function> retourne un objet contenant - les données, lu dans le résultat <parameter>result_identifier</parameter>. + les données, lu dans le résultat <parameter>result</parameter>. </para> <para> <function>mysql_fetch_field</function> sert à obtenir des @@ -94,6 +92,45 @@ </listitem> </itemizedlist> </para> + <example> + <title>Exemple avec <function>mysql_fetch_field</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +mysql_connect('localhost:3306', $user, $password) + or die("Impossible de se connecter : " . mysql_error()); +mysql_select_db("database"); +$result = mysql_query("select * from table") + or die("Query failed: " . mysql_error()); +/* Lecture des méta données de la colonne */ +$i = 0; +while ($i < mysql_num_fields($result)) { + echo "Détails sur la colonne $i :<br />\n"; + $meta = mysql_fetch_field($result); + if (!$meta) { + echo "Aucun détail disponible<br />\n"; + } + echo "<pre> +blob: $meta->blob +max_length: $meta->max_length +multiple_key: $meta->multiple_key +name: $meta->name +not_null: $meta->not_null +numeric: $meta->numeric +primary_key: $meta->primary_key +table: $meta->table +type: $meta->type +unique_key: $meta->unique_key +unsigned: $meta->unsigned +zerofill: $meta->zerofill +</pre>"; + $i++; +} +mysql_free_result($result); +?> +]]> + </programlisting> + </example> <para> Voir aussi <function>mysql_field_seek</function>. Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-lengths.xml Fri Feb 7 13:10:11 2003 @@ -5,26 +5,28 @@ <refnamediv> <refname>mysql_fetch_lengths</refname> <refpurpose> - Retourne la taille de chaque colonne d'une ligne de résultat. + Retourne la taille de chaque colonne d'une ligne de résultat </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_lengths</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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;. + par <function>mysql_fetch_row</function>, et lue dans le résultat + <parameter>result</parameter>, 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>, + 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. + position 0. </para> <para> Voir aussi Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml:1.1 Sun Apr 14 20:34:08 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-object.xml Fri Feb 7 13:10:11 2003 @@ -4,21 +4,18 @@ <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> + <refpurpose>Retourne une ligne de résultat MySQL sous la forme d'un objet</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>object</type><methodname>mysql_fetch_object</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - result_type - </parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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 + propriétés correspondent à une ligne du + résultat <parameter>result</parameter>, ou &false; si il n'y a plus d'autres lignes. </para> <para> @@ -30,6 +27,20 @@ nombres ne sont pas des noms MySQL). </para> <para> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Ceci est valide */ +echo $row->field; +/* Ceci est invalide */ +echo $row->0; + +?> +]]> + </programlisting> + </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> @@ -39,17 +50,20 @@ aussi rapide que <function>mysql_fetch_row</function> (la différence est insignifiante) <example> - <title>mysql fetch object</title> + <title>Exemple avec <function>mysql_fetch_object</function></title> <programlisting role="php"> -<?php - mysql_connect($host,$user,$password); - $result = mysql_db_query("database","select * from table"); - while($row = mysql_fetch_object($result)) { +<![CDATA[ +<?php +mysql_connect("hostname", "user", "password"); +mysql_select_db($db); +$result = mysql_query("select * from table"); +while ($row = mysql_fetch_object($result)) { echo $row->user_id; echo $row->fullname; - } - mysql_free_result($result); -?> +} +mysql_free_result($result); +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-fetch-row.xml Fri Feb 7 13:10:11 2003 @@ -4,18 +4,19 @@ <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> + <refpurpose>Retourne une ligne de résultat MySQL sous la forme d'un tableau</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>mysql_fetch_row</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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. + indexé numériquement, qui correspond à la prochaine ligne + du résultat MySQL <parameter>result</parameter>, ou bien &false; + s'il ne reste plus de ligne. </para> <para> <function>mysql_fetch_row</function> va rechercher une ligne dans le Index: phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-flags.xml Fri Feb 7 13:10:11 2003 @@ -5,15 +5,14 @@ <refnamediv> <refname>mysql_field_flags</refname> <refpurpose> - Retourne le sémaphore associé à la colonne - spécifiée dans le résultat courant. + Retourne des détails sur une colonne MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_flags</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> @@ -25,8 +24,9 @@ </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". + 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() Index: phpdoc-fr/reference/mysql/functions/mysql-field-len.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-len.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-len.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-len.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-len.xml Fri Feb 7 13:10:11 2003 @@ -4,20 +4,19 @@ <refentry id="function.mysql-field-len"> <refnamediv> <refname>mysql_field_len</refname> - <refpurpose> - Retourne la longueur du champs spécifié. - </refpurpose> + <refpurpose>Retourne la taille d'un champs de résultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_field_len</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> <function>mysql_field_len</function> retourne la taille du champs - spécifié par son offset <parameter>field_offset</parameter>. + <parameter>field_offset</parameter>-ième champs dans le résultat + <parameter>result</parameter>. Les champs sont indexés à partir de 0. </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldlen() Index: phpdoc-fr/reference/mysql/functions/mysql-field-name.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-name.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-name.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-name.xml:1.1 Sun Apr 14 20:34:09 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-name.xml Fri Feb 7 13:10:11 2003 @@ -12,19 +12,54 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_name</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_index</parameter></methodparam> </methodsynopsis> <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>. + <function>mysql_field_name</function> retourne le nom de la + <parameter>field_index</parameter>-ième colonne du résulat MySQL + <parameter>result</parameter>. <parameter>result</parameter> doit + être une ressource de résultat MySQL et <parameter>field_index</parameter> + est un offset numérique du champs. </para> + <note> + <para> + <parameter>field_index</parameter> commence à 0. + </para> + <para> + e.g. L'index du troisième champs sera en fait l'offset 2, + et l'index du quatrième champs sera en fait l'offset 3, etc.... + </para> + </note> <para> - <function>mysql_field_name</function> retournera le nom du - deuxième champs dans le résultat associé - à $result. + <example> + <title>Exemple avec <function>mysql_field_name</function></title> + <programlisting role="php"> +<![CDATA[ +/* Supposons que la table utilisée contienne trois champs : + * user_id + * username + * password. + */ +$link = mysql_connect('localhost', "mysql_user", "mysql_password"); +mysql_select_db($dbname, $link) + or die("Impossible de se connecter à la base $dbname : " . mysql_error()); +$res = mysql_query("select * from users", $link); + +echo mysql_field_name($res, 0) . "\n"; +echo mysql_field_name($res, 2); +]]> + </programlisting> + <para> + L'exemple ci-dessus va afficher : + <screen> +<![CDATA[ +user_id +password +]]> + </screen> + </para> + </example> </para> <para> Pour des raisons de compatibilité ascendante, mysql_fieldname() Index: phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-seek.xml Fri Feb 7 13:10:11 2003 @@ -12,13 +12,14 @@ <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_field_seek</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <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é. + 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 Index: phpdoc-fr/reference/mysql/functions/mysql-field-table.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-table.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-table.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-table.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-table.xml Fri Feb 7 13:10:11 2003 @@ -12,13 +12,18 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_table</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <para> <function>mysql_field_table</function> retourne le nom de la table - où se trouve une colonne. Pour des raisons de compatibilité + où se trouve la colonne d'offset <parameter>field_offset</parameter>, + dans le résultat MySQL <parameter>result</parameter>. + </para> + <para> + Pour des raisons de compatibilité ascendante, mysql_fieldtable() peut encore être utilisé. + Toutes fois, elle est obsolète. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-field-type.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-field-type.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-field-type.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-field-type.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-field-type.xml Fri Feb 7 13:10:11 2003 @@ -4,51 +4,64 @@ <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> + <refpurpose>Retourne le type de la colonne courante</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_field_type</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_offset</parameter></methodparam> </methodsynopsis> <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. + <function>mysql_field_name</function>. Les arguments sont identiques : c'est + le type du champs qui est retourné. Il vaudra + "int", "real", "string", "blob" ou d'autres, comme détaillé + <ulink url="&url.mysql.docs;">dans la documentation MySQL</ulink>. <example> - <title>Types mysql field</title> + <title>Types MySQL</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(); -?> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_utilisateur", "mysql_mot_de_passe"); + mysql_select_db("mysql"); + $result = mysql_query("SELECT * FROM func"); + $fields = mysql_num_fields($result); + $rows = mysql_num_rows($result); + $table = mysql_field_table($result, 0); + echo "Votre table '".$table."' dispose de ".$fields." colonnes et ".$rows." ligne(s)\n"; + echo "Les colonnes sont les suivantes : \n"; + for ($i=0; $i < $fields; $i++) { + $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."\n"; + } + mysql_free_result($result); + mysql_close(); +?> +]]> </programlisting> </example> </para> <para> + L'exemple ci-dessus produit l'affichage suivant : + <screen> +<![CDATA[ +Votre table 'func' dispose de 4 colonnes et 1 ligne(s) +Les colonnes sont les suivantes : +string name 64 not_null primary_key binary +int ret 1 not_null +string dl 128 not_null +string type 9 not_null enum +]]> + </screen> + </para> + <para> Pour des raisons de compatibilité ascendante, mysql_fieldtype() - peut encore être utilisé. + peut encore être utilisé. Toutes fois, elle est obsolète. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-free-result.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-free-result.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-free-result.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-free-result.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-free-result.xml Fri Feb 7 13:10:11 2003 @@ -4,19 +4,26 @@ <refentry id="function.mysql-free-result"> <refnamediv> <refname>mysql_free_result</refname> - <refpurpose>Efface le résultat de la mémoire.</refpurpose> + <refpurpose>Efface le résultat de la mémoire</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_free_result</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <type>bool</type><methodname>mysql_free_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> + <function>mysql_free_result</function> libère toute la mémoire et + les ressources utilisées par la ressource de résultat <parameter>result</parameter>. + </para> + <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> + &return.success; </para> <para> Pour des raisons de compatibilité ascendante, mysql_freeresult() Index: phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml:1.1 Sun Apr 14 20:34:10 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-get-client-info.xml Fri Feb 7 13:10:11 2003 @@ -10,14 +10,35 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_get_client_info</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <void/> </methodsynopsis> <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> + <example> + <title>Exemple avec <function>mysql_get_client_info</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + printf ("Détails sur le client MySQL : %s\n", mysql_get_client_info()); +?> +]]> + </programlisting> + <para> + L'exemple ci-dessus pourrait afficher par exemple : + </para> + <screen> +<![CDATA[ +Détails sur le client MySQL : 3.23.39 +]]> + </screen> + </example> <para> - <function>mysql_get_client_info</function> a été ajoutée en PHP 4.0.5. + Voir aussi + <function>mysql_get_host_info</function>, + <function>mysql_get_proto_info</function> et + <function>mysql_get_server_info</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml:1.1 Sun Apr 14 20:34:12 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-get-proto-info.xml Fri Feb 7 13:10:11 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>string</type><methodname>mysql_get_proto_info</methodname> + <type>int</type><methodname>mysql_get_proto_info</methodname> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> @@ -19,8 +19,31 @@ Si <parameter>link_identifier</parameter> est omis, la dernière connexion ouverte est utilisée. </para> + <example> + <title>Exemple avec <function>mysql_get_proto_info</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + mysql_connect("localhost", "mysql_user", "mysql_password") or + die("Impossible de se connecter : " . mysql_error()); + printf ("Version du protocole MySQL : %s\n", mysql_get_proto_info()); +?> +]]> + </programlisting> + <para> + L'exemple ci-dessus pourrait afficher : + </para> + <screen> +<![CDATA[ +Version du protocole MySQL : 10 +]]> + </screen> + </example> <para> - <function>mysql_get_proto_info</function> a été ajoutée en PHP 4.0.5. + Voir aussi + <function>mysql_get_client_info</function>, + <function>mysql_get_host_info</function> et + <function>mysql_get_server_info</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml:1.1 Sun Apr 14 20:34:14 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-list-dbs.xml Fri Feb 7 13:10:11 2003 @@ -5,28 +5,66 @@ <refnamediv> <refname>mysql_list_dbs</refname> <refpurpose> - Liste les bases de données disponibles sur le serveur MySQL. + Liste les bases de données disponibles sur le serveur MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>resource</type><methodname>mysql_list_dbs</methodname> - <methodparam choice="opt"><type>resource</type><parameter> - link_identifier - </parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <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 + 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. + La fonction <function>mysql_tablename</function>, + ainsi que toutes les fonctions d'accès aux résultats comme + <function>mysql_fetch_array</function> peuvent être utilisées + pour déterminer le nom des bases dans le pointeur de résultat. </para> <para> + <example> + <title>Exemple avec <function>mysql_list_dbs</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$link = mysql_connect('localhost', 'utilisateur_mysql', 'mot_de_passe_mysql'); +$db_list = mysql_list_dbs($link); + +while ($row = mysql_fetch_object($db_list)) { + echo $row->Database . "\n"; +} +?> +]]> + </programlisting> + <para> + L'exemple ci-dessus va afficher : + <screen> +<![CDATA[ +database1 +database2 +database3 +... +]]> + </screen> + </para> + </example> + </para> + <note> + <para> + The above code would just as easily work with + <function>mysql_fetch_row</function> or other similar functions. + </para> + </note> + <para> Pour des raisons de compatibilité ascendante, mysql_listdbs() est encore disponible. + </para> + <para> + Voir aussi + <function>mysql_db_name</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml:1.1 Sun Apr 14 20:34:15 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-list-fields.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> - <refpurpose>Liste les champs du résultat MySQL.</refpurpose> + <refpurpose>Liste les champs du résultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml:1.1 Sun Apr 14 20:34:15 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-list-tables.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-list-tables"> <refnamediv> <refname>mysql_list_tables</refname> - <refpurpose>Liste les tables d'une base de données.</refpurpose> + <refpurpose>Liste les tables d'une base de données</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -20,13 +20,54 @@ 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. + <parameter>link_identifier</parameter>. La fonction <function>mysql_tablename</function>, + ainsi que toutes les fonctions d'accès aux résultats comme + <function>mysql_fetch_array</function> peuvent être utilisées + pour déterminer le nom des tables dans le pointeur de résultat. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listtables() - est encore disponible. + Le paramètre <parameter>database</parameter> est le nom de la base de données + à utiliser pour lister les tables. En cas d'échec, + <function>mysql_list_tables</function> retourne &false;. + </para> + <para> + Pour des raisons de compatibilité ascendante, la fonction + mysql_listtables() est toujours disponible. Elle est désormais + obsolète. + </para> + <example> + <title>Exemple avec <function>mysql_list_tables</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $dbname = 'test'; + + if (!mysql_connect('serveur_mysql', 'utilisateur_mysql', 'mot_de_passe_mysql') { + print 'Impossible de se connecter à MySQL'; + exit; + } + + $result = mysql_list_tables($dbname); + + if (!$result) { + print "Erreur : impossible de lister les bases de données\n"; + print 'Erreur MySQL : ' . mysql_error(); + exit; + } + + while ($row = mysql_fetch_row($result)) { + print "Table : $row[0]\n"; + } + + mysql_free_result($result); +?> +]]> + </programlisting> + </example> + <para> + Voir aussi + <function>mysql_list_dbs</function> et + <function>mysql_tablename</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml:1.1 Sun Apr 14 20:34:16 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-num-fields.xml Fri Feb 7 13:10:11 2003 @@ -4,17 +4,17 @@ <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> - <refpurpose>Retourne le nombre de champs d'un résultat.</refpurpose> + <refpurpose>Retourne le nombre de champs d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_num_fields</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <para> <function>mysql_num_fields</function> retourne le nombre de champs du - résultat <parameter>result_identifier</parameter>. + résultat <parameter>result</parameter>. </para> <para> Voir aussi Index: phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml:1.1 Sun Apr 14 20:34:16 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-num-rows.xml Fri Feb 7 13:10:11 2003 @@ -4,35 +4,48 @@ <refentry id="function.mysql-num-rows"> <refnamediv> <refname>mysql_num_rows</refname> - <refpurpose>Retourne le nombre de lignes d'un résultat.</refpurpose> + <refpurpose>Retourne le nombre de lignes d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysql_num_rows</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> </methodsynopsis> <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>. + INSERT, UPDATE ou DELETE, utilisez <function>mysql_affected_rows</function>. </para> <example> <title> - Exemple <function>mysql_num_rows</function> par crubel@trilizio.org + Exemple <function>mysql_num_rows</function> </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"; -?> +<![CDATA[ +<?php + +$link = mysql_connect("localhost", "mysql_user", "mysql_password"); +mysql_select_db("database", $link); + +$result = mysql_query("SELECT * FROM table1", $link); +$num_rows = mysql_num_rows($result); + +echo "$num_rows Rows\n"; + +?> +]]> </programlisting> </example> + <note> + <para> + Si vous utilisez <function>mysql_unbuffered_query</function>, + <function>mysql_num_rows</function> ne retournera pas le nombre + correct de lignes lues tant que vous n'aurez pas lu toutes les + lignes de la base. + </para> + </note> <para> Voir aussi <function>mysql_db_query</function>, Index: phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml:1.1 Sun Apr 14 20:34:16 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-pconnect.xml Fri Feb 7 13:10:11 2003 @@ -12,11 +12,10 @@ <title>Description</title> <methodsynopsis> <type>resource</type><methodname>mysql_pconnect</methodname> - <methodparam choice="opt"><type>string</type><parameter> - server - </parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam> </methodsynopsis> <para> <function>mysql_pconnect</function> retourne un lien persistant positif en @@ -64,6 +63,21 @@ <para> C'est pourquoi ce type de connexion est dite 'persistante'. </para> + <note> + <para> + Notez que les connexions persitantes ne fonctionnent que si vous utilisez + &php; en version module. Voyez la section sur les + <link linkend="features.persistent-connections">connexions persistantes aux bases de données</link> + pour plus d'informations. + </para> + </note> + <warning> + <para> + L'utilisation des connexions persistantes requiert des paramétrages + d'Apache et de MySQL pour vous assurer que vous n'atteindrez pas + la limite maximale de nombre de connexions simultanées. + </para> + </warning> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-query.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.1 Sun Apr 14 20:34:17 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-query.xml Fri Feb 7 13:10:11 2003 @@ -4,7 +4,7 @@ <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> - <refpurpose>Envoie une requête SQL à un serveur MySQL.</refpurpose> + <refpurpose>Envoie une requête SQL à un serveur MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -12,6 +12,7 @@ <type>resource</type><methodname>mysql_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>result_mode</parameter></methodparam> </methodsynopsis> <para> <function>mysql_query</function> envoie une requête SQL à @@ -23,41 +24,62 @@ (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. + Le paramètre optionnel <parameter>result_mode</parameter> peut prendre + les valeurs de <constant>MYSQL_USE_RESULT</constant> ou <constant>MYSQL_STORE_RESULT</constant>. Par défaut, + il vaut <constant>MYSQL_STORE_RESULT</constant>, ce qui fait que le résultat est mis + dans un buffer. Voyez aussi la fonction + <function>mysql_unbuffered_query</function> pour comprendre cas + où le résultat n'est pas mis en buffer. + </para> + <note> + <para> + La requête ne doit pas être terminée par un point-virgule. + </para> + </note> + <para> + Seules les requêtes SQL SELECT,SHOW,EXPLAIN et DESCRIBE, + utilisée avec <function>mysql_query</function> + retourne une ressource de résultat MySQL, ou bien &false; si + la requête n'a pu être exécuté correctement. Pour les autres + types de requêtes SQL, <function>mysql_query</function> retourne &true; + en cas de succès et &false; en cas d'erreur. Un résultat différent de + &false;, la valeur signifie que la requête soumise est valide + et qu'elle a pu être exécutée correctement. Cela n'apporte aucune + indication sur le nombre de lignes affectées. Il est parfaitement + possible qu'une requête soit réussie, mais qu'elle ne modifie + aucune ligne, ou qu'elle n'en retourne aucune. </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> + <title>Exemple avec <function>mysql_query</function></title> <programlisting role="php"> -<?php - $result = mysql_query ("SELECT * WHERE 1=1") +<![CDATA[ +<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 + <literal>ma_colonne</literal> n'est pas une colonne de la table + <literal>my_table</literal>, ce qui conduit <function>mysql_query</function> à l'échec et retourne &false; : <example> - <title><function>mysql_query</function></title> + <title>Exemple avec <function>mysql_query</function> (2)</title> <programlisting role="php"> -<?php - $result = mysql_query ("SELECT my_col FROM my_tbl") +<![CDATA[ +<?php +$result = mysql_query("SELECT ma_colonne FROM ma_table") or die ("Requête invalide"); -?> +?> +]]> </programlisting> </example> </para> @@ -70,20 +92,27 @@ <function>mysql_affected_rows</function> pour connaître le nombre de lignes affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). + </para> + <para> + 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é + <function>mysql_fetch_array</function>, ou n'importe quelle autre + fonction de lecture de résultat. 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_num_rows</function>, <function>mysql_affected_rows</function>, <function>mysql_unbuffered_query</function>, - <function>mysql_db_query</function>, <function>mysql_free_result</function>, + <function>mysql_fetch_array</function>, + <function>mysql_fetch_row</function>, + <function>mysql_fetch_assoc</function>, <function>mysql_result</function>, - <function>mysql_select_db</function> et + <function>mysql_select_db</function> et <function>mysql_connect</function>. </para> </refsect1> Index: phpdoc-fr/reference/mysql/functions/mysql-result.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-result.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-result.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-result.xml:1.1 Sun Apr 14 20:34:18 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-result.xml Fri Feb 7 13:10:11 2003 @@ -4,17 +4,15 @@ <refentry id="function.mysql-result"> <refnamediv> <refname>mysql_result</refname> - <refpurpose>Retourne un champs d'un résultat.</refpurpose> + <refpurpose>Retourne un champs d'un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>mysql_result</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>row</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter> - field - </parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> </methodsynopsis> <para> <function>mysql_result</function> retourne le contenu d'un champs dans Index: phpdoc-fr/reference/mysql/functions/mysql-select-db.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-select-db.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-select-db.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-select-db.xml:1.1 Sun Apr 14 20:34:19 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-select-db.xml Fri Feb 7 13:10:11 2003 @@ -4,22 +4,16 @@ <refentry id="function.mysql-select-db"> <refnamediv> <refname>mysql_select_db</refname> - <refpurpose>Sélectionne une base de données MySQL.</refpurpose> + <refpurpose>Sélectionne une base de données MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>mysql_select_db</methodname> + <type>bool</type><methodname>mysql_select_db</methodname> <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter> - link_identifier - </parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <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 @@ -30,6 +24,9 @@ défaut. </para> <para> + &return.success; + </para> + <para> Toutes les requêtes suivantes avec <function>mysql_query</function> seront faites avec la base de données active. </para> @@ -41,7 +38,7 @@ </para> <para> Pour des raisons de compatibilité ascendante mysql_selectdb() est - encore disponible. + encore disponible. Elle est toutes fois obsolète. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/mysql/functions/mysql-tablename.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-tablename.xml:1.1 phpdoc-fr/reference/mysql/functions/mysql-tablename.xml:1.2 --- phpdoc-fr/reference/mysql/functions/mysql-tablename.xml:1.1 Sun Apr 14 20:34:19 2002 +++ phpdoc-fr/reference/mysql/functions/mysql-tablename.xml Fri Feb 7 13:10:11 2003 @@ -4,38 +4,42 @@ <refentry id="function.mysql-tablename"> <refnamediv> <refname>mysql_tablename</refname> - <refpurpose> - Lit le nom de la table qui contient le champs spécifié. - </refpurpose> + <refpurpose>Lit le nom de la table qui contient un champs</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysql_tablename</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>i</parameter></methodparam> </methodsynopsis> <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. + et retourne le nom de la table. La fonction <function>mysql_tablename</function>, + ainsi que toutes les fonctions d'accès aux résultats comme + <function>mysql_fetch_array</function> peuvent être utilisées + pour déterminer le nom des tables dans le pointeur de résultat. <example> - <title>Exemple <function>mysql_tablename</function></title> + <title>Exemple avec <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++; - } -?> +<![CDATA[ +<?php + mysql_connect("localhost", "utilisateur_mysql", "mot_de_passe_mysql"); + $result = mysql_list_tables("ma_bdd"); + + for ($i = 0; $i < mysql_num_rows($result); $i++) + printf ("Table : %s\n", mysql_tablename($result, $i)); + + mysql_free_result($result); +?> +]]> </programlisting> </example> + </para> + <para> + Voir aussi + <function>mysql_list_tables</function>. </para> </refsect1> </refentry>