cvs: phpdoc /fr/functions mysql.xml

From: 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 &eacute;vitera les conflits. </simpara> <simpara> - Plus d'informations sont disponibles &agrave; + Plus d'informations sont disponibles &agrave; <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&eacute;es lors de la derni&egrave;re op&eacute;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&eacute;es - lors de la derni&egrave;re requ&ecirc;te INSERT, UPDATE ou DELETE sur le serveur associ&eacute; &agrave; - l'identifiant de connexion. Si cet identifiant n'est pas pr&eacute;cis&eacute;, cette fonction + <para> + <function>mysql_affected_rows</function> retourne le nombre de lignes affect&eacute;es + lors de la derni&egrave;re requ&ecirc;te INSERT, UPDATE ou DELETE sur le serveur associ&eacute; &agrave; + l'identifiant de connexion. Si cet identifiant n'est pas pr&eacute;cis&eacute;, cette fonction utilise la derni&egrave;re connexion ouverte. </para> <para> - Si la derni&egrave;re requ&ecirc;te &eacute;tait un DELETE sans clause WHERE, tous les enregistrements + Si la derni&egrave;re requ&ecirc;te &eacute;tait un DELETE sans clause WHERE, tous les enregistrements ont &eacute;t&eacute; effac&eacute;s, mais cette fonction va retourner 0. </para> <para> - Cette commande n'est pas possible apr&egrave;s un SELECT, car elle ne fonctionne qu'apr&egrave;s - des commandes qui modifient les enregistrements. Pour conna&icirc;tre le nombre de ligne + Cette commande n'est pas possible apr&egrave;s un SELECT, car elle ne fonctionne qu'apr&egrave;s + des commandes qui modifient les enregistrements. Pour conna&icirc;tre le nombre de ligne retourn&eacute;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&eacute;cifi&eacute;e avec l'option + active, ou sur la connexion sp&eacute;cifi&eacute;e avec l'option <parameter><optional>link_identifier</optional></parameter> Si une base est sp&eacute;cifi&eacute;e, elle deviendra la base par d&eacute;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&egrave;s, et FALSE sinon. </para> - <para> + <para> <function>mysql_close</function> ferme la connexion au serveur MySQL associ&eacute;e &agrave; l'identifiant link_identifier . Si cet identifiant n'est pas sp&eacute;cifi&eacute;, cette commande s'applique &agrave; la derni&egrave;re connexion ouverte. </para> - <note><para> - Notez que cette commande n'est pas n&eacute;cessaire, car toutes les connexions non + <note><para> + Notez que cette commande n'est pas n&eacute;cessaire, car toutes les connexions non persistantes seront automatiquement ferm&eacute;es &agrave; 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&eacute;n&eacute;r&eacute;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&egrave;s, et sinon FALSE. </para> - <para> - <function>mysql_connect</function> &eacute;tablit une connexion &agrave; un serveur MySQL. Tous - les arguments sont optionnels, et s'ils manquent, les valeurs par d&eacute;faut sont + <para> + <function>mysql_connect</function> &eacute;tablit une connexion &agrave; un serveur MySQL. Tous + les arguments sont optionnels, et s'ils manquent, les valeurs par d&eacute;faut sont utilis&eacute;es ( ('localhost', nom du propri&eacute;taire du process, mot de passe vide). - </para> + </para> <para> - Le nom d'h&ocirc;te peut aussi inclure un num&eacute;ro de port, sous la forme : - &quot;hostname:port&quot; ou un chemin jusqu'&agrave; une socket sous la forme - &quot;:/path/to/socket&quot; pour l'h&ocirc;te localhost. + Le nom d'h&ocirc;te peut aussi inclure un num&eacute;ro de port, sous la forme : + &quot;hostname:port&quot; ou un chemin jusqu'&agrave; une socket sous la forme + &quot;:/path/to/socket&quot; pour l'h&ocirc;te localhost. <note> <para> Le support des &quot;:port&quot; a &eacute;t&eacute; ajout&eacute; &agrave; partir de la version 3.0B4. </para> <para> - Le support de &quot;:/path/to/socket&quot; a &eacute;t&eacute; ajout&eacute; &agrave; partir de la + Le support de &quot;:/path/to/socket&quot; a &eacute;t&eacute; ajout&eacute; &agrave; 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 &agrave; <function>mysql_connect</function> est fait avec - les m&ecirc;mes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va - retourner l'identifiant de la connexion d&eacute;j&agrave; ouverte. + Si un second appel &agrave; <function>mysql_connect</function> est fait avec + les m&ecirc;mes arguments, PHP ne va pas ouvrir une nouvelle connexion, mais va + retourner l'identifiant de la connexion d&eacute;j&agrave; ouverte. </para> <para> - Le lien sera ferm&eacute; automatiquement d&egrave;s que l'ex&eacute;cution du script sera termin&eacute;e, + Le lien sera ferm&eacute; automatiquement d&egrave;s que l'ex&eacute;cution du script sera termin&eacute;e, &agrave; moins d'&ecirc;tre ferm&eacute; explicitement avec <function>mysql_close</function>. - </para> + </para> <example> <title>Exemple MySQL connect</title> <programlisting role="php"> &lt;?php $link = mysql_connect ("kraemer", "marliesle", "secret") { or die ("Connexion impossible"); - } + } print ("Connexion r&eacute;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&eacute;er une nouvelle base de donn&eacute;es - sur le serveur associ&eacute; &agrave; l'identifiant <parameter><optional>link_identifier</optional></parameter>, + <para> + <function>mysql_create_db</function> tente de cr&eacute;er une nouvelle base de donn&eacute;es + sur le serveur associ&eacute; &agrave; l'identifiant <parameter><optional>link_identifier</optional></parameter>, ou la derni&egrave;re connexion ouverte. </para> <example> @@ -255,7 +250,7 @@ &lt;?php $link = mysql_pconnect ("kron", "jutta", "geheim") { or die ("Connexion impossible"); - } + } if (mysql_create_db ("my_db")) { print ("Base de donn&eacute;es cr&eacute;&eacute;e\n"); } else { @@ -264,16 +259,15 @@ ?> </programlisting> </example> - <para> - Pour des raisons de compatibilit&eacute; ascendante, mysql_createdb() est toujours + <para> + Pour des raisons de compatibilit&eacute; 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&egrave;s, et FALSE sinon. </para> - <para> - <function>mysql_data_seek</function> d&eacute;place le pointeur interne de r&eacute;sultat, - dans le r&eacute;sultat associ&eacute; &agrave; l'identifiant de r&eacute;sultat <parameter>result_identifier</parameter>. - Il le fait pointer &agrave; la ligne <parameter>row_number</parameter>. Le prochain appel + <para> + <function>mysql_data_seek</function> d&eacute;place le pointeur interne de r&eacute;sultat, + dans le r&eacute;sultat associ&eacute; &agrave; l'identifiant de r&eacute;sultat <parameter>result_identifier</parameter>. + Il le fait pointer &agrave; la ligne <parameter>row_number</parameter>. Le prochain appel &agrave; <function>mysql_fetch_row</function> retournera cette ligne. </para> <para> <parameter>Row_number</parameter> commence &agrave; 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&ecirc;te impossible"); } - # r&eacute;cup&egrave;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&lt;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&eacute;sultat issu de <function>mysql_list_dbs</function>. + le pointeur de r&eacute;sultat issu de <function>mysql_list_dbs</function>. <parameter>row</parameter> est l'index dans le r&eacute;sultat. </para> - <para> Si une erreur survient, FALSE est retourn&eacute;. Utilisez <function>mysql_errno</function> et <function>mysql_error</function> pour conna&icirc;tre la nature de l'erreur. </para> - <example> <title>Exemple <function>mysql_db_name</function></title> <programlisting role="php"> -&lt;?php +&lt;?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&eacute; ascendante, <function>mysql_dbname</function> + Pour des raisons de compatibilit&eacute; ascendante, mysql_dbname() est aussi accept&eacute;, mais obsol&egrave;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&eacute;sultat si la requ&ecirc;te r&eacute;ussi, et FALSE sinon. </para> - <para> - <function>mysql_db_query</function> - S&eacute;lectionne une base de donn&eacute;es et ex&eacute;cute une requ&ecirc;te. Si l'identifiant - de lien <parameter>link_identifier</parameter> n'est pas pr&eacute;cis&eacute;, la fonction - prendra par d&eacute;faut la derni&egrave;re base de donn&eacute;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&eacute;lectionne une base de donn&eacute;es et ex&eacute;cute une requ&ecirc;te. Si l'identifiant + de lien <parameter>link_identifier</parameter> n'est pas pr&eacute;cis&eacute;, la fonction + prendra par d&eacute;faut la derni&egrave;re base de donn&eacute;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&egrave;s, et FALSE sinon. - </para> - <para> - <function>mysql_drop_db</function> essaie d'effacer une base de donn&eacute;es enti&egrave;re + </para> + <para> + <function>mysql_drop_db</function> essaie d'effacer une base de donn&eacute;es enti&egrave;re sur le serveur associ&eacute; &agrave; l'identifiant de connexion <parameter><optional>link_identifier</optional></parameter>. </para> - <para> - Voir aussi <function>mysql_create_db</function>. - Pour des raisons de comptabilit&eacute; ascendante, mysql_drop_db() est toujours + <para> + Voir aussi <function>mysql_create_db</function>. + Pour des raisons de comptabilit&eacute; 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&eacute;ro de message d'erreur de la derni&egrave;re op&eacute;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&eacute;n&eacute;r&eacute;es par mySQL ne se transforment plus en alerte. A la place, - elles sont accessibles via ces fonctions : + Les erreurs g&eacute;n&eacute;r&eacute;es par mySQL ne se transforment plus en alerte. A la place, + elles sont accessibles via ces fonctions : <informalexample> <programlisting role="php"> &lt;?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&eacute;sultat sous la forme d'un tableau associatif. + Retourne une ligne de r&eacute;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&eacute;e, ou FALSE si il ne reste plus + <para> + Retourne un tableau qui contient la ligne demand&eacute;e, ou FALSE si il ne reste plus de ligne. </para> <para> - <function>mysql_fetch_array</function> est une version &eacute;tendue de - <function>mysql_fetch_row</function>. En plus d'enregistrer les donn&eacute;es sous - forme d'un tableau &agrave; indice num&eacute;rique, elle peut aussi les enregistrer dans un + <function>mysql_fetch_array</function> est une version &eacute;tendue de + <function>mysql_fetch_row</function>. En plus d'enregistrer les donn&eacute;es sous + forme d'un tableau &agrave; indice num&eacute;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&ecirc;me nom, la derni&egrave;re colonne aura la priorit&eacute;. - Pour acc&eacute;der aux autres colonnes du m&ecirc;me nom, vous devez utiliser l'index - num&eacute;riques, ou faire un alias pour chaque colonne. + Si plusieurs colonnes ont le m&ecirc;me nom, la derni&egrave;re colonne aura la priorit&eacute;. + Pour acc&eacute;der aux autres colonnes du m&ecirc;me nom, vous devez utiliser l'index + num&eacute;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"> -&lt;?php +&lt;?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&eacute;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 &eacute;quivalente &agrave; + <function>mysql_fetch_assoc</function> est &eacute;quivalente &agrave; <function>mysql_fetch_array</function> utilis&eacute;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&eacute;riques, utilisez <function>mysql_fetch_array</function>. </para> <para> - Si plusieurs colonnes on le m&ecirc;me nom, la derni&egrave;re aura la priorit&eacute;. + Si plusieurs colonnes on le m&ecirc;me nom, la derni&egrave;re aura la priorit&eacute;. Pour acc&eacute;der aux autres colonnes du m&ecirc;me nom, vous devez utiliser <function>mysql_fetch_array</function> et les indices num&eacute;riques. </para> <para> Une chose importante &agrave; 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&eacute;tails, reportez vous &agrave; + Pour plus de d&eacute;tails, reportez vous &agrave; <function>mysql_fetch_row</function> et <function>mysql_fetch_array</function>. </para> <example> <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -&lt;?php +&lt;?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&eacute;es enregistr&eacute;es dans une colonne, &agrave; partir d'un r&eacute;sultat, et - retourne un objet. + Retourne les donn&eacute;es enregistr&eacute;es dans une colonne, &agrave; partir d'un r&eacute;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&eacute;es. - </para> + </para> <para> - <function>mysql_fetch_field</function> sert &agrave; obtenir des informations &agrave; propos - des champs, dans certaines requ&ecirc;tes. Si l'offset du champs n'est pas sp&eacute;cifi&eacute;, + <function>mysql_fetch_field</function> sert &agrave; obtenir des informations &agrave; propos + des champs, dans certaines requ&ecirc;tes. Si l'offset du champs n'est pas sp&eacute;cifi&eacute;, le champs suivant le dernier champs retourn&eacute;, est retourn&eacute;. </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 &ecirc;tre NULL (attribut NOT NULL) + not_null - 1 si la colonne ne peut pas &ecirc;tre NULL (attribut NOT NULL) </simpara> - </listitem> + </listitem> <listitem> <simpara> - primary_key - 1 si la colonne est une cl&eacute; primaire (attribut PRIMARY KEY) + primary_key - 1 si la colonne est une cl&eacute; primaire (attribut PRIMARY KEY) </simpara> - </listitem> + </listitem> <listitem> <simpara> - unique_key - 1 si la colonne est une cl&eacute; unique (attribut UNIQUE) + unique_key - 1 si la colonne est une cl&eacute; unique (attribut UNIQUE) </simpara> - </listitem> + </listitem> <listitem> <simpara> - multiple_key - 1 si la colonne est une cl&eacute; non-unique + multiple_key - 1 si la colonne est une cl&eacute; non-unique </simpara> - </listitem> + </listitem> <listitem> <simpara> - numeric - 1 si la colonne est num&eacute;rique + numeric - 1 si la colonne est num&eacute;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&eacute; + unsigned - 1 si la colonne est non sign&eacute; </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&eacute;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&egrave;re ligne retourn&eacute;e + <para> + Retourne un tableau avec la taille de chaque colonne de la derni&egrave;re ligne retourn&eacute;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&egrave;re ligne retourn&eacute;e par <function>mysql_fetch_row</function>, - <function>mysql_fetch_array</function>, et - <function>mysql_fetch_object</function> dans un tableau, en commencant &agrave; la + <function>mysql_fetch_lengths</function> stocke les tailles de chaque colonne + de la derni&egrave;re ligne retourn&eacute;e par <function>mysql_fetch_row</function>, + <function>mysql_fetch_array</function>, et + <function>mysql_fetch_object</function> dans un tableau, en commencant &agrave; 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&eacute;t&eacute;s correspondent &agrave; une ligne d'un r&eacute;sultat, + <para> + Retourne un objet dont les propri&eacute;t&eacute;s correspondent &agrave; une ligne d'un r&eacute;sultat, ou FALSE si il n'y a plus d'autres lignes. </para> - <para> - <function>mysql_fetch_object</function> est identique &agrave; - <function>mysql_fetch_array</function>, &agrave; la diff&eacute;rence qu'elle retourne un objet - &agrave; la place d'un tableau. Vous pourrez ainsi acc&eacute;der aux valeurs des champs par + <para> + <function>mysql_fetch_object</function> est identique &agrave; + <function>mysql_fetch_array</function>, &agrave; la diff&eacute;rence qu'elle retourne un objet + &agrave; la place d'un tableau. Vous pourrez ainsi acc&eacute;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&eacute;rence est insignifiante) <example> <title>mysql fetch object</title> <programlisting role="php"> -&lt;?php +&lt;?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 &eacute;num&eacute;r&eacute; qui correspond &agrave; la ligne demand&eacute;e, ou FALSE + <para> + Retourne un tableau &eacute;num&eacute;r&eacute; qui correspond &agrave; la ligne demand&eacute;e, ou FALSE si il ne reste plus de ligne. </para> <para> - <function>mysql_fetch_row</function> va rechercher une ligne dans le r&eacute;sultat - associ&eacute; &agrave; l'identifiant de r&eacute;sultat sp&eacute;cifi&eacute;. La ligne est retourn&eacute;e sous la - forme d'un tableau. Chaque colonne est enregistr&eacute; sous la forme d'un tableau + <function>mysql_fetch_row</function> va rechercher une ligne dans le r&eacute;sultat + associ&eacute; &agrave; l'identifiant de r&eacute;sultat sp&eacute;cifi&eacute;. La ligne est retourn&eacute;e sous la + forme d'un tableau. Chaque colonne est enregistr&eacute; sous la forme d'un tableau commencant &agrave; la position 0. </para> <para> - Les appels suivants &agrave; <function>mysql_fetch_row</function> retourneront la ligne + Les appels suivants &agrave; <function>mysql_fetch_row</function> retourneront la ligne suivante dans le r&eacute;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&eacute;maphore associ&eacute; au champs + <para> + <function>mysql_field_flags</function> retourne le s&eacute;maphore associ&eacute; au champs sp&eacute;cifi&eacute; par <parameter>field_offset</parameter>. Les s&eacute;maphores sont retourn&eacute;s - comme des mots, s&eacute;par&eacute;s par des espaces, ce qui les rend facile &agrave; s&eacute;parer, avec la + comme des mots, s&eacute;par&eacute;s par des espaces, ce qui les rend facile &agrave; s&eacute;parer, avec la commande <function>explode</function>. </para> <para> - Les valeurs suivantes (pour une version suffisamment r&eacute;cente de MySQL) sont - disponibles : "not_null", "primary_key", "unique_key", "multiple_key", "blob", + Les valeurs suivantes (pour une version suffisamment r&eacute;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&eacute; ascendante, mysql_fieldflags() peut encore &ecirc;tre + <para> + Pour des raisons de compatibilit&eacute; ascendante, mysql_fieldflags() peut encore &ecirc;tre utilis&eacute;. </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&eacute;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&eacute;sultat + <parameter>result</parameter> et l'index du champs, + ie.<literal>mysql_field_name($result,2);</literal> </para> <para> Retournera le nom du deuxi&egrave;me champs dans le r&eacute;sultat associ&eacute; &agrave; $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&eacute;cifi&eacute;. </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&eacute;cifi&eacute;. + <function>mysql_field_len</function> retourne la taille du champs sp&eacute;cifi&eacute;. </para> <para> - Pour des raisons de compatibilit&eacute; ascendante, mysql_fieldlen() peut encore &ecirc;tre + Pour des raisons de compatibilit&eacute; ascendante, mysql_fieldlen() peut encore &ecirc;tre utilis&eacute;. </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&eacute;sultat sur le champs sp&eacute;cifi&eacute;. Lors du prochain appel &agrave; - <function>mysql_fetch_field</function> qui n'aura pas d'argument d'index de + Place le pointeur de r&eacute;sultat sur le champs sp&eacute;cifi&eacute;. Lors du prochain appel &agrave; + <function>mysql_fetch_field</function> qui n'aura pas d'argument d'index de champs, le champs d&eacute;sormais point&eacute; sera retourn&eacute;. </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&uacute; se trouve une colonne. Pour des raisons de + <para> + Retourne le nom de la table o&uacute; se trouve une colonne. Pour des raisons de compatibilit&eacute; ascendante, mysql_fieldtable() peut encore &ecirc;tre utilis&eacute;. </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 &agrave; la fonction - <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est - le type du champs qui est retourn&eacute;. Il vaudra "int", "real", "string", "blob", ou + <function>mysql_field_type</function> est similaire &agrave; la fonction + <function>mysql_field_name</function>. Les arguments sont identiques, mais c'est + le type du champs qui est retourn&eacute;. Il vaudra "int", "real", "string", "blob", ou d'autres, comme d&eacute;taill&eacute; dans la documentation MySQL. <example> <title>Types mysql field</title> <programlisting role="php"> -&lt;?php +&lt;?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 &lt;BR>"; -echo "The table has the following fields &lt;BR>"; +echo "The table has the following fields &lt;BR>"; while ($i &lt; $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&eacute; ascendante, mysql_fieldtype() peut encore &ecirc;tre utilis&eacute;. </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 &agrave; appeler que si vous avez peur - d'utiliser trop de m&eacute;moire durant l'ex&eacute;cution de votre script. Toute la m&eacute;moire + <function>mysql_free_result</function> n'est &agrave; appeler que si vous avez peur + d'utiliser trop de m&eacute;moire durant l'ex&eacute;cution de votre script. Toute la m&eacute;moire associ&eacute;e &agrave; l'identifiant de r&eacute;sultat sera automatiquement lib&eacute;r&eacute;e. </para> <para> - Pour des raisons de compatibilit&eacute; ascendante,mysql_freeresult() peut encore &ecirc;tre + Pour des raisons de compatibilit&eacute; ascendante,mysql_freeresult() peut encore &ecirc;tre utilis&eacute;. </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&eacute;n&eacute;r&eacute; 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&eacute;n&eacute;r&eacute; par + un champs de type AUTO_INCREMENTED. Cette fonction ne prend aucun argument. Elle retourne le dernier identifiant g&eacute;n&eacute;r&eacute; par la derni&egrave;re fonction INSERT effectu&eacute;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&eacute;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&eacute;sultat, qui contiendra les noms des bases de donn&eacute;es disponsibles sur le serveur MySQL. Utilisez la fonction <function>mysql_tablename</function> pour lire toutes les bases de donn&eacute;es. </para> <para> - Pour des raisons de compatibilit&eacute; ascendante, mysql_listdbs() + Pour des raisons de compatibilit&eacute; 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 &agrave; propos de la - table sp&eacute;cifi&eacute;e. Les arguments sont la base de donn&eacute;es, et le nom de la table. Un - pointeur de r&eacute;sultat est retourn&eacute;, et pourra &ecirc;tre pass&eacute; &agrave; + <function>mysql_list_fields</function> recherche les informations &agrave; propos de la + table sp&eacute;cifi&eacute;e. Les arguments sont la base de donn&eacute;es, et le nom de la table. Un + pointeur de r&eacute;sultat est retourn&eacute;, et pourra &ecirc;tre pass&eacute; &agrave; <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&eacute;sultat est un entier positif. La fonction retourne -1 - si une erreur survient. Une cha&icirc;ne d&eacute;crivant le probl&egrave;me - rencontr&eacute; sera plac&eacute;e dans la variable - <literal>$phperrmsg</literal>, et, &agrave; moins que la fonction n'ait - &eacute;t&eacute; appel&eacute;e sous la forme <literal>@mysql()</literal>, + Un identifiant de r&eacute;sultat est un entier positif. La fonction retourne -1 + si une erreur survient. Une cha&icirc;ne d&eacute;crivant le probl&egrave;me + rencontr&eacute; sera plac&eacute;e dans la variable + <literal>$phperrmsg</literal>, et, &agrave; moins que la fonction n'ait + &eacute;t&eacute; appel&eacute;e sous la forme <literal>@mysql()</literal>, cette erreur sera aussi affich&eacute;e. </para> <para> - Pour des raisons de compatibilit&eacute; ascendante, mysql_listfields() + Pour des raisons de compatibilit&eacute; 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&eacute;es comme - argument, et retourne un identifiant de r&eacute;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&eacute;es comme + argument, et retourne un identifiant de r&eacute;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&eacute;sultat. </para> <para> - Pour des raisons de compatibilit&eacute; ascendante, mysql_listtables() + Pour des raisons de compatibilit&eacute; 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&eacute;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&eacute; ascendante mysql_numfields() + Pour des raisons de compatibilit&eacute; 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"> &lt;?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&eacute;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&eacute; ascendante mysql_numrows() est encore + Pour des raisons de compatibilit&eacute; 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 &agrave; 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&egrave;s, et sinon FALSE en cas + <para> + Retourne un lien persistant positif en cas de succ&egrave;s, et sinon FALSE en cas d'erreur. </para> <para> - <function>mysql_pconnect</function> &eacute;tablit uen connexion persistante &agrave; un serveur - MySQL. Tous les arguments sont optionnels, et des valeurs par d&eacute;faut seront - utilis&eacute;rs en cas d'omission ('localhost', nom d'utilisateur propri&eacute;taire + <function>mysql_pconnect</function> &eacute;tablit uen connexion persistante &agrave; un serveur + MySQL. Tous les arguments sont optionnels, et des valeurs par d&eacute;faut seront + utilis&eacute;rs en cas d'omission ('localhost', nom d'utilisateur propri&eacute;taire du processus, mot de passe vide). - </para> + </para> <para> - Le nom de l'h&ocirc;te peut aussi inclure le num&eacute;ro de port, c'est &agrave; dire - &quot;hostname:port&quot; ou un chemin jusqu'&agrave; la socket + Le nom de l'h&ocirc;te peut aussi inclure le num&eacute;ro de port, c'est &agrave; dire + &quot;hostname:port&quot; ou un chemin jusqu'&agrave; la socket &quot;:/path/to/socket&quot; pour l'h&ocirc;te local. <note> <para> @@ -1329,29 +1283,28 @@ Le support de &quot;:/path/to/socket&quot; a &eacute;t&eacute; ajout&eacute; 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&eacute;rences majeures : + <function>mysql_pconnect</function> se comporte exactement comme + <function>mysql_connect</function>, mais avec deux diff&eacute;rences majeures : </para> - <para> - Premi&egrave;rement, lors de la connexion, la fonction essaie de trouver une connexion - permanante d&eacute;j&agrave; ouverte sur cet hote, avec le m&ecirc;me nom d'utilisateur et de mot - de passe. Si une telle connexion est trouv&eacute;e, son identifiant est retourn&eacute;, sans + <para> + Premi&egrave;rement, lors de la connexion, la fonction essaie de trouver une connexion + permanante d&eacute;j&agrave; ouverte sur cet hote, avec le m&ecirc;me nom d'utilisateur et de mot + de passe. Si une telle connexion est trouv&eacute;e, son identifiant est retourn&eacute;, sans ouvrir de nouvelle connexion. </para> - <para> - Deuxi&egrave;mement, la connexion au serveur MySQL ne sera pas termin&eacute;e avec la fin - du script. Au lieu de cela, le lien sera conserv&eacute; pour un prochain acc&egrave;s - (<function>mysql_close</function> ne terminera pas une connexion persistante + <para> + Deuxi&egrave;mement, la connexion au serveur MySQL ne sera pas termin&eacute;e avec la fin + du script. Au lieu de cela, le lien sera conserv&eacute; pour un prochain acc&egrave;s + (<function>mysql_close</function> ne terminera pas une connexion persistante &eacute;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&ecirc;te SQL &agrave; la base de donn&eacute;es + <para> + <function>mysql_query</function> envoie une requ&ecirc;te SQL &agrave; la base de donn&eacute;es actuellement active sur le serveur MysQL. Si <parameter>link_identifier</parameter> - n'est pas pr&eacute;cis&eacute;, la derni&egrave;re connexion est utilis&eacute;e. Si aucune connexion n'a - &eacute;t&eacute; ouverte, la fonction tentera d'en ouvrir une, avec la fonction - <function>mysql_connect</function> mais sans aucun param&egrave;tre (c'est &agrave; dire avec + n'est pas pr&eacute;cis&eacute;, la derni&egrave;re connexion est utilis&eacute;e. Si aucune connexion n'a + &eacute;t&eacute; ouverte, la fonction tentera d'en ouvrir une, avec la fonction + <function>mysql_connect</function> mais sans aucun param&egrave;tre (c'est &agrave; dire avec les valeurs par d&eacute;faut). </para> <para> <function>mysql_connect</function> </para> <para> - <function>mysql_query</function> retourne TRUE ou FALSE, pour indiquer le succ&egrave;s - ou l'&eacute;chec de la requ&ecirc;te. En cas de retour TRUE, la requ&ecirc;te &eacute;tait valide et a - pu &ecirc;tre ex&eacute;cut&eacute; sur le serveur. Cela n'indique pas le nombre de ligne affect&eacute;es, - ou retourn&eacute;es. Il est parfaitement possible qu'une requ&ecirc;te valide n'affecte aucune + <function>mysql_query</function> retourne TRUE ou FALSE, pour indiquer le succ&egrave;s + ou l'&eacute;chec de la requ&ecirc;te. En cas de retour TRUE, la requ&ecirc;te &eacute;tait valide et a + pu &ecirc;tre ex&eacute;cut&eacute; sur le serveur. Cela n'indique pas le nombre de ligne affect&eacute;es, + ou retourn&eacute;es. Il est parfaitement possible qu'une requ&ecirc;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> &agrave; l'&eacute;chec, et retourne FALSE: + L'exemple suivant est syntaxiquement invalide, ce qui conduit + <function>mysql_query</function> &agrave; l'&eacute;chec, et retourne FALSE: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1400,7 +1353,7 @@ <para> L'exemple suivant est s&eacute;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> &agrave; l'&eacute;chec, et retourne FALSE : + <function>mysql_query</function> &agrave; l'&eacute;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> &eacute;chouera aussi et retournera aussi FALSE si les + <function>mysql_query</function> &eacute;chouera aussi et retournera aussi FALSE si les droits d'acc&egrave;s ne sont pas suffisants. </para> <para> - En supposant que la requ&ecirc;te r&eacute;ussisse, vous pouvez appeler - <function>mysql_affected_rows</function> pour conna&icirc;tre le nombre de lignes - affect&eacute;es (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). - Pour les commandes SELECT , <function>mysql_query</function> retourne un + En supposant que la requ&ecirc;te r&eacute;ussisse, vous pouvez appeler + <function>mysql_affected_rows</function> pour conna&icirc;tre le nombre de lignes + affect&eacute;es (pour les commandes DELETE, INSERT, REPLACE, ou UPDATE ). + Pour les commandes SELECT , <function>mysql_query</function> retourne un identifiant de r&eacute;sultat que vous pouvez passer &agrave; <function>mysql_result</function>. - Lorsque vous avez termin&eacute; avec le r&eacute;sultat, lib&eacute;rez la m&eacute;moire avec + Lorsque vous avez termin&eacute; avec le r&eacute;sultat, lib&eacute;rez la m&eacute;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&eacute;sultat MySQL. L'argument de champs <parameter>row</parameter> peut &ecirc;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 &eacute;t&eacute; alias&eacute;e, utilisez de pr&eacute;f&eacute;rence + <function>mysql_result</function> retourne le contenu d'un champs dans un + r&eacute;sultat MySQL. L'argument de champs <parameter>row</parameter> peut &ecirc;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 &eacute;t&eacute; alias&eacute;e, utilisez de pr&eacute;f&eacute;rence l'alias. </para> <para> - Lorsque vous travaillez sur des r&eacute;sultats de grande taille, vous devriez utiliser - une des fonctions qui vont rechercher une ligne enti&egrave;re dans un tableau. - Ces fonctions sont NETTEMENT plus rapides. De plus, l'utilisation d'un offset + Lorsque vous travaillez sur des r&eacute;sultats de grande taille, vous devriez utiliser + une des fonctions qui vont rechercher une ligne enti&egrave;re dans un tableau. + Ces fonctions sont NETTEMENT plus rapides. De plus, l'utilisation d'un offset num&eacute;riques est aussi beaucoup plus rapide que de sp&eacute;cifier un nom lit&eacute;ral. </para> <para> - Les appels <function>mysql_result</function> ne devraient pas &ecirc;tre m&eacute;lang&eacute;s + Les appels <function>mysql_result</function> ne devraient pas &ecirc;tre m&eacute;lang&eacute;s avec d'autres fonctions qui travaillent aussi sur le r&eacute;sultat. </para> <para> - Alternatives &agrave; haut rendement, RECOMMANDEES : - <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> et + Alternatives &agrave; 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&egrave;s, FALSE sinon. </para> - <para> - <function>mysql_select_db</function> change la base de donn&eacute;es active sur la - connexion repr&eacute;sent&eacute;e par l'identifiant de connexion. Si aucun identifiant n'est - sp&eacute;cifi&eacute;, la derni&egrave;re connexion est utilis&eacute;e. S'il n'y a pas de derni&egrave;re - connexion, la fonction tentera de se connecter seule, avec + <para> + <function>mysql_select_db</function> change la base de donn&eacute;es active sur la + connexion repr&eacute;sent&eacute;e par l'identifiant de connexion. Si aucun identifiant n'est + sp&eacute;cifi&eacute;, la derni&egrave;re connexion est utilis&eacute;e. S'il n'y a pas de derni&egrave;re + connexion, la fonction tentera de se connecter seule, avec <function>mysql_connect</function> et les param&egrave;tres par d&eacute;faut. </para> <para> Toutes les requ&ecirc;tes suivantes avec <function>mysql_query</function> seront faites avec la base de donn&eacute;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&eacute; ascendante mysql_selectdb() est - encore disponible. + Pour des raisons de compatibilit&eacute; 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&eacute;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 &ecirc;tre + <para> + <function>mysql_tablename</function> prend le pointeur de r&eacute;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 &ecirc;tre utilis&eacute;e pour d&eacute;terminer le nombre de tables dans le pointeur de r&eacute;sultat. <example> <title>Exemple <function>mysql_tablename</function></title> <programlisting role="php"> -&lt;?php +&lt;?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
« previous php.doc (#969333156) next »