cvs: phpdoc /fr/functions mysql.xml
| From: | Damien Seguy | Date: | Wed, 06 Dec 2000 13:05:11 +0000 |
| Subject: | cvs: phpdoc /fr/functions mysql.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333156@lists.php.net to get a copy of this message | ||
dams Wed Dec 6 05:05:11 2000 EDT
Modified files:
/phpdoc/fr/functions mysql.xml
Log:
Removed old cross references
Index: phpdoc/fr/functions/mysql.xml diff -u phpdoc/fr/functions/mysql.xml:1.6 phpdoc/fr/functions/mysql.xml:1.7 --- phpdoc/fr/functions/mysql.xml:1.6 Wed Nov 29 05:26:07 2000 +++ phpdoc/fr/functions/mysql.xml Wed Dec 6 05:05:11 2000 @@ -17,7 +17,7 @@ MySQL, et évitera les conflits. </simpara> <simpara> - Plus d'informations sont disponibles à + Plus d'informations sont disponibles à <ulink url="http://www.mysql.com/">http://www.mysql.com/</ulink>. </simpara> <simpara> @@ -26,10 +26,9 @@ chez <ulink url="http://dev.nexen.net/docs/mysql/">nexen</ulink>. </simpara> </partintro> - <refentry id="function.mysql-affected-rows"> <refnamediv> - <refname>mysql_affected_rows</refname> + <refname>mysql_affected_rows</refname> <refpurpose> Retourne le nombre de lignes affectées lors de la dernière opération SQL. </refpurpose> @@ -38,33 +37,32 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_affected_rows</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_affected_rows</function> retourne le nombre de lignes affectées - lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur associé à - l'identifiant de connexion. Si cet identifiant n'est pas précisé, cette fonction + <para> + <function>mysql_affected_rows</function> retourne le nombre de lignes affectées + lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur associé à + l'identifiant de connexion. Si cet identifiant n'est pas précisé, cette fonction utilise la dernière connexion ouverte. </para> <para> - Si la dernière requête était un DELETE sans clause WHERE, tous les enregistrements + Si la dernière requête était un DELETE sans clause WHERE, tous les enregistrements ont été effacés, mais cette fonction va retourner 0. </para> <para> - Cette commande n'est pas possible après un SELECT, car elle ne fonctionne qu'après - des commandes qui modifient les enregistrements. Pour connaître le nombre de ligne + Cette commande n'est pas possible après un SELECT, car elle ne fonctionne qu'après + des commandes qui modifient les enregistrements. Pour connaître le nombre de ligne retournées par un SELECT, utilisez <function>mysql_num_rows</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-change-user"> <refnamediv> - <refname>mysql_change_user</refname> + <refname>mysql_change_user</refname> <refpurpose> Change le nom de session de l'utilisateur actif. </refpurpose> @@ -75,20 +73,20 @@ <funcdef>int <function>mysql_change_user</function></funcdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>database</optional> </parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> <function>mysql_change_user</function> change l'utilisateur en cours de la session - active, ou sur la connexion spécifiée avec l'option + active, ou sur la connexion spécifiée avec l'option <parameter><optional>link_identifier</optional></parameter> Si une base est spécifiée, elle deviendra la base par défaut de l'utilisateur. Si une erreur de connexion survient, la connexion en cours restera active. @@ -100,7 +98,6 @@ </para></note> </refsect1> </refentry> - <refentry id="function.mysql-close"> <refnamediv> <refname>mysql_close</refname> @@ -110,24 +107,24 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_close</function></funcdef> - <paramdef>int + <paramdef>int <parameter> - <optional>link_identifier</optional> + <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> <para> Retourne TRUE en cas de succès, et FALSE sinon. </para> - <para> + <para> <function>mysql_close</function> ferme la connexion au serveur MySQL associée à l'identifiant link_identifier . Si cet identifiant n'est pas spécifié, cette commande s'applique à la dernière connexion ouverte. </para> - <note><para> - Notez que cette commande n'est pas nécessaire, car toutes les connexions non + <note><para> + Notez que cette commande n'est pas nécessaire, car toutes les connexions non persistantes seront automatiquement fermées à la fin du script. </para></note> - <para> - <function>mysql_close</function> ne ferme pas les connexions persistantes + <para> + <function>mysql_close</function> ne ferme pas les connexions persistantes générées par <function>mysql_pconnect</function>. </para> <example> @@ -142,12 +139,11 @@ ?> </programlisting> </example> - <para> + <para> Voir aussi <function>mysql_connect</function> et <function>mysql_pconnect</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-connect"> <refnamediv> <refname>mysql_connect</refname> @@ -157,7 +153,7 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_connect</function></funcdef> - <paramdef>string + <paramdef>string <parameter> <optional>hostname <optional>:port</optional> @@ -165,59 +161,59 @@ </optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>username</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>password</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> Retourne un identifiant positif de connexion en cas de succès, et sinon FALSE. </para> - <para> - <function>mysql_connect</function> établit une connexion à un serveur MySQL. Tous - les arguments sont optionnels, et s'ils manquent, les valeurs par défaut sont + <para> + <function>mysql_connect</function> établit une connexion à un serveur MySQL. Tous + les arguments sont optionnels, et s'ils manquent, les valeurs par défaut sont utilisées ( ('localhost', nom du propriétaire du process, mot de passe vide). - </para> + </para> <para> - Le nom d'hôte peut aussi inclure un numéro de port, sous la forme : - "hostname:port" ou un chemin jusqu'à une socket sous la forme - ":/path/to/socket" pour l'hôte localhost. + Le nom d'hôte peut aussi inclure un numéro de port, sous la forme : + "hostname:port" ou un chemin jusqu'à une socket sous la forme + ":/path/to/socket" pour l'hôte localhost. <note> <para> Le support des ":port" a été ajouté à partir de la version 3.0B4. </para> <para> - Le support de ":/path/to/socket" a été ajouté à partir de la + Le support de ":/path/to/socket" a été ajouté à partir de la version 3.0.10. </para> <para> - Vous pouvez supprimer le message d'erreur de connexion en ajoutant un arobase + Vous pouvez supprimer le message d'erreur de connexion en ajoutant un arobase '@' au nom de la fonction. </para> </note> </para> <para> - Si un second appel à <function>mysql_connect</function> est fait avec - les mêmes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va - retourner l'identifiant de la connexion déjà ouverte. + Si un second appel à <function>mysql_connect</function> est fait avec + les mêmes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va + retourner l'identifiant de la connexion déjà ouverte. </para> <para> - Le lien sera fermé automatiquement dès que l'exécution du script sera terminée, + 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> + </para> <example> <title>Exemple MySQL connect</title> <programlisting role="php"> <?php $link = mysql_connect ("kraemer", "marliesle", "secret") { or die ("Connexion impossible"); - } + } print ("Connexion réussie"); mysql_close ($link); ?> @@ -227,7 +223,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-create-db"> <refnamediv> <refname>mysql_create_db</refname> @@ -238,15 +233,15 @@ <funcsynopsis> <funcdef>int <function>mysql_create_db</function></funcdef> <paramdef>string <parameter>database name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_create_db</function> tente de créer une nouvelle base de données - sur le serveur associé à l'identifiant <parameter><optional>link_identifier</optional></parameter>, + <para> + <function>mysql_create_db</function> tente de créer une nouvelle base de données + sur le serveur associé à l'identifiant <parameter><optional>link_identifier</optional></parameter>, ou la dernière connexion ouverte. </para> <example> @@ -255,7 +250,7 @@ <?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); - } + } if (mysql_create_db ("my_db")) { print ("Base de données créée\n"); } else { @@ -264,16 +259,15 @@ ?> </programlisting> </example> - <para> - Pour des raisons de compatibilité ascendante, mysql_createdb() est toujours + <para> + Pour des raisons de compatibilité ascendante, mysql_createdb() est toujours utilisable. </para> - <para> + <para> Voir aussi <function>mysql_drop_db</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-data-seek"> <refnamediv> <refname>mysql_data_seek</refname> @@ -286,19 +280,18 @@ <paramdef>int <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcsynopsis> - <para> + <para> Retourne TRUE en cas de succès, et FALSE sinon. </para> - <para> - <function>mysql_data_seek</function> déplace le pointeur interne de résultat, - dans le résultat associé à l'identifiant de résultat <parameter>result_identifier</parameter>. - Il le fait pointer à la ligne <parameter>row_number</parameter>. Le prochain appel + <para> + <function>mysql_data_seek</function> déplace le pointeur interne de résultat, + dans le résultat associé à l'identifiant de résultat <parameter>result_identifier</parameter>. + Il le fait pointer à la ligne <parameter>row_number</parameter>. Le prochain appel à <function>mysql_fetch_row</function> retournera cette ligne. </para> <para> <parameter>Row_number</parameter> commence à 0. </para> - <example> <title>Exemple <function>mysql_data_seek</function></title> <programlisting role="php"> @@ -306,37 +299,29 @@ $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } - mysql_select_db ("samp_db") { or die ("Selection de base impossible"); } - $query = "SELECT last_name, first_name FROM friends"; $result = mysql_query ($query) { or die ("Requête impossible"); } - # récupère les lignes dans l'ordre inverse - for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) { if (!mysql_data_seek ($result, $i)) { printf ("Impossible d'atteindre la ligne %d\n", $i); continue; } - if(!($row = mysql_fetch_object ($result))) continue; - printf ("%s %s<BR>\n", $row->last_name, $row->first_name); } - mysql_free_result ($result); ?> </programlisting> </example> </refsect1> </refentry> - <refentry id="function.mysql-db-name"> <refnamediv> <refname>mysql_db_name</refname> @@ -349,34 +334,30 @@ <funcdef>int <function>mysql_db_name</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> <function>mysql_db_name</function> prend comme premier argument - le pointeur de résultat issu de <function>mysql_list_dbs</function>. + le pointeur de résultat issu de <function>mysql_list_dbs</function>. <parameter>row</parameter> est l'index dans le résultat. </para> - <para> Si une erreur survient, FALSE est retourné. Utilisez <function>mysql_errno</function> et <function>mysql_error</function> pour connaître la nature de l'erreur. </para> - <example> <title>Exemple <function>mysql_db_name</function></title> <programlisting role="php"> -<?php +<?php error_reporting(E_ALL); - mysql_connect('dbhost', 'username', 'password'); $db_list = mysql_list_dbs(); - $i = 0; $cnt = mysql_num_rows($db_list); while ($i < $cnt) { @@ -386,15 +367,12 @@ ?> </programlisting> </example> - <para> - Pour des raisons de compatibilité ascendante, <function>mysql_dbname</function> + Pour des raisons de compatibilité ascendante, mysql_dbname() est aussi accepté, mais obsolète. </para> - </refsect1> </refentry> - <refentry id="function.mysql-db-query"> <refnamediv> <refname>mysql_db_query</refname> @@ -406,24 +384,24 @@ <funcdef>int <function>mysql_db_query</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> Retourne un identifiant de résultat si la requête réussi, et FALSE sinon. </para> - <para> - <function>mysql_db_query</function> - Sélectionne une base de données et exécute une requête. Si l'identifiant - de lien <parameter>link_identifier</parameter> n'est pas précisé, la fonction - prendra par défaut la dernière base de données ouverte sur le serveur, et si elle - n'en trouve pas, elle tentera de se connecter, en utilisant la fonction + <para> + <function>mysql_db_query</function> + Sélectionne une base de données et exécute une requête. Si l'identifiant + de lien <parameter>link_identifier</parameter> n'est pas précisé, la fonction + prendra par défaut la dernière base de données ouverte sur le serveur, et si elle + n'en trouve pas, elle tentera de se connecter, en utilisant la fonction <function>mysql_connect</function>, sans arguments. </para> - <para> + <para> Voir aussi <function>mysql_connect</function>. </para> <para> @@ -431,7 +409,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-drop-db"> <refnamediv> <refname>mysql_drop_db</refname> @@ -442,37 +419,36 @@ <funcsynopsis> <funcdef>int <function>mysql_drop_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> 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 + </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><optional>link_identifier</optional></parameter>. </para> - <para> - Voir aussi <function>mysql_create_db</function>. - Pour des raisons de comptabilité ascendante, mysql_drop_db() est toujours + <para> + Voir aussi <function>mysql_create_db</function>. + Pour des raisons de comptabilité ascendante, mysql_drop_db() est toujours utilisable. </para> </refsect1> </refentry> - <refentry id="function.mysql-errno"> <refnamediv> - <refname>mysql_errno</refname> + <refname>mysql_errno</refname> <refpurpose>Retourne le numéro de message d'erreur de la dernière opération MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_errno</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> @@ -494,12 +470,11 @@ </programlisting> </informalexample> </para> - <para> + <para> Voir aussi <function>mysql_error</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-error"> <refnamediv> <refname>mysql_error</refname> @@ -511,15 +486,15 @@ <title>Description</title> <funcsynopsis> <funcdef>string <function>mysql_error</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> <para> - Les erreurs générées par mySQL ne se transforment plus en alerte. A la place, - elles sont accessibles via ces fonctions : + Les erreurs générées par mySQL ne se transforment plus en alerte. A la place, + elles sont accessibles via ces fonctions : <informalexample> <programlisting role="php"> <?php @@ -533,17 +508,16 @@ </programlisting> </informalexample> </para> - <para> + <para> Voir aussi <function>mysql_errno</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-array"> <refnamediv> - <refname>mysql_fetch_array</refname> + <refname>mysql_fetch_array</refname> <refpurpose> - Retourne une ligne de résultat sous la forme d'un tableau associatif. + Retourne une ligne de résultat sous la forme d'un tableau associatif. </refpurpose> </refnamediv> <refsect1> @@ -557,20 +531,20 @@ </parameter> </paramdef> </funcsynopsis> - <para> - Retourne un tableau qui contient la ligne demandée, ou FALSE si il ne reste plus + <para> + Retourne un tableau qui contient la ligne demandée, ou FALSE si il ne reste plus de ligne. </para> <para> - <function>mysql_fetch_array</function> est une version étendue de - <function>mysql_fetch_row</function>. En plus d'enregistrer les données sous - forme d'un tableau à indice numérique, elle peut aussi les enregistrer dans un + <function>mysql_fetch_array</function> est une version étendue de + <function>mysql_fetch_row</function>. En plus d'enregistrer les données sous + forme d'un tableau à indice numérique, elle peut aussi les enregistrer dans un tableau associatif, en utilisant les noms des champs comme indices. </para> <para> - Si plusieurs colonnes ont le même nom, la dernière colonne aura la priorité. - Pour accéder aux autres colonnes du même nom, vous devez utiliser l'index - numériques, ou faire un alias pour chaque colonne. + Si plusieurs colonnes ont le même nom, la dernière colonne aura la priorité. + Pour accéder aux autres colonnes du même nom, vous devez utiliser l'index + numériques, ou faire un alias pour chaque colonne. <informalexample> <programlisting> select t1.f1 as foo t2.f1 as bar from t1, t2 @@ -578,13 +552,13 @@ </informalexample> </para> <para> - Il est important de souligne que <function>mysql_fetch_array</function> N'est PAS - plus lente que <function>mysql_fetch_row</function>, tandis qu'elle ajoute un + Il est important de souligne que <function>mysql_fetch_array</function> N'est PAS + plus lente que <function>mysql_fetch_row</function>, tandis qu'elle ajoute un confort d'utilisation notable. </para> <para> - L'option <parameter>result_type</parameter> de - <function>mysql_fetch_array</function> est une constant qui peut prendre les + L'option <parameter>result_type</parameter> de + <function>mysql_fetch_array</function> est une constant qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM, et MYSQL_BOTH. </para> <para> @@ -593,7 +567,7 @@ <example> <title>mysql fetch array</title> <programlisting role="php"> -<?php +<?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_array($result)) { @@ -606,10 +580,9 @@ </example> </refsect1> </refentry> - <refentry id="function.mysql-fetch-assoc"> <refnamediv> - <refname>mysql_fetch_assoc</refname> + <refname>mysql_fetch_assoc</refname> <refpurpose> Lit une ligne de résultat dans un tableau associatif </refpurpose> @@ -622,36 +595,36 @@ <paramdef>int <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> <function>mysql_fetch_assoc</function> retourne un tableau associatif qui contient la ligne lue, ou bien FALSE, si il ne reste plus de lignes. </para> <para> - <function>mysql_fetch_assoc</function> est équivalente à + <function>mysql_fetch_assoc</function> est équivalente à <function>mysql_fetch_array</function> utilisée avec l'option MYSQL_ASSOC. Elle ne retourne qu'un tableau associatif. C'est le fonctionnement original de <function>mysql_fetch_array</function>. Si vous avez besoin d'indices numériques, utilisez <function>mysql_fetch_array</function>. </para> <para> - Si plusieurs colonnes on le même nom, la dernière aura la priorité. + Si plusieurs colonnes on le même nom, la dernière aura la priorité. Pour accéder aux autres colonnes du même nom, vous devez utiliser <function>mysql_fetch_array</function> et les indices numériques. </para> <para> Une chose importante à noter est que <function>mysql_fetch_assoc</function> - n'est PAS significativement plus lente que + n'est PAS significativement plus lente que <function>mysql_fetch_row</function>, alors qu'elle apporte un confort d'utilisation important. </para> <para> - Pour plus de détails, reportez vous à + Pour plus de détails, reportez vous à <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. </para> <example> <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -<?php +<?php mysql_connect ($host, $user, $password); $result = mysql_db_query ("database","select * from table"); while ($row = mysql_fetch_assoc ($result)) { @@ -664,13 +637,12 @@ </example> </refsect1> </refentry> - <refentry id="function.mysql-fetch-field"> <refnamediv> <refname>mysql_fetch_field</refname> <refpurpose> - Retourne les données enregistrées dans une colonne, à partir d'un résultat, et - retourne un objet. + Retourne les données enregistrées dans une colonne, à partir d'un résultat, et + retourne un objet. </refpurpose> </refnamediv> <refsect1> @@ -678,7 +650,7 @@ <funcsynopsis> <funcdef>object <function>mysql_fetch_field</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>field_offset</optional> </parameter> @@ -686,10 +658,10 @@ </funcsynopsis> <para> Retourne un objet contenant les données. - </para> + </para> <para> - <function>mysql_fetch_field</function> sert à obtenir des informations à propos - des champs, dans certaines requêtes. Si l'offset du champs n'est pas spécifié, + <function>mysql_fetch_field</function> sert à obtenir des informations à propos + des champs, dans certaines requêtes. Si l'offset du champs n'est pas spécifié, le champs suivant le dernier champs retourné, est retourné. </para> <para> @@ -697,57 +669,57 @@ <itemizedlist> <listitem> <simpara> - name - nom de la colonne + name - nom de la colonne </simpara> </listitem> <listitem> <simpara> - table - nom de la table de la colonne + table - nom de la table de la colonne </simpara> </listitem> <listitem> <simpara> - max_length - taille maximale de la colonne + max_length - taille maximale de la colonne </simpara> </listitem> <listitem> <simpara> - not_null - 1 si la colonne ne peut pas être NULL (attribut NOT NULL) + not_null - 1 si la colonne ne peut pas être NULL (attribut NOT NULL) </simpara> - </listitem> + </listitem> <listitem> <simpara> - primary_key - 1 si la colonne est une clé primaire (attribut PRIMARY KEY) + primary_key - 1 si la colonne est une clé primaire (attribut PRIMARY KEY) </simpara> - </listitem> + </listitem> <listitem> <simpara> - unique_key - 1 si la colonne est une clé unique (attribut UNIQUE) + unique_key - 1 si la colonne est une clé unique (attribut UNIQUE) </simpara> - </listitem> + </listitem> <listitem> <simpara> - multiple_key - 1 si la colonne est une clé non-unique + multiple_key - 1 si la colonne est une clé non-unique </simpara> - </listitem> + </listitem> <listitem> <simpara> - numeric - 1 si la colonne est numérique + numeric - 1 si la colonne est numérique </simpara> - </listitem> + </listitem> <listitem> <simpara> - blob - 1 si la colonne est BLOB + blob - 1 si la colonne est BLOB </simpara> </listitem> <listitem> <simpara> - type - le type de la colonne + type - le type de la colonne </simpara> </listitem> <listitem> <simpara> - unsigned - 1 si la colonne est non signé + unsigned - 1 si la colonne est non signé </simpara> </listitem> <listitem> @@ -762,10 +734,9 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-lengths"> <refnamediv> - <refname>mysql_fetch_lengths</refname> + <refname>mysql_fetch_lengths</refname> <refpurpose> Retourne la taille de chaque colonne d'une ligne de résultat. </refpurpose> @@ -776,23 +747,22 @@ <funcdef>array <function>mysql_fetch_lengths</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> - <para> - Retourne un tableau avec la taille de chaque colonne de la dernière ligne retournée + <para> + Retourne un tableau avec la taille de chaque colonne de la dernière ligne retournée par <function>mysql_fetch_row</function>, sinon FALSE. - </para> + </para> <para> - <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne - de la dernière ligne retournée par <function>mysql_fetch_row</function>, - <function>mysql_fetch_array</function>, et - <function>mysql_fetch_object</function> dans un tableau, en commencant à la + <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne + de la dernière ligne retournée par <function>mysql_fetch_row</function>, + <function>mysql_fetch_array</function>, et + <function>mysql_fetch_object</function> dans un tableau, en commencant à la position. - </para> - <para> + </para> + <para> Voir aussi <function>mysql_fetch_row</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-object"> <refnamediv> <refname>mysql_fetch_object</refname> @@ -809,28 +779,28 @@ </parameter> </paramdef> </funcsynopsis> - <para> - Retourne un objet dont les propriétés correspondent à une ligne d'un résultat, + <para> + Retourne un objet dont les propriétés correspondent à une ligne d'un résultat, ou FALSE si il n'y a plus d'autres lignes. </para> - <para> - <function>mysql_fetch_object</function> est identique à - <function>mysql_fetch_array</function>, à la différence qu'elle retourne un objet - à la place d'un tableau. Vous pourrez ainsi accéder aux valeurs des champs par + <para> + <function>mysql_fetch_object</function> est identique à + <function>mysql_fetch_array</function>, à la différence qu'elle retourne un objet + à la place d'un tableau. Vous pourrez ainsi accéder aux valeurs des champs par leur nom, mais plus par leur offset (les nombres ne sont pas des noms MySQL). </para> <para> - L'argument optionnel <parameter>result_typ</parameter> est une constante qui + L'argument optionnel <parameter>result_typ</parameter> est une constante qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM, et MYSQL_BOTH. </para> <para> - Concernant la vitesse, cette fonction est aussi rapide que - <function>mysql_fetch_array</function>, et presque aussi rapide que + Concernant la vitesse, cette fonction est aussi rapide que + <function>mysql_fetch_array</function>, et presque aussi rapide que <function>mysql_fetch_row</function> (la différence est insignifiante) <example> <title>mysql fetch object</title> <programlisting role="php"> -<?php +<?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_object($result)) { @@ -842,12 +812,11 @@ </programlisting> </example> </para> - <para> + <para> Voir aussi <function>mysql_fetch_array</function> et <function>mysql_fetch_row</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-row"> <refnamediv> <refname>mysql_fetch_row</refname> @@ -859,30 +828,29 @@ <funcdef>array <function>mysql_fetch_row</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> - <para> - Retourne un tableau énuméré qui correspond à la ligne demandée, ou FALSE + <para> + Retourne un tableau énuméré qui correspond à la ligne demandée, ou FALSE si il ne reste plus de ligne. </para> <para> - <function>mysql_fetch_row</function> va rechercher une ligne dans le résultat - associé à l'identifiant de résultat spécifié. La ligne est retournée sous la - forme d'un tableau. Chaque colonne est enregistré sous la forme d'un tableau + <function>mysql_fetch_row</function> va rechercher une ligne dans le résultat + associé à l'identifiant de résultat spécifié. La ligne est retournée sous la + forme d'un tableau. Chaque colonne est enregistré sous la forme d'un tableau commencant à la position 0. </para> <para> - Les appels suivants à <function>mysql_fetch_row</function> retourneront la ligne + Les appels suivants à <function>mysql_fetch_row</function> retourneront la ligne suivante dans le résultat, ou FALSE si il n'y a plus de ligne disponible. </para> <para> Voir aussi <function>mysql_fetch_array</function>, <function>mysql_fetch_object</function>, <function>mysql_data_seek</function>, - <function>mysql_fetch_lengths</function>, et + <function>mysql_fetch_lengths</function>, et <function>mysql_result</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-flags"> <refnamediv> <refname>mysql_field_flags</refname> @@ -897,27 +865,26 @@ <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> - <para> - <function>mysql_field_flags</function> retourne le sémaphore associé au champs + <para> + <function>mysql_field_flags</function> retourne le sémaphore associé au champs spécifié par <parameter>field_offset</parameter>. Les sémaphores sont retournés - comme des mots, séparés par des espaces, ce qui les rend facile à séparer, avec la + comme des mots, séparés par des espaces, ce qui les rend facile à séparer, avec la commande <function>explode</function>. </para> <para> - Les valeurs suivantes (pour une version suffisamment récente de MySQL) sont - disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", + Les valeurs suivantes (pour une version suffisamment récente de MySQL) sont + disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_fieldflags() peut encore être + <para> + Pour des raisons de compatibilité ascendante, mysql_fieldflags() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-name"> <refnamediv> - <refname>mysql_field_name</refname> + <refname>mysql_field_name</refname> <refpurpose> Retourne le nom d'une colonne </refpurpose> @@ -931,9 +898,9 @@ </funcsynopsis> <para> <function>mysql_field_name</function> retourne le nom d'une colonne. - Les arguments de la fonction sont un identifiant de résultat - <parameter>result</parameter> et l'index du champs, - ie.<literal>mysql_field_name($result,2);</literal> + Les arguments de la fonction sont un identifiant de résultat + <parameter>result</parameter> et l'index du champs, + ie.<literal>mysql_field_name($result,2);</literal> </para> <para> Retournera le nom du deuxième champs dans le résultat associé à $result. @@ -944,11 +911,9 @@ </para> </refsect1> </refentry> - - <refentry id="function.mysql-field-len"> <refnamediv> - <refname>mysql_field_len</refname> + <refname>mysql_field_len</refname> <refpurpose> Retourne la longueur du champs spécifié. </refpurpose> @@ -961,15 +926,14 @@ <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> <para> - <function>mysql_field_len</function> retourne la taille du champs spécifié. + <function>mysql_field_len</function> retourne la taille du champs spécifié. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_fieldlen() peut encore être + Pour des raisons de compatibilité ascendante, mysql_fieldlen() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-seek"> <refnamediv> <refname>mysql_field_seek</refname> @@ -985,8 +949,8 @@ <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> <para> - Place le pointeur de résultat sur le champs spécifié. Lors du prochain appel à - <function>mysql_fetch_field</function> qui n'aura pas d'argument d'index de + 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> @@ -994,7 +958,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-field-table"> <refnamediv> <refname>mysql_field_table</refname> @@ -1009,13 +972,12 @@ <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> - <para> - Retourne le nom de la table oú se trouve une colonne. Pour des raisons de + <para> + Retourne le nom de la table oú se trouve une colonne. Pour des raisons de compatibilité ascendante, mysql_fieldtable() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-type"> <refnamediv> <refname>mysql_field_type</refname> @@ -1031,14 +993,14 @@ <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> <para> - <function>mysql_field_type</function> est similaire à la fonction - <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est - le type du champs qui est retourné. Il vaudra "int", "real", "string", "blob", ou + <function>mysql_field_type</function> est similaire à la fonction + <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est + le type du champs qui est retourné. Il vaudra "int", "real", "string", "blob", ou d'autres, comme détaillé dans la documentation MySQL. <example> <title>Types mysql field</title> <programlisting role="php"> -<?php +<?php mysql_connect("localhost:3306"); mysql_select_db("wisconsin"); $result = mysql_query("SELECT * FROM onek"); @@ -1047,7 +1009,7 @@ $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>"; +echo "The table has the following fields <BR>"; while ($i < $fields) { $type = mysql_field_type ($result, $i); $name = mysql_field_name ($result, $i); @@ -1061,13 +1023,12 @@ </programlisting> </example> </para> - <para> + <para> Pour des raisons de compatibilité ascendante, mysql_fieldtype() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-free-result"> <refnamediv> <refname>mysql_free_result</refname> @@ -1080,17 +1041,16 @@ <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> <para> - <function>mysql_free_result</function> n'est à appeler que si vous avez peur - d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire + <function>mysql_free_result</function> n'est à appeler que si vous avez peur + d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire associée à l'identifiant de résultat sera automatiquement libérée. </para> <para> - Pour des raisons de compatibilité ascendante,mysql_freeresult() peut encore être + Pour des raisons de compatibilité ascendante,mysql_freeresult() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-insert-id"> <refnamediv> <refname>mysql_insert_id</refname> @@ -1102,23 +1062,22 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_insert_id</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_insert_id</function> retourne le dernier identifiant généré par - un champs de type AUTO_INCREMENTED. Cette fonction ne prend aucun argument. Elle + <para> + <function>mysql_insert_id</function> retourne le dernier identifiant généré par + un champs de type AUTO_INCREMENTED. Cette fonction ne prend aucun argument. Elle retourne le dernier identifiant généré par la dernière fonction INSERT effectuée. </para> </refsect1> </refentry> - <refentry id="function.mysql-list-dbs"> <refnamediv> - <refname>mysql_list_dbs</refname> + <refname>mysql_list_dbs</refname> <refpurpose> Liste les bases de données disponibles sur le serveur MySQL. </refpurpose> @@ -1127,7 +1086,7 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_list_dbs</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> @@ -1137,12 +1096,11 @@ <function>mysql_list_dbs</function> retournera un identifiant de résultat, qui contiendra les noms des bases de données disponsibles sur le serveur MySQL. Utilisez la fonction <function>mysql_tablename</function> pour lire toutes les bases de données. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listdbs() + Pour des raisons de compatibilité ascendante, mysql_listdbs() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> @@ -1154,36 +1112,35 @@ <funcdef>int <function>mysql_list_fields</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>string <parameter>table_name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> <para> - <function>mysql_list_fields</function> recherche les informations à propos de la - table spécifiée. Les arguments sont la base de données, et le nom de la table. Un - pointeur de résultat est retourné, et pourra être passé à + <function>mysql_list_fields</function> recherche les informations à propos de la + table spécifiée. Les arguments sont la base de données, et le nom de la table. Un + pointeur de résultat est retourné, et pourra être passé à <function>mysql_field_flags</function>, <function>mysql_field_len</function>, - <function>mysql_field_name</function> et + <function>mysql_field_name</function> et <function>mysql_field_type</function>. </para> <para> - Un identifiant de résultat est un entier positif. La fonction retourne -1 - si une erreur survient. Une chaîne décrivant le problème - rencontré sera placée dans la variable - <literal>$phperrmsg</literal>, et, à moins que la fonction n'ait - été appelée sous la forme <literal>@mysql()</literal>, + Un identifiant de résultat est un entier positif. La fonction retourne -1 + si une erreur survient. Une chaîne décrivant le problème + rencontré sera placée dans la variable + <literal>$phperrmsg</literal>, et, à moins que la fonction n'ait + été appelée sous la forme <literal>@mysql()</literal>, cette erreur sera aussi affichée. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listfields() + Pour des raisons de compatibilité ascendante, mysql_listfields() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-list-tables"> <refnamediv> <refname>mysql_list_tables</refname> @@ -1194,25 +1151,24 @@ <funcsynopsis> <funcdef>int <function>mysql_list_tables</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_list_tables</function> prend le nom d'une base de données comme - argument, et retourne un identifiant de résultat, qui contiendra la liste des - tables. La fonction <function>mysql_tablename</function> est le meilleur moyen + <para> + <function>mysql_list_tables</function> prend le nom d'une base de données comme + argument, et retourne un identifiant de résultat, qui contiendra la liste des + tables. La fonction <function>mysql_tablename</function> est le meilleur moyen d'extraire les noms des tables depuis l'identifiant de résultat. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listtables() + Pour des raisons de compatibilité ascendante, mysql_listtables() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> @@ -1224,20 +1180,19 @@ <funcdef>int <function>mysql_num_fields</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> - <para> + <para> <function>mysql_num_fields</function> retourne le nombre de champs d'un résultat. </para> - <para> + <para> Voir aussi <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function>, <function>mysql_num_rows</function>. </para> <para> - Pour des raisons de compatibilité ascendante mysql_numfields() + Pour des raisons de compatibilité ascendante mysql_numfields() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-num-rows"> <refnamediv> <refname>mysql_num_rows</refname> @@ -1261,29 +1216,28 @@ </title> <programlisting role="php"> <?php -$conn = mysql_connect("adresse de l'hote", "utilisateur", "mot de passe"); +$conn = mysql_connect("adresse de l'hote", "utilisateur", "mot de passe"); mysql_select_db("base",$conn); // nécessaire si vous avez plusieurs bases -$Resultfornummembers = mysql_query("SELECT * FROM Accounts",$conn); -$NumMembers = mysql_num_rows($Resultfornummembers); +$Resultfornummembers = mysql_query("SELECT * FROM Accounts",$conn); +$NumMembers = mysql_num_rows($Resultfornummembers); echo "$NumMembers Membres"; -?> +?> </programlisting> </example> <para> - Voir aussi <function>mysql_db_query</function>, - <function>mysql_query</function> + Voir aussi <function>mysql_db_query</function>, + <function>mysql_query</function> et <function>mysql_fetch_row</function>. </para> <para> - Pour des raisons de compatibilité ascendante mysql_numrows() est encore + Pour des raisons de compatibilité ascendante mysql_numrows() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-pconnect"> <refnamediv> - <refname>mysql_pconnect</refname> + <refname>mysql_pconnect</refname> <refpurpose> Ouvre une connexion persistante à un serveur MySQL. </refpurpose> @@ -1292,34 +1246,34 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_pconnect</function></funcdef> - <paramdef>string + <paramdef>string <parameter> <optional>hostname - <optional>:port</optional> + <optional>:port</optional> <optional>:/path/to/socket</optional> </optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>username</optional></parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>password</optional></parameter> </paramdef> </funcsynopsis> - <para> - Retourne un lien persistant positif en cas de succès, et sinon FALSE en cas + <para> + Retourne un lien persistant positif en cas de succès, et sinon FALSE en cas d'erreur. </para> <para> - <function>mysql_pconnect</function> établit uen connexion persistante à un serveur - MySQL. Tous les arguments sont optionnels, et des valeurs par défaut seront - utilisérs en cas d'omission ('localhost', nom d'utilisateur propriétaire + <function>mysql_pconnect</function> établit uen connexion persistante à un serveur + MySQL. Tous les arguments sont optionnels, et des valeurs par défaut seront + utilisérs en cas d'omission ('localhost', nom d'utilisateur propriétaire du processus, mot de passe vide). - </para> + </para> <para> - Le nom de l'hôte peut aussi inclure le numéro de port, c'est à dire - "hostname:port" ou un chemin jusqu'à la socket + Le nom de l'hôte peut aussi inclure le numéro de port, c'est à dire + "hostname:port" ou un chemin jusqu'à la socket ":/path/to/socket" pour l'hôte local. <note> <para> @@ -1329,29 +1283,28 @@ Le support de ":/path/to/socket" a été ajouté dans en version 3.0.10. </para> </note> - </para> + </para> <para> - <function>mysql_pconnect</function> se comporte exactement comme - <function>mysql_connect</function>, mais avec deux différences majeures : + <function>mysql_pconnect</function> se comporte exactement comme + <function>mysql_connect</function>, mais avec deux différences majeures : </para> - <para> - Premièrement, lors de la connexion, la fonction essaie de trouver une connexion - permanante déjà ouverte sur cet hote, avec le même nom d'utilisateur et de mot - de passe. Si une telle connexion est trouvée, son identifiant est retourné, sans + <para> + Premièrement, lors de la connexion, la fonction essaie de trouver une connexion + permanante déjà ouverte sur cet hote, avec le même nom d'utilisateur et de mot + de passe. Si une telle connexion est trouvée, son identifiant est retourné, sans ouvrir de nouvelle connexion. </para> - <para> - Deuxièmement, la connexion au serveur MySQL ne sera pas terminée avec la fin - du script. Au lieu de cela, le lien sera conservé pour un prochain accès - (<function>mysql_close</function> ne terminera pas une connexion persistante + <para> + Deuxièmement, la connexion au serveur MySQL ne sera pas terminée avec la fin + du script. Au lieu de cela, le lien sera conservé pour un prochain accès + (<function>mysql_close</function> ne terminera pas une connexion persistante établie par <function>mysql_pconnect</function>). </para> - <para> + <para> C'est pourquoi ce type de connexion est dite 'persistante'. </para> </refsect1> </refentry> - <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> @@ -1362,31 +1315,31 @@ <funcsynopsis> <funcdef>int <function>mysql_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>link_identifier</optional></parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_query</function> envoie une requête SQL à la base de données + <para> + <function>mysql_query</function> envoie une requête SQL à la base de données actuellement active sur le serveur MysQL. Si <parameter>link_identifier</parameter> - n'est pas précisé, la dernière connexion est utilisée. Si aucune connexion n'a - été ouverte, la fonction tentera d'en ouvrir une, avec la fonction - <function>mysql_connect</function> mais sans aucun paramètre (c'est à dire avec + n'est pas précisé, la dernière connexion est utilisée. Si aucune connexion n'a + été ouverte, la fonction tentera d'en ouvrir une, avec la fonction + <function>mysql_connect</function> mais sans aucun paramètre (c'est à dire avec les valeurs par défaut). </para> <para> <function>mysql_connect</function> </para> <para> - <function>mysql_query</function> retourne TRUE ou FALSE, pour indiquer le succès - ou l'échec de la requête. En cas de retour TRUE, la requête était valide et a - pu être exécuté sur le serveur. Cela n'indique pas le nombre de ligne affectées, - ou retournées. Il est parfaitement possible qu'une requête valide n'affecte aucune + <function>mysql_query</function> retourne TRUE ou FALSE, pour indiquer le succès + ou l'échec de la requête. En cas de retour TRUE, la requête était valide et a + pu être exécuté sur le serveur. Cela n'indique pas le nombre de ligne affectées, + ou retournées. Il est parfaitement possible qu'une requête valide n'affecte aucune ligne ou ne retourne aucune ligne. </para> <para> - L'exemple suivant est syntaxiquement invalide, ce qui conduit - <function>mysql_query</function> à l'échec, et retourne FALSE: + L'exemple suivant est syntaxiquement invalide, ce qui conduit + <function>mysql_query</function> à l'échec, et retourne FALSE: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1400,7 +1353,7 @@ <para> L'exemple suivant est sémantiquement invalide si <literal>my_col</literal> n'est pas une colonne de la table <literal>my_tbl</literal>, ce qui conduit - <function>mysql_query</function> à l'échec, et retourne FALSE : + <function>mysql_query</function> à l'échec, et retourne FALSE : <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1412,16 +1365,16 @@ </example> </para> <para> - <function>mysql_query</function> échouera aussi et retournera aussi FALSE si les + <function>mysql_query</function> échouera aussi et retournera aussi FALSE si les droits d'accès ne sont pas suffisants. </para> <para> - En supposant que la requête réussisse, vous pouvez appeler - <function>mysql_affected_rows</function> pour connaître le nombre de lignes - affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). - Pour les commandes SELECT , <function>mysql_query</function> retourne un + En supposant que la requête réussisse, vous pouvez appeler + <function>mysql_affected_rows</function> pour connaître le nombre de lignes + affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). + Pour les commandes SELECT , <function>mysql_query</function> retourne un identifiant de résultat que vous pouvez passer à <function>mysql_result</function>. - Lorsque vous avez terminé avec le résultat, libérez la mémoire avec + Lorsque vous avez terminé avec le résultat, libérez la mémoire avec <function>mysql_free_result</function>. </para> <para> @@ -1431,7 +1384,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-result"> <refnamediv> <refname>mysql_result</refname> @@ -1443,37 +1395,36 @@ <funcdef>int <function>mysql_result</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcsynopsis> <para> - <function>mysql_result</function> retourne le contenu d'un champs dans un - résultat MySQL. L'argument de champs <parameter>row</parameter> peut être un - offset de champs, ou le nom du champs, ou le nom de la table + point + le nom - du champs (table.champs). Si la colonne a été aliasée, utilisez de préférence + <function>mysql_result</function> retourne le contenu d'un champs dans un + résultat MySQL. L'argument de champs <parameter>row</parameter> peut être un + offset de champs, ou le nom du champs, ou le nom de la table + point + le nom + du champs (table.champs). Si la colonne a été aliasée, utilisez de préférence l'alias. </para> <para> - Lorsque vous travaillez sur des résultats de grande taille, vous devriez utiliser - une des fonctions qui vont rechercher une ligne entière dans un tableau. - Ces fonctions sont NETTEMENT plus rapides. De plus, l'utilisation d'un offset + Lorsque vous travaillez sur des résultats de grande taille, vous devriez utiliser + une des fonctions qui vont rechercher une ligne entière dans un tableau. + Ces fonctions sont NETTEMENT plus rapides. De plus, l'utilisation d'un offset numériques est aussi beaucoup plus rapide que de spécifier un nom litéral. </para> <para> - Les appels <function>mysql_result</function> ne devraient pas être mélangés + Les appels <function>mysql_result</function> ne devraient pas être mélangés avec d'autres fonctions qui travaillent aussi sur le résultat. </para> <para> - Alternatives à haut rendement, RECOMMANDEES : - <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et + Alternatives à haut rendement, RECOMMANDEES : + <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et <function>mysql_fetch_object</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-select-db"> <refnamediv> <refname>mysql_select_db</refname> @@ -1484,37 +1435,36 @@ <funcsynopsis> <funcdef>int <function>mysql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> 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 l'identifiant de connexion. Si aucun identifiant n'est - spécifié, la dernière connexion est utilisée. S'il n'y a pas de dernière - connexion, la fonction tentera de se connecter seule, avec + <para> + <function>mysql_select_db</function> change la base de données active sur la + connexion représentée par l'identifiant de connexion. Si aucun identifiant n'est + spécifié, la dernière connexion est utilisée. S'il n'y a pas de dernière + connexion, la fonction tentera de se connecter seule, avec <function>mysql_connect</function> et les paramètres par défaut. </para> <para> Toutes les requêtes suivantes avec <function>mysql_query</function> seront faites avec la base de données active. </para> - <para> - Voir aussi <function>mysql_connect</function>, <function>mysql_pconnect</function>, et + <para> + Voir aussi <function>mysql_connect</function>, <function>mysql_pconnect</function>, et <function>mysql_query</function>. </para> <para> - Pour des raisons de compatibilité ascendante mysql_selectdb() est - encore disponible. + Pour des raisons de compatibilité ascendante mysql_selectdb() est + encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-tablename"> <refnamediv> <refname>mysql_tablename</refname> @@ -1527,15 +1477,15 @@ <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> </funcsynopsis> - <para> - <function>mysql_tablename</function> prend le pointeur de résultat obtenu avec - <function>mysql_list_tables</function> ou bien un index entier, et retourne le - nom de la table. La fonction <function>mysql_num_rows</function> peut être + <para> + <function>mysql_tablename</function> prend le pointeur de résultat obtenu avec + <function>mysql_list_tables</function> ou bien un index entier, et retourne le + nom de la table. La fonction <function>mysql_num_rows</function> peut être utilisée pour déterminer le nombre de tables dans le pointeur de résultat. <example> <title>Exemple <function>mysql_tablename</function></title> <programlisting role="php"> -<?php +<?php mysql_connect ("localhost:3306"); $result = mysql_list_tables ("wisconsin"); $i = 0; @@ -1550,9 +1500,7 @@ </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/mysql.xml diff -u phpdoc/fr/functions/mysql.xml:1.6 phpdoc/fr/functions/mysql.xml:1.7 --- phpdoc/fr/functions/mysql.xml:1.6 Wed Nov 29 05:26:07 2000 +++ phpdoc/fr/functions/mysql.xml Wed Dec 6 05:05:11 2000 @@ -17,7 +17,7 @@ MySQL, et évitera les conflits. </simpara> <simpara> - Plus d'informations sont disponibles à + Plus d'informations sont disponibles à <ulink url="http://www.mysql.com/">http://www.mysql.com/</ulink>. </simpara> <simpara> @@ -26,10 +26,9 @@ chez <ulink url="http://dev.nexen.net/docs/mysql/">nexen</ulink>. </simpara> </partintro> - <refentry id="function.mysql-affected-rows"> <refnamediv> - <refname>mysql_affected_rows</refname> + <refname>mysql_affected_rows</refname> <refpurpose> Retourne le nombre de lignes affectées lors de la dernière opération SQL. </refpurpose> @@ -38,33 +37,32 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_affected_rows</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_affected_rows</function> retourne le nombre de lignes affectées - lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur associé à - l'identifiant de connexion. Si cet identifiant n'est pas précisé, cette fonction + <para> + <function>mysql_affected_rows</function> retourne le nombre de lignes affectées + lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur associé à + l'identifiant de connexion. Si cet identifiant n'est pas précisé, cette fonction utilise la dernière connexion ouverte. </para> <para> - Si la dernière requête était un DELETE sans clause WHERE, tous les enregistrements + Si la dernière requête était un DELETE sans clause WHERE, tous les enregistrements ont été effacés, mais cette fonction va retourner 0. </para> <para> - Cette commande n'est pas possible après un SELECT, car elle ne fonctionne qu'après - des commandes qui modifient les enregistrements. Pour connaître le nombre de ligne + Cette commande n'est pas possible après un SELECT, car elle ne fonctionne qu'après + des commandes qui modifient les enregistrements. Pour connaître le nombre de ligne retournées par un SELECT, utilisez <function>mysql_num_rows</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-change-user"> <refnamediv> - <refname>mysql_change_user</refname> + <refname>mysql_change_user</refname> <refpurpose> Change le nom de session de l'utilisateur actif. </refpurpose> @@ -75,20 +73,20 @@ <funcdef>int <function>mysql_change_user</function></funcdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>database</optional> </parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> <function>mysql_change_user</function> change l'utilisateur en cours de la session - active, ou sur la connexion spécifiée avec l'option + active, ou sur la connexion spécifiée avec l'option <parameter><optional>link_identifier</optional></parameter> Si une base est spécifiée, elle deviendra la base par défaut de l'utilisateur. Si une erreur de connexion survient, la connexion en cours restera active. @@ -100,7 +98,6 @@ </para></note> </refsect1> </refentry> - <refentry id="function.mysql-close"> <refnamediv> <refname>mysql_close</refname> @@ -110,24 +107,24 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_close</function></funcdef> - <paramdef>int + <paramdef>int <parameter> - <optional>link_identifier</optional> + <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> <para> Retourne TRUE en cas de succès, et FALSE sinon. </para> - <para> + <para> <function>mysql_close</function> ferme la connexion au serveur MySQL associée à l'identifiant link_identifier . Si cet identifiant n'est pas spécifié, cette commande s'applique à la dernière connexion ouverte. </para> - <note><para> - Notez que cette commande n'est pas nécessaire, car toutes les connexions non + <note><para> + Notez que cette commande n'est pas nécessaire, car toutes les connexions non persistantes seront automatiquement fermées à la fin du script. </para></note> - <para> - <function>mysql_close</function> ne ferme pas les connexions persistantes + <para> + <function>mysql_close</function> ne ferme pas les connexions persistantes générées par <function>mysql_pconnect</function>. </para> <example> @@ -142,12 +139,11 @@ ?> </programlisting> </example> - <para> + <para> Voir aussi <function>mysql_connect</function> et <function>mysql_pconnect</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-connect"> <refnamediv> <refname>mysql_connect</refname> @@ -157,7 +153,7 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_connect</function></funcdef> - <paramdef>string + <paramdef>string <parameter> <optional>hostname <optional>:port</optional> @@ -165,59 +161,59 @@ </optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>username</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>password</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> Retourne un identifiant positif de connexion en cas de succès, et sinon FALSE. </para> - <para> - <function>mysql_connect</function> établit une connexion à un serveur MySQL. Tous - les arguments sont optionnels, et s'ils manquent, les valeurs par défaut sont + <para> + <function>mysql_connect</function> établit une connexion à un serveur MySQL. Tous + les arguments sont optionnels, et s'ils manquent, les valeurs par défaut sont utilisées ( ('localhost', nom du propriétaire du process, mot de passe vide). - </para> + </para> <para> - Le nom d'hôte peut aussi inclure un numéro de port, sous la forme : - "hostname:port" ou un chemin jusqu'à une socket sous la forme - ":/path/to/socket" pour l'hôte localhost. + Le nom d'hôte peut aussi inclure un numéro de port, sous la forme : + "hostname:port" ou un chemin jusqu'à une socket sous la forme + ":/path/to/socket" pour l'hôte localhost. <note> <para> Le support des ":port" a été ajouté à partir de la version 3.0B4. </para> <para> - Le support de ":/path/to/socket" a été ajouté à partir de la + Le support de ":/path/to/socket" a été ajouté à partir de la version 3.0.10. </para> <para> - Vous pouvez supprimer le message d'erreur de connexion en ajoutant un arobase + Vous pouvez supprimer le message d'erreur de connexion en ajoutant un arobase '@' au nom de la fonction. </para> </note> </para> <para> - Si un second appel à <function>mysql_connect</function> est fait avec - les mêmes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va - retourner l'identifiant de la connexion déjà ouverte. + Si un second appel à <function>mysql_connect</function> est fait avec + les mêmes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va + retourner l'identifiant de la connexion déjà ouverte. </para> <para> - Le lien sera fermé automatiquement dès que l'exécution du script sera terminée, + 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> + </para> <example> <title>Exemple MySQL connect</title> <programlisting role="php"> <?php $link = mysql_connect ("kraemer", "marliesle", "secret") { or die ("Connexion impossible"); - } + } print ("Connexion réussie"); mysql_close ($link); ?> @@ -227,7 +223,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-create-db"> <refnamediv> <refname>mysql_create_db</refname> @@ -238,15 +233,15 @@ <funcsynopsis> <funcdef>int <function>mysql_create_db</function></funcdef> <paramdef>string <parameter>database name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_create_db</function> tente de créer une nouvelle base de données - sur le serveur associé à l'identifiant <parameter><optional>link_identifier</optional></parameter>, + <para> + <function>mysql_create_db</function> tente de créer une nouvelle base de données + sur le serveur associé à l'identifiant <parameter><optional>link_identifier</optional></parameter>, ou la dernière connexion ouverte. </para> <example> @@ -255,7 +250,7 @@ <?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); - } + } if (mysql_create_db ("my_db")) { print ("Base de données créée\n"); } else { @@ -264,16 +259,15 @@ ?> </programlisting> </example> - <para> - Pour des raisons de compatibilité ascendante, mysql_createdb() est toujours + <para> + Pour des raisons de compatibilité ascendante, mysql_createdb() est toujours utilisable. </para> - <para> + <para> Voir aussi <function>mysql_drop_db</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-data-seek"> <refnamediv> <refname>mysql_data_seek</refname> @@ -286,19 +280,18 @@ <paramdef>int <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcsynopsis> - <para> + <para> Retourne TRUE en cas de succès, et FALSE sinon. </para> - <para> - <function>mysql_data_seek</function> déplace le pointeur interne de résultat, - dans le résultat associé à l'identifiant de résultat <parameter>result_identifier</parameter>. - Il le fait pointer à la ligne <parameter>row_number</parameter>. Le prochain appel + <para> + <function>mysql_data_seek</function> déplace le pointeur interne de résultat, + dans le résultat associé à l'identifiant de résultat <parameter>result_identifier</parameter>. + Il le fait pointer à la ligne <parameter>row_number</parameter>. Le prochain appel à <function>mysql_fetch_row</function> retournera cette ligne. </para> <para> <parameter>Row_number</parameter> commence à 0. </para> - <example> <title>Exemple <function>mysql_data_seek</function></title> <programlisting role="php"> @@ -306,37 +299,29 @@ $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); } - mysql_select_db ("samp_db") { or die ("Selection de base impossible"); } - $query = "SELECT last_name, first_name FROM friends"; $result = mysql_query ($query) { or die ("Requête impossible"); } - # récupère les lignes dans l'ordre inverse - for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) { if (!mysql_data_seek ($result, $i)) { printf ("Impossible d'atteindre la ligne %d\n", $i); continue; } - if(!($row = mysql_fetch_object ($result))) continue; - printf ("%s %s<BR>\n", $row->last_name, $row->first_name); } - mysql_free_result ($result); ?> </programlisting> </example> </refsect1> </refentry> - <refentry id="function.mysql-db-name"> <refnamediv> <refname>mysql_db_name</refname> @@ -349,34 +334,30 @@ <funcdef>int <function>mysql_db_name</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> <function>mysql_db_name</function> prend comme premier argument - le pointeur de résultat issu de <function>mysql_list_dbs</function>. + le pointeur de résultat issu de <function>mysql_list_dbs</function>. <parameter>row</parameter> est l'index dans le résultat. </para> - <para> Si une erreur survient, FALSE est retourné. Utilisez <function>mysql_errno</function> et <function>mysql_error</function> pour connaître la nature de l'erreur. </para> - <example> <title>Exemple <function>mysql_db_name</function></title> <programlisting role="php"> -<?php +<?php error_reporting(E_ALL); - mysql_connect('dbhost', 'username', 'password'); $db_list = mysql_list_dbs(); - $i = 0; $cnt = mysql_num_rows($db_list); while ($i < $cnt) { @@ -386,15 +367,12 @@ ?> </programlisting> </example> - <para> - Pour des raisons de compatibilité ascendante, <function>mysql_dbname</function> + Pour des raisons de compatibilité ascendante, mysql_dbname() est aussi accepté, mais obsolète. </para> - </refsect1> </refentry> - <refentry id="function.mysql-db-query"> <refnamediv> <refname>mysql_db_query</refname> @@ -406,24 +384,24 @@ <funcdef>int <function>mysql_db_query</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> Retourne un identifiant de résultat si la requête réussi, et FALSE sinon. </para> - <para> - <function>mysql_db_query</function> - Sélectionne une base de données et exécute une requête. Si l'identifiant - de lien <parameter>link_identifier</parameter> n'est pas précisé, la fonction - prendra par défaut la dernière base de données ouverte sur le serveur, et si elle - n'en trouve pas, elle tentera de se connecter, en utilisant la fonction + <para> + <function>mysql_db_query</function> + Sélectionne une base de données et exécute une requête. Si l'identifiant + de lien <parameter>link_identifier</parameter> n'est pas précisé, la fonction + prendra par défaut la dernière base de données ouverte sur le serveur, et si elle + n'en trouve pas, elle tentera de se connecter, en utilisant la fonction <function>mysql_connect</function>, sans arguments. </para> - <para> + <para> Voir aussi <function>mysql_connect</function>. </para> <para> @@ -431,7 +409,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-drop-db"> <refnamediv> <refname>mysql_drop_db</refname> @@ -442,37 +419,36 @@ <funcsynopsis> <funcdef>int <function>mysql_drop_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> 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 + </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><optional>link_identifier</optional></parameter>. </para> - <para> - Voir aussi <function>mysql_create_db</function>. - Pour des raisons de comptabilité ascendante, mysql_drop_db() est toujours + <para> + Voir aussi <function>mysql_create_db</function>. + Pour des raisons de comptabilité ascendante, mysql_drop_db() est toujours utilisable. </para> </refsect1> </refentry> - <refentry id="function.mysql-errno"> <refnamediv> - <refname>mysql_errno</refname> + <refname>mysql_errno</refname> <refpurpose>Retourne le numéro de message d'erreur de la dernière opération MySQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_errno</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> @@ -494,12 +470,11 @@ </programlisting> </informalexample> </para> - <para> + <para> Voir aussi <function>mysql_error</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-error"> <refnamediv> <refname>mysql_error</refname> @@ -511,15 +486,15 @@ <title>Description</title> <funcsynopsis> <funcdef>string <function>mysql_error</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> <para> - Les erreurs générées par mySQL ne se transforment plus en alerte. A la place, - elles sont accessibles via ces fonctions : + Les erreurs générées par mySQL ne se transforment plus en alerte. A la place, + elles sont accessibles via ces fonctions : <informalexample> <programlisting role="php"> <?php @@ -533,17 +508,16 @@ </programlisting> </informalexample> </para> - <para> + <para> Voir aussi <function>mysql_errno</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-array"> <refnamediv> - <refname>mysql_fetch_array</refname> + <refname>mysql_fetch_array</refname> <refpurpose> - Retourne une ligne de résultat sous la forme d'un tableau associatif. + Retourne une ligne de résultat sous la forme d'un tableau associatif. </refpurpose> </refnamediv> <refsect1> @@ -557,20 +531,20 @@ </parameter> </paramdef> </funcsynopsis> - <para> - Retourne un tableau qui contient la ligne demandée, ou FALSE si il ne reste plus + <para> + Retourne un tableau qui contient la ligne demandée, ou FALSE si il ne reste plus de ligne. </para> <para> - <function>mysql_fetch_array</function> est une version étendue de - <function>mysql_fetch_row</function>. En plus d'enregistrer les données sous - forme d'un tableau à indice numérique, elle peut aussi les enregistrer dans un + <function>mysql_fetch_array</function> est une version étendue de + <function>mysql_fetch_row</function>. En plus d'enregistrer les données sous + forme d'un tableau à indice numérique, elle peut aussi les enregistrer dans un tableau associatif, en utilisant les noms des champs comme indices. </para> <para> - Si plusieurs colonnes ont le même nom, la dernière colonne aura la priorité. - Pour accéder aux autres colonnes du même nom, vous devez utiliser l'index - numériques, ou faire un alias pour chaque colonne. + Si plusieurs colonnes ont le même nom, la dernière colonne aura la priorité. + Pour accéder aux autres colonnes du même nom, vous devez utiliser l'index + numériques, ou faire un alias pour chaque colonne. <informalexample> <programlisting> select t1.f1 as foo t2.f1 as bar from t1, t2 @@ -578,13 +552,13 @@ </informalexample> </para> <para> - Il est important de souligne que <function>mysql_fetch_array</function> N'est PAS - plus lente que <function>mysql_fetch_row</function>, tandis qu'elle ajoute un + Il est important de souligne que <function>mysql_fetch_array</function> N'est PAS + plus lente que <function>mysql_fetch_row</function>, tandis qu'elle ajoute un confort d'utilisation notable. </para> <para> - L'option <parameter>result_type</parameter> de - <function>mysql_fetch_array</function> est une constant qui peut prendre les + L'option <parameter>result_type</parameter> de + <function>mysql_fetch_array</function> est une constant qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM, et MYSQL_BOTH. </para> <para> @@ -593,7 +567,7 @@ <example> <title>mysql fetch array</title> <programlisting role="php"> -<?php +<?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_array($result)) { @@ -606,10 +580,9 @@ </example> </refsect1> </refentry> - <refentry id="function.mysql-fetch-assoc"> <refnamediv> - <refname>mysql_fetch_assoc</refname> + <refname>mysql_fetch_assoc</refname> <refpurpose> Lit une ligne de résultat dans un tableau associatif </refpurpose> @@ -622,36 +595,36 @@ <paramdef>int <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> <function>mysql_fetch_assoc</function> retourne un tableau associatif qui contient la ligne lue, ou bien FALSE, si il ne reste plus de lignes. </para> <para> - <function>mysql_fetch_assoc</function> est équivalente à + <function>mysql_fetch_assoc</function> est équivalente à <function>mysql_fetch_array</function> utilisée avec l'option MYSQL_ASSOC. Elle ne retourne qu'un tableau associatif. C'est le fonctionnement original de <function>mysql_fetch_array</function>. Si vous avez besoin d'indices numériques, utilisez <function>mysql_fetch_array</function>. </para> <para> - Si plusieurs colonnes on le même nom, la dernière aura la priorité. + Si plusieurs colonnes on le même nom, la dernière aura la priorité. Pour accéder aux autres colonnes du même nom, vous devez utiliser <function>mysql_fetch_array</function> et les indices numériques. </para> <para> Une chose importante à noter est que <function>mysql_fetch_assoc</function> - n'est PAS significativement plus lente que + n'est PAS significativement plus lente que <function>mysql_fetch_row</function>, alors qu'elle apporte un confort d'utilisation important. </para> <para> - Pour plus de détails, reportez vous à + Pour plus de détails, reportez vous à <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. </para> <example> <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -<?php +<?php mysql_connect ($host, $user, $password); $result = mysql_db_query ("database","select * from table"); while ($row = mysql_fetch_assoc ($result)) { @@ -664,13 +637,12 @@ </example> </refsect1> </refentry> - <refentry id="function.mysql-fetch-field"> <refnamediv> <refname>mysql_fetch_field</refname> <refpurpose> - Retourne les données enregistrées dans une colonne, à partir d'un résultat, et - retourne un objet. + Retourne les données enregistrées dans une colonne, à partir d'un résultat, et + retourne un objet. </refpurpose> </refnamediv> <refsect1> @@ -678,7 +650,7 @@ <funcsynopsis> <funcdef>object <function>mysql_fetch_field</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>field_offset</optional> </parameter> @@ -686,10 +658,10 @@ </funcsynopsis> <para> Retourne un objet contenant les données. - </para> + </para> <para> - <function>mysql_fetch_field</function> sert à obtenir des informations à propos - des champs, dans certaines requêtes. Si l'offset du champs n'est pas spécifié, + <function>mysql_fetch_field</function> sert à obtenir des informations à propos + des champs, dans certaines requêtes. Si l'offset du champs n'est pas spécifié, le champs suivant le dernier champs retourné, est retourné. </para> <para> @@ -697,57 +669,57 @@ <itemizedlist> <listitem> <simpara> - name - nom de la colonne + name - nom de la colonne </simpara> </listitem> <listitem> <simpara> - table - nom de la table de la colonne + table - nom de la table de la colonne </simpara> </listitem> <listitem> <simpara> - max_length - taille maximale de la colonne + max_length - taille maximale de la colonne </simpara> </listitem> <listitem> <simpara> - not_null - 1 si la colonne ne peut pas être NULL (attribut NOT NULL) + not_null - 1 si la colonne ne peut pas être NULL (attribut NOT NULL) </simpara> - </listitem> + </listitem> <listitem> <simpara> - primary_key - 1 si la colonne est une clé primaire (attribut PRIMARY KEY) + primary_key - 1 si la colonne est une clé primaire (attribut PRIMARY KEY) </simpara> - </listitem> + </listitem> <listitem> <simpara> - unique_key - 1 si la colonne est une clé unique (attribut UNIQUE) + unique_key - 1 si la colonne est une clé unique (attribut UNIQUE) </simpara> - </listitem> + </listitem> <listitem> <simpara> - multiple_key - 1 si la colonne est une clé non-unique + multiple_key - 1 si la colonne est une clé non-unique </simpara> - </listitem> + </listitem> <listitem> <simpara> - numeric - 1 si la colonne est numérique + numeric - 1 si la colonne est numérique </simpara> - </listitem> + </listitem> <listitem> <simpara> - blob - 1 si la colonne est BLOB + blob - 1 si la colonne est BLOB </simpara> </listitem> <listitem> <simpara> - type - le type de la colonne + type - le type de la colonne </simpara> </listitem> <listitem> <simpara> - unsigned - 1 si la colonne est non signé + unsigned - 1 si la colonne est non signé </simpara> </listitem> <listitem> @@ -762,10 +734,9 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-lengths"> <refnamediv> - <refname>mysql_fetch_lengths</refname> + <refname>mysql_fetch_lengths</refname> <refpurpose> Retourne la taille de chaque colonne d'une ligne de résultat. </refpurpose> @@ -776,23 +747,22 @@ <funcdef>array <function>mysql_fetch_lengths</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> - <para> - Retourne un tableau avec la taille de chaque colonne de la dernière ligne retournée + <para> + Retourne un tableau avec la taille de chaque colonne de la dernière ligne retournée par <function>mysql_fetch_row</function>, sinon FALSE. - </para> + </para> <para> - <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne - de la dernière ligne retournée par <function>mysql_fetch_row</function>, - <function>mysql_fetch_array</function>, et - <function>mysql_fetch_object</function> dans un tableau, en commencant à la + <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne + de la dernière ligne retournée par <function>mysql_fetch_row</function>, + <function>mysql_fetch_array</function>, et + <function>mysql_fetch_object</function> dans un tableau, en commencant à la position. - </para> - <para> + </para> + <para> Voir aussi <function>mysql_fetch_row</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-object"> <refnamediv> <refname>mysql_fetch_object</refname> @@ -809,28 +779,28 @@ </parameter> </paramdef> </funcsynopsis> - <para> - Retourne un objet dont les propriétés correspondent à une ligne d'un résultat, + <para> + Retourne un objet dont les propriétés correspondent à une ligne d'un résultat, ou FALSE si il n'y a plus d'autres lignes. </para> - <para> - <function>mysql_fetch_object</function> est identique à - <function>mysql_fetch_array</function>, à la différence qu'elle retourne un objet - à la place d'un tableau. Vous pourrez ainsi accéder aux valeurs des champs par + <para> + <function>mysql_fetch_object</function> est identique à + <function>mysql_fetch_array</function>, à la différence qu'elle retourne un objet + à la place d'un tableau. Vous pourrez ainsi accéder aux valeurs des champs par leur nom, mais plus par leur offset (les nombres ne sont pas des noms MySQL). </para> <para> - L'argument optionnel <parameter>result_typ</parameter> est une constante qui + L'argument optionnel <parameter>result_typ</parameter> est une constante qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM, et MYSQL_BOTH. </para> <para> - Concernant la vitesse, cette fonction est aussi rapide que - <function>mysql_fetch_array</function>, et presque aussi rapide que + Concernant la vitesse, cette fonction est aussi rapide que + <function>mysql_fetch_array</function>, et presque aussi rapide que <function>mysql_fetch_row</function> (la différence est insignifiante) <example> <title>mysql fetch object</title> <programlisting role="php"> -<?php +<?php mysql_connect($host,$user,$password); $result = mysql_db_query("database","select * from table"); while($row = mysql_fetch_object($result)) { @@ -842,12 +812,11 @@ </programlisting> </example> </para> - <para> + <para> Voir aussi <function>mysql_fetch_array</function> et <function>mysql_fetch_row</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-fetch-row"> <refnamediv> <refname>mysql_fetch_row</refname> @@ -859,30 +828,29 @@ <funcdef>array <function>mysql_fetch_row</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> - <para> - Retourne un tableau énuméré qui correspond à la ligne demandée, ou FALSE + <para> + Retourne un tableau énuméré qui correspond à la ligne demandée, ou FALSE si il ne reste plus de ligne. </para> <para> - <function>mysql_fetch_row</function> va rechercher une ligne dans le résultat - associé à l'identifiant de résultat spécifié. La ligne est retournée sous la - forme d'un tableau. Chaque colonne est enregistré sous la forme d'un tableau + <function>mysql_fetch_row</function> va rechercher une ligne dans le résultat + associé à l'identifiant de résultat spécifié. La ligne est retournée sous la + forme d'un tableau. Chaque colonne est enregistré sous la forme d'un tableau commencant à la position 0. </para> <para> - Les appels suivants à <function>mysql_fetch_row</function> retourneront la ligne + Les appels suivants à <function>mysql_fetch_row</function> retourneront la ligne suivante dans le résultat, ou FALSE si il n'y a plus de ligne disponible. </para> <para> Voir aussi <function>mysql_fetch_array</function>, <function>mysql_fetch_object</function>, <function>mysql_data_seek</function>, - <function>mysql_fetch_lengths</function>, et + <function>mysql_fetch_lengths</function>, et <function>mysql_result</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-flags"> <refnamediv> <refname>mysql_field_flags</refname> @@ -897,27 +865,26 @@ <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> - <para> - <function>mysql_field_flags</function> retourne le sémaphore associé au champs + <para> + <function>mysql_field_flags</function> retourne le sémaphore associé au champs spécifié par <parameter>field_offset</parameter>. Les sémaphores sont retournés - comme des mots, séparés par des espaces, ce qui les rend facile à séparer, avec la + comme des mots, séparés par des espaces, ce qui les rend facile à séparer, avec la commande <function>explode</function>. </para> <para> - Les valeurs suivantes (pour une version suffisamment récente de MySQL) sont - disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", + Les valeurs suivantes (pour une version suffisamment récente de MySQL) sont + disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". </para> - <para> - Pour des raisons de compatibilité ascendante, mysql_fieldflags() peut encore être + <para> + Pour des raisons de compatibilité ascendante, mysql_fieldflags() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-name"> <refnamediv> - <refname>mysql_field_name</refname> + <refname>mysql_field_name</refname> <refpurpose> Retourne le nom d'une colonne </refpurpose> @@ -931,9 +898,9 @@ </funcsynopsis> <para> <function>mysql_field_name</function> retourne le nom d'une colonne. - Les arguments de la fonction sont un identifiant de résultat - <parameter>result</parameter> et l'index du champs, - ie.<literal>mysql_field_name($result,2);</literal> + Les arguments de la fonction sont un identifiant de résultat + <parameter>result</parameter> et l'index du champs, + ie.<literal>mysql_field_name($result,2);</literal> </para> <para> Retournera le nom du deuxième champs dans le résultat associé à $result. @@ -944,11 +911,9 @@ </para> </refsect1> </refentry> - - <refentry id="function.mysql-field-len"> <refnamediv> - <refname>mysql_field_len</refname> + <refname>mysql_field_len</refname> <refpurpose> Retourne la longueur du champs spécifié. </refpurpose> @@ -961,15 +926,14 @@ <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> <para> - <function>mysql_field_len</function> retourne la taille du champs spécifié. + <function>mysql_field_len</function> retourne la taille du champs spécifié. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_fieldlen() peut encore être + Pour des raisons de compatibilité ascendante, mysql_fieldlen() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-seek"> <refnamediv> <refname>mysql_field_seek</refname> @@ -985,8 +949,8 @@ <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> <para> - Place le pointeur de résultat sur le champs spécifié. Lors du prochain appel à - <function>mysql_fetch_field</function> qui n'aura pas d'argument d'index de + 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> @@ -994,7 +958,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-field-table"> <refnamediv> <refname>mysql_field_table</refname> @@ -1009,13 +972,12 @@ <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> - <para> - Retourne le nom de la table oú se trouve une colonne. Pour des raisons de + <para> + Retourne le nom de la table oú se trouve une colonne. Pour des raisons de compatibilité ascendante, mysql_fieldtable() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-field-type"> <refnamediv> <refname>mysql_field_type</refname> @@ -1031,14 +993,14 @@ <paramdef>int <parameter>field_offset</parameter></paramdef> </funcsynopsis> <para> - <function>mysql_field_type</function> est similaire à la fonction - <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est - le type du champs qui est retourné. Il vaudra "int", "real", "string", "blob", ou + <function>mysql_field_type</function> est similaire à la fonction + <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est + le type du champs qui est retourné. Il vaudra "int", "real", "string", "blob", ou d'autres, comme détaillé dans la documentation MySQL. <example> <title>Types mysql field</title> <programlisting role="php"> -<?php +<?php mysql_connect("localhost:3306"); mysql_select_db("wisconsin"); $result = mysql_query("SELECT * FROM onek"); @@ -1047,7 +1009,7 @@ $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>"; +echo "The table has the following fields <BR>"; while ($i < $fields) { $type = mysql_field_type ($result, $i); $name = mysql_field_name ($result, $i); @@ -1061,13 +1023,12 @@ </programlisting> </example> </para> - <para> + <para> Pour des raisons de compatibilité ascendante, mysql_fieldtype() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-free-result"> <refnamediv> <refname>mysql_free_result</refname> @@ -1080,17 +1041,16 @@ <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> <para> - <function>mysql_free_result</function> n'est à appeler que si vous avez peur - d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire + <function>mysql_free_result</function> n'est à appeler que si vous avez peur + d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire associée à l'identifiant de résultat sera automatiquement libérée. </para> <para> - Pour des raisons de compatibilité ascendante,mysql_freeresult() peut encore être + Pour des raisons de compatibilité ascendante,mysql_freeresult() peut encore être utilisé. </para> </refsect1> </refentry> - <refentry id="function.mysql-insert-id"> <refnamediv> <refname>mysql_insert_id</refname> @@ -1102,23 +1062,22 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_insert_id</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_insert_id</function> retourne le dernier identifiant généré par - un champs de type AUTO_INCREMENTED. Cette fonction ne prend aucun argument. Elle + <para> + <function>mysql_insert_id</function> retourne le dernier identifiant généré par + un champs de type AUTO_INCREMENTED. Cette fonction ne prend aucun argument. Elle retourne le dernier identifiant généré par la dernière fonction INSERT effectuée. </para> </refsect1> </refentry> - <refentry id="function.mysql-list-dbs"> <refnamediv> - <refname>mysql_list_dbs</refname> + <refname>mysql_list_dbs</refname> <refpurpose> Liste les bases de données disponibles sur le serveur MySQL. </refpurpose> @@ -1127,7 +1086,7 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_list_dbs</function></funcdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> @@ -1137,12 +1096,11 @@ <function>mysql_list_dbs</function> retournera un identifiant de résultat, qui contiendra les noms des bases de données disponsibles sur le serveur MySQL. Utilisez la fonction <function>mysql_tablename</function> pour lire toutes les bases de données. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listdbs() + Pour des raisons de compatibilité ascendante, mysql_listdbs() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> @@ -1154,36 +1112,35 @@ <funcdef>int <function>mysql_list_fields</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>string <parameter>table_name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> <para> - <function>mysql_list_fields</function> recherche les informations à propos de la - table spécifiée. Les arguments sont la base de données, et le nom de la table. Un - pointeur de résultat est retourné, et pourra être passé à + <function>mysql_list_fields</function> recherche les informations à propos de la + table spécifiée. Les arguments sont la base de données, et le nom de la table. Un + pointeur de résultat est retourné, et pourra être passé à <function>mysql_field_flags</function>, <function>mysql_field_len</function>, - <function>mysql_field_name</function> et + <function>mysql_field_name</function> et <function>mysql_field_type</function>. </para> <para> - Un identifiant de résultat est un entier positif. La fonction retourne -1 - si une erreur survient. Une chaîne décrivant le problème - rencontré sera placée dans la variable - <literal>$phperrmsg</literal>, et, à moins que la fonction n'ait - été appelée sous la forme <literal>@mysql()</literal>, + Un identifiant de résultat est un entier positif. La fonction retourne -1 + si une erreur survient. Une chaîne décrivant le problème + rencontré sera placée dans la variable + <literal>$phperrmsg</literal>, et, à moins que la fonction n'ait + été appelée sous la forme <literal>@mysql()</literal>, cette erreur sera aussi affichée. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listfields() + Pour des raisons de compatibilité ascendante, mysql_listfields() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-list-tables"> <refnamediv> <refname>mysql_list_tables</refname> @@ -1194,25 +1151,24 @@ <funcsynopsis> <funcdef>int <function>mysql_list_tables</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_list_tables</function> prend le nom d'une base de données comme - argument, et retourne un identifiant de résultat, qui contiendra la liste des - tables. La fonction <function>mysql_tablename</function> est le meilleur moyen + <para> + <function>mysql_list_tables</function> prend le nom d'une base de données comme + argument, et retourne un identifiant de résultat, qui contiendra la liste des + tables. La fonction <function>mysql_tablename</function> est le meilleur moyen d'extraire les noms des tables depuis l'identifiant de résultat. </para> <para> - Pour des raisons de compatibilité ascendante, mysql_listtables() + Pour des raisons de compatibilité ascendante, mysql_listtables() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> @@ -1224,20 +1180,19 @@ <funcdef>int <function>mysql_num_fields</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> </funcsynopsis> - <para> + <para> <function>mysql_num_fields</function> retourne le nombre de champs d'un résultat. </para> - <para> + <para> Voir aussi <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function>, <function>mysql_num_rows</function>. </para> <para> - Pour des raisons de compatibilité ascendante mysql_numfields() + Pour des raisons de compatibilité ascendante mysql_numfields() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-num-rows"> <refnamediv> <refname>mysql_num_rows</refname> @@ -1261,29 +1216,28 @@ </title> <programlisting role="php"> <?php -$conn = mysql_connect("adresse de l'hote", "utilisateur", "mot de passe"); +$conn = mysql_connect("adresse de l'hote", "utilisateur", "mot de passe"); mysql_select_db("base",$conn); // nécessaire si vous avez plusieurs bases -$Resultfornummembers = mysql_query("SELECT * FROM Accounts",$conn); -$NumMembers = mysql_num_rows($Resultfornummembers); +$Resultfornummembers = mysql_query("SELECT * FROM Accounts",$conn); +$NumMembers = mysql_num_rows($Resultfornummembers); echo "$NumMembers Membres"; -?> +?> </programlisting> </example> <para> - Voir aussi <function>mysql_db_query</function>, - <function>mysql_query</function> + Voir aussi <function>mysql_db_query</function>, + <function>mysql_query</function> et <function>mysql_fetch_row</function>. </para> <para> - Pour des raisons de compatibilité ascendante mysql_numrows() est encore + Pour des raisons de compatibilité ascendante mysql_numrows() est encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-pconnect"> <refnamediv> - <refname>mysql_pconnect</refname> + <refname>mysql_pconnect</refname> <refpurpose> Ouvre une connexion persistante à un serveur MySQL. </refpurpose> @@ -1292,34 +1246,34 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>mysql_pconnect</function></funcdef> - <paramdef>string + <paramdef>string <parameter> <optional>hostname - <optional>:port</optional> + <optional>:port</optional> <optional>:/path/to/socket</optional> </optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>username</optional></parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>password</optional></parameter> </paramdef> </funcsynopsis> - <para> - Retourne un lien persistant positif en cas de succès, et sinon FALSE en cas + <para> + Retourne un lien persistant positif en cas de succès, et sinon FALSE en cas d'erreur. </para> <para> - <function>mysql_pconnect</function> établit uen connexion persistante à un serveur - MySQL. Tous les arguments sont optionnels, et des valeurs par défaut seront - utilisérs en cas d'omission ('localhost', nom d'utilisateur propriétaire + <function>mysql_pconnect</function> établit uen connexion persistante à un serveur + MySQL. Tous les arguments sont optionnels, et des valeurs par défaut seront + utilisérs en cas d'omission ('localhost', nom d'utilisateur propriétaire du processus, mot de passe vide). - </para> + </para> <para> - Le nom de l'hôte peut aussi inclure le numéro de port, c'est à dire - "hostname:port" ou un chemin jusqu'à la socket + Le nom de l'hôte peut aussi inclure le numéro de port, c'est à dire + "hostname:port" ou un chemin jusqu'à la socket ":/path/to/socket" pour l'hôte local. <note> <para> @@ -1329,29 +1283,28 @@ Le support de ":/path/to/socket" a été ajouté dans en version 3.0.10. </para> </note> - </para> + </para> <para> - <function>mysql_pconnect</function> se comporte exactement comme - <function>mysql_connect</function>, mais avec deux différences majeures : + <function>mysql_pconnect</function> se comporte exactement comme + <function>mysql_connect</function>, mais avec deux différences majeures : </para> - <para> - Premièrement, lors de la connexion, la fonction essaie de trouver une connexion - permanante déjà ouverte sur cet hote, avec le même nom d'utilisateur et de mot - de passe. Si une telle connexion est trouvée, son identifiant est retourné, sans + <para> + Premièrement, lors de la connexion, la fonction essaie de trouver une connexion + permanante déjà ouverte sur cet hote, avec le même nom d'utilisateur et de mot + de passe. Si une telle connexion est trouvée, son identifiant est retourné, sans ouvrir de nouvelle connexion. </para> - <para> - Deuxièmement, la connexion au serveur MySQL ne sera pas terminée avec la fin - du script. Au lieu de cela, le lien sera conservé pour un prochain accès - (<function>mysql_close</function> ne terminera pas une connexion persistante + <para> + Deuxièmement, la connexion au serveur MySQL ne sera pas terminée avec la fin + du script. Au lieu de cela, le lien sera conservé pour un prochain accès + (<function>mysql_close</function> ne terminera pas une connexion persistante établie par <function>mysql_pconnect</function>). </para> - <para> + <para> C'est pourquoi ce type de connexion est dite 'persistante'. </para> </refsect1> </refentry> - <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> @@ -1362,31 +1315,31 @@ <funcsynopsis> <funcdef>int <function>mysql_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>link_identifier</optional></parameter> </paramdef> </funcsynopsis> - <para> - <function>mysql_query</function> envoie une requête SQL à la base de données + <para> + <function>mysql_query</function> envoie une requête SQL à la base de données actuellement active sur le serveur MysQL. Si <parameter>link_identifier</parameter> - n'est pas précisé, la dernière connexion est utilisée. Si aucune connexion n'a - été ouverte, la fonction tentera d'en ouvrir une, avec la fonction - <function>mysql_connect</function> mais sans aucun paramètre (c'est à dire avec + n'est pas précisé, la dernière connexion est utilisée. Si aucune connexion n'a + été ouverte, la fonction tentera d'en ouvrir une, avec la fonction + <function>mysql_connect</function> mais sans aucun paramètre (c'est à dire avec les valeurs par défaut). </para> <para> <function>mysql_connect</function> </para> <para> - <function>mysql_query</function> retourne TRUE ou FALSE, pour indiquer le succès - ou l'échec de la requête. En cas de retour TRUE, la requête était valide et a - pu être exécuté sur le serveur. Cela n'indique pas le nombre de ligne affectées, - ou retournées. Il est parfaitement possible qu'une requête valide n'affecte aucune + <function>mysql_query</function> retourne TRUE ou FALSE, pour indiquer le succès + ou l'échec de la requête. En cas de retour TRUE, la requête était valide et a + pu être exécuté sur le serveur. Cela n'indique pas le nombre de ligne affectées, + ou retournées. Il est parfaitement possible qu'une requête valide n'affecte aucune ligne ou ne retourne aucune ligne. </para> <para> - L'exemple suivant est syntaxiquement invalide, ce qui conduit - <function>mysql_query</function> à l'échec, et retourne FALSE: + L'exemple suivant est syntaxiquement invalide, ce qui conduit + <function>mysql_query</function> à l'échec, et retourne FALSE: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1400,7 +1353,7 @@ <para> L'exemple suivant est sémantiquement invalide si <literal>my_col</literal> n'est pas une colonne de la table <literal>my_tbl</literal>, ce qui conduit - <function>mysql_query</function> à l'échec, et retourne FALSE : + <function>mysql_query</function> à l'échec, et retourne FALSE : <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1412,16 +1365,16 @@ </example> </para> <para> - <function>mysql_query</function> échouera aussi et retournera aussi FALSE si les + <function>mysql_query</function> échouera aussi et retournera aussi FALSE si les droits d'accès ne sont pas suffisants. </para> <para> - En supposant que la requête réussisse, vous pouvez appeler - <function>mysql_affected_rows</function> pour connaître le nombre de lignes - affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). - Pour les commandes SELECT , <function>mysql_query</function> retourne un + En supposant que la requête réussisse, vous pouvez appeler + <function>mysql_affected_rows</function> pour connaître le nombre de lignes + affectées (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). + Pour les commandes SELECT , <function>mysql_query</function> retourne un identifiant de résultat que vous pouvez passer à <function>mysql_result</function>. - Lorsque vous avez terminé avec le résultat, libérez la mémoire avec + Lorsque vous avez terminé avec le résultat, libérez la mémoire avec <function>mysql_free_result</function>. </para> <para> @@ -1431,7 +1384,6 @@ </para> </refsect1> </refentry> - <refentry id="function.mysql-result"> <refnamediv> <refname>mysql_result</refname> @@ -1443,37 +1395,36 @@ <funcdef>int <function>mysql_result</function></funcdef> <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcsynopsis> <para> - <function>mysql_result</function> retourne le contenu d'un champs dans un - résultat MySQL. L'argument de champs <parameter>row</parameter> peut être un - offset de champs, ou le nom du champs, ou le nom de la table + point + le nom - du champs (table.champs). Si la colonne a été aliasée, utilisez de préférence + <function>mysql_result</function> retourne le contenu d'un champs dans un + résultat MySQL. L'argument de champs <parameter>row</parameter> peut être un + offset de champs, ou le nom du champs, ou le nom de la table + point + le nom + du champs (table.champs). Si la colonne a été aliasée, utilisez de préférence l'alias. </para> <para> - Lorsque vous travaillez sur des résultats de grande taille, vous devriez utiliser - une des fonctions qui vont rechercher une ligne entière dans un tableau. - Ces fonctions sont NETTEMENT plus rapides. De plus, l'utilisation d'un offset + Lorsque vous travaillez sur des résultats de grande taille, vous devriez utiliser + une des fonctions qui vont rechercher une ligne entière dans un tableau. + Ces fonctions sont NETTEMENT plus rapides. De plus, l'utilisation d'un offset numériques est aussi beaucoup plus rapide que de spécifier un nom litéral. </para> <para> - Les appels <function>mysql_result</function> ne devraient pas être mélangés + Les appels <function>mysql_result</function> ne devraient pas être mélangés avec d'autres fonctions qui travaillent aussi sur le résultat. </para> <para> - Alternatives à haut rendement, RECOMMANDEES : - <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et + Alternatives à haut rendement, RECOMMANDEES : + <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et <function>mysql_fetch_object</function>. </para> </refsect1> </refentry> - <refentry id="function.mysql-select-db"> <refnamediv> <refname>mysql_select_db</refname> @@ -1484,37 +1435,36 @@ <funcsynopsis> <funcdef>int <function>mysql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcsynopsis> - <para> + <para> 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 l'identifiant de connexion. Si aucun identifiant n'est - spécifié, la dernière connexion est utilisée. S'il n'y a pas de dernière - connexion, la fonction tentera de se connecter seule, avec + <para> + <function>mysql_select_db</function> change la base de données active sur la + connexion représentée par l'identifiant de connexion. Si aucun identifiant n'est + spécifié, la dernière connexion est utilisée. S'il n'y a pas de dernière + connexion, la fonction tentera de se connecter seule, avec <function>mysql_connect</function> et les paramètres par défaut. </para> <para> Toutes les requêtes suivantes avec <function>mysql_query</function> seront faites avec la base de données active. </para> - <para> - Voir aussi <function>mysql_connect</function>, <function>mysql_pconnect</function>, et + <para> + Voir aussi <function>mysql_connect</function>, <function>mysql_pconnect</function>, et <function>mysql_query</function>. </para> <para> - Pour des raisons de compatibilité ascendante mysql_selectdb() est - encore disponible. + Pour des raisons de compatibilité ascendante mysql_selectdb() est + encore disponible. </para> </refsect1> </refentry> - <refentry id="function.mysql-tablename"> <refnamediv> <refname>mysql_tablename</refname> @@ -1527,15 +1477,15 @@ <paramdef>int <parameter>result</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> </funcsynopsis> - <para> - <function>mysql_tablename</function> prend le pointeur de résultat obtenu avec - <function>mysql_list_tables</function> ou bien un index entier, et retourne le - nom de la table. La fonction <function>mysql_num_rows</function> peut être + <para> + <function>mysql_tablename</function> prend le pointeur de résultat obtenu avec + <function>mysql_list_tables</function> ou bien un index entier, et retourne le + nom de la table. La fonction <function>mysql_num_rows</function> peut être utilisée pour déterminer le nombre de tables dans le pointeur de résultat. <example> <title>Exemple <function>mysql_tablename</function></title> <programlisting role="php"> -<?php +<?php mysql_connect ("localhost:3306"); $result = mysql_list_tables ("wisconsin"); $i = 0; @@ -1550,9 +1500,7 @@ </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml