cvs: phpdoc /fr/functions misc.xml mnogosearch.xml msql.xml mssql.xml
| From: | Damien Seguy | Date: | Wed, 14 Nov 2001 21:31:44 +0000 |
| Subject: | cvs: phpdoc /fr/functions misc.xml mnogosearch.xml msql.xml mssql.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338853@lists.php.net to get a copy of this message | ||
dams Wed Nov 14 16:31:44 2001 EDT
Modified files:
/phpdoc/fr/functions mnogosearch.xml msql.xml mssql.xml misc.xml
Log:
Gathering of minor update since July.
Index: phpdoc/fr/functions/mnogosearch.xml diff -u phpdoc/fr/functions/mnogosearch.xml:1.8 phpdoc/fr/functions/mnogosearch.xml:1.9 --- phpdoc/fr/functions/mnogosearch.xml:1.8 Wed Aug 8 05:39:06 2001 +++ phpdoc/fr/functions/mnogosearch.xml Wed Nov 14 16:31:42 2001 @@ -1,4 +1,5 @@ -<!-- $Revision: 1.8 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.mnogo"> <title>mnoGoSearch</title> <titleabbrev>mnoGoSearch</titleabbrev> @@ -1248,7 +1249,7 @@ utilise le cache et les bases de données internes. Par défaut, le dossier <literal>/var</literal> de l'installation de <application>mnoGoSearch</application> est utilisé. Ce - paramètre est disponible en PHP 4.0.7 et plus récent. + paramètre est disponible en PHP 4.1.0 et plus récent. </simpara> </listitem> </itemizedlist> Index: phpdoc/fr/functions/msql.xml diff -u phpdoc/fr/functions/msql.xml:1.9 phpdoc/fr/functions/msql.xml:1.10 --- phpdoc/fr/functions/msql.xml:1.9 Sat Jul 7 18:22:16 2001 +++ phpdoc/fr/functions/msql.xml Wed Nov 14 16:31:43 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> <reference id="ref.msql"> <title>mSQL</title> <titleabbrev>mSQL</titleabbrev> @@ -6,8 +8,8 @@ Ces fonctions vous permettent d'accéder aux bases de données mSQL. Pour cela, vous devez compiler PHP avec le support msql, en utilisant l'option de configuration - <option role="configure">--with-msql[=dir]</option>. Par défaut, - le chemin est '/usr/local/Hughes'. + <link linkend="install.configure.with-msql"><option role="configure">--with-msql[=dir]</option></link>. + Par défaut, le chemin est <filename>'/usr/local/Hughes'</filename>. </simpara> <simpara> Plus d'informations sur mSQL à <ulink url="&url.msql;">&url.msql;</ulink>. @@ -104,7 +106,8 @@ <function>msql_pconnect</function>. </para> <para> - Voir aussi: <function>msql_connect</function> et + Voir aussi + <function>msql_connect</function> et <function>msql_pconnect</function>. </para> </refsect1> @@ -126,7 +129,7 @@ </paramdef> <paramdef>string <parameter> - <optional>hostname<optional>:port</optional></optional> + <optional>hostname:port</optional> </parameter> </paramdef> <paramdef>string @@ -162,7 +165,9 @@ ou bien, manuellement, lors de l'appel de <function>msql_close</function>. </para> <para> - Voir aussi <function>msql_pconnect</function> et <function>msql_close</function>. + Voir aussi + <function>msql_pconnect</function> et + <function>msql_close</function>. </para> </refsect1> </refentry> @@ -176,7 +181,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>msql_create_db</function></funcdef> - <paramdef>string <parameter>database name</parameter></paramdef> + <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> @@ -184,12 +189,13 @@ </funcsynopsis> <para> <function>msql_create_db</function> essaie de créer une - nouvelle base de données sur le serveur - référencé par l'identifiant - <parameter><optional>link_identifier</optional></parameter>. + nouvelle base de données nommée <parameter>database_name</parameter> + sur le serveur référencé par l'identifiant + <parameter>link_identifier</parameter>. </para> <para> - Voir aussi: <function>msql_drop_db</function>. + Voir aussi + <function>msql_drop_db</function>. </para> </refsect1> </refentry> @@ -203,7 +209,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>msql_createdb</function></funcdef> - <paramdef>string <parameter>database name</parameter></paramdef> + <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> @@ -223,7 +229,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int </funcdef> + <funcdef>bool <function>msql_data_seek</function></funcdef> <paramdef>resource <parameter>query_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> @@ -239,7 +245,8 @@ <function>msql_fetch_row</function> retournera cette ligne. </para> <para> - Voir aussi: <function>msql_fetch_row</function>. + Voir aussi + <function>msql_fetch_row</function>. </para> </refsect1> </refentry> @@ -350,16 +357,16 @@ si il n'y a pas d'autres lignes. </para> <para> - <function>msql_fetch_array</function> est une version évoluée de - <function>msql_fetch_row</function>. En plus d'enregistrer les données - dans un tableau à indice numérique, il peut enregistrer les - données dans un tableau associatif, en utilisant les noms des champs - comme clés. + <function>msql_fetch_array</function> est une version évoluée + de <function>msql_fetch_row</function>. En plus d'enregistrer les + données dans un tableau à indice numérique, il peut + enregistrer les données dans un tableau associatif, en utilisant les + noms des champs comme clés. </para> <para> Le deuxième argument <parameter>result_type</parameter> de - <function>msql_fetch_array</function> est une constante, et peut prendre les - valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MYSQL_BOTH. + <function>msql_fetch_array</function> est une constante, et peut prendre + les valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH. </para> <para> Méfiez vous des requêtes qui retournent une ligne qui ne @@ -367,8 +374,8 @@ </para> <para> Il est important de noter que <function>msql_fetch_array</function> est - marginalement plus lent que <function>msql_fetch_row</function>, alors qu'elle - apporte un confort d'utilisation appréciable. + marginalement plus lent que <function>msql_fetch_row</function>, alors + qu'elle apporte un confort d'utilisation appréciable. </para> <para> Voir aussi @@ -435,7 +442,8 @@ </itemizedlist> </para> <para> - Voir aussi <function>msql_field_seek</function>. + Voir aussi + <function>msql_field_seek</function>. </para> </refsect1> </refentry> @@ -471,8 +479,8 @@ </para> <para> L'argument optionnel <parameter>result_type</parameter> de - <function>msql_fetch_array</function> est une constante qui peut prendre les - valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH. + <function>msql_fetch_array</function> est une constante qui peut prendre + les valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH. </para> <para> <function>msql_fetch_object</function> est aussi rapide que @@ -567,7 +575,7 @@ <para> <function>msql_field_seek</function> recherche l'offset du champs <parameter>field_offset</parameter>. Le prochain appel à - <function>msql_fetch_field</function> qui d'aura pas d'argument + <function>msql_fetch_field</function> sans l'argument <parameter>field_offset</parameter>, retournera ce champs. </para> <para> @@ -681,7 +689,7 @@ <parameter>query_identifier</parameter>. Lorsque PHP a terminé une requête, cette mémoire est libérée, ce qui fait que vous n'aurez pas besoin de cette fonction. Vous pouvez toujours - l'utiliser pour vous assurez que vous n'utilisez pas trop de mémoire + l'utiliser pour vous assurer que vous n'utilisez pas trop de mémoire durant un script. </para> </refsect1> @@ -724,11 +732,12 @@ retourne -1 si une erreur survient. Une chaîne décrivant l'erreur sera placée dans la variable <literal>$phperrmsg</literal>, et à moins que cette fonction n'ai été appelée - avec @ (<literal>@msql_list_fields()</literal>), alors cette erreur sera + avec @ (<literal>@msql_list_fields()</literal>), alors cette erreur sera affichée. </para> <para> - Voir aussi <function>msql_error</function>. + Voir aussi + <function>msql_error</function>. </para> </refsect1> </refentry> @@ -857,7 +866,9 @@ <parameter>query_identifier</parameter>. </para> <para> - Voir aussi: <function>msql</function>, <function>msql_query</function> et + Voir aussi + <function>msql</function>, + <function>msql_query</function> et <function>msql_fetch_row</function>. </para> </refsect1> @@ -915,7 +926,7 @@ </paramdef> <paramdef>string <parameter> - <optional>hostname<optional>:port</optional></optional> + <optional>hostname:port</optional> </parameter> </paramdef> <paramdef>string @@ -936,19 +947,21 @@ </para> <para> <function>msql_pconnect</function> se comporte presque comme - <function>msql_connect</function> mais avec deux différences majeures. + <function>msql_connect</function> mais avec deux différences + majeures. </para> <para> - D'abord, lors de la connexion, <function>msql_pconnect</function> cherche si une connexion - persistante a déjà été ouverte sur le - même hôte. Si une telle connexion est trouvée, elle - sera utilisée. + D'abord, lors de la connexion, <function>msql_pconnect</function> cherche + si une connexion persistante a déjà été + ouverte sur le même hôte. Si une telle connexion est + trouvée, elle sera utilisée. </para> <para> - Deuxièmement, la connexion au serveur SQL ne sera pas terminée - lors de la fin de l'exécution du script. A la place, le lien restera - ouvert pour d'autres connexions futures. (<function>msql_close</function> ne - fermera pas un lien ouvert par <function>msql_pconnect</function>). + Deuxièmement, la connexion au serveur SQL ne sera pas + terminée lors de la fin de l'exécution du script. A la place, + le lien restera ouvert pour d'autres connexions futures. + (<function>msql_close</function> ne fermera pas un lien ouvert par + <function>msql_pconnect</function>). </para> <para> C'est pourquoi une telle connexion est considérée comme @@ -972,18 +985,21 @@ </funcsynopsis> <para> <function>msql_query</function> envoie une requête à - la base de donnée active, sur le serveur associé à + la base de données active, sur le serveur associé à l'identifiant de connexion <parameter>link_identifier</parameter>. Si <parameter>link_identifier</parameter> n'est pas fourni, PHP tentera d'utiliser la dernière connexion ouverte. Si aucune connexion n'a été ouverte, la fonction tentera de se connecter par elle - même, avec <function>msql_connect</function> appelé sans argument. + même, avec <function>msql_connect</function> appelé sans + argument. </para> <para> - Retourne un identifiant positif mSQL en cas de succès, et &false; sinon. + <function>msql_query</function> retourne un identifiant positif mSQL en + cas de succès, et &false; sinon. </para> <para> - Voir aussi: <function>msql</function>, + Voir aussi + <function>msql</function>, <function>msql_select_db</function>, et <function>msql_connect</function>. </para> @@ -1037,7 +1053,7 @@ <para> Lorsque vous travailler sur des résutats de grande taille, il est préférable d'utiliser les fonctions qui récupèrent - toute la ligne (voir ci dessous). Comme ces fonctions retournent plusieurs + toute la ligne (voir ci-dessous). Comme ces fonctions retournent plusieurs cellules en même temps, elles sont beaucoup plus rapide que <function>msql_result</function>. De plus, sachez qu'accéder à un champs avec son indice numérique est beaucoup plus rapide qu'en @@ -1058,9 +1074,11 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>msql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter>link_identifier</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>msql_select_db</function> retourne &true; @@ -1095,7 +1113,8 @@ <refsect1> <title>Description</title> <para> - Voir <function>msql_select_db</function>. + Voir aussi + <function>msql_select_db</function>. </para> </refsect1> </refentry> @@ -1128,7 +1147,7 @@ $i = 0; while ($i < msql_numrows ($result)) { $tb_names[$i] = msql_tablename ($result, $i); - echo $tb_names[$i] . "<BR>"; + echo $tb_names[$i] . "<br>"; $i++; } ?> Index: phpdoc/fr/functions/mssql.xml diff -u phpdoc/fr/functions/mssql.xml:1.5 phpdoc/fr/functions/mssql.xml:1.6 --- phpdoc/fr/functions/mssql.xml:1.5 Sat Jul 7 18:22:16 2001 +++ phpdoc/fr/functions/mssql.xml Wed Nov 14 16:31:43 2001 @@ -1,7 +1,31 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.6 $ --> <reference id="ref.mssql"> <title>Microsoft SQL Server</title> <titleabbrev>MS SQL Serveur</titleabbrev> - <refentry id="function.mssql-close"> + <partintro> + <simpara> + L'extension MSSQL n'est disponible que sous Windows 32 bits. Vous pouvez + utiliser l'extension Sybase pour vous connecter à un serveur MSSQL, depuis + d'autres plate-formes. + </simpara> + <simpara> + Ces fonctions vous permettent d'accéder aux serveurs de données MS SQL. + Vous avez besoin d'un client MS SQL Client Tools sur votre système, accessible + à PHP. Les Client Tools peuvent être installé depuis le CD + MS SQL Server CD ou en copiant <filename>ntwdblib.dll</filename> depuis le dossier + <filename>\winnt\system32</filename> du serveur MS SQL vers + <filename>\winnt\system32</filename> sur le serveur PHP. + Copier <filename>ntwdblib.dll</filename> ne fera que fournir le moyen + d'accès. La configuration du client requiert l'installation des autres + outils. + </simpara> + <simpara> + L'extension MSSQL est activée par la ligne <literal>extension=php_mssql.dll</literal> + dans le fichier <filename>php.ini</filename>. + </simpara> + </partintro> + <refentry id="function.mssql-close"> <refnamediv> <refname>mssql_close</refname> <refpurpose>Ferme une connexion MS SQL Server.</refpurpose> @@ -10,7 +34,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>mssql_close</function></funcdef> + <funcdef>boolean <function>mssql_close</function></funcdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> @@ -23,7 +47,7 @@ <para> <function>mssql_close</function> ferme la connexion à la base MS SQL Server, qui était associé à - l'identifiant <parameter><optional>link_identifier</optional></parameter>. + l'identifiant <parameter>link_identifier</parameter>. Si ce dernier n'est pas précisé, la dernière connexion ouverte sera fermée. </para> @@ -193,13 +217,13 @@ <listitem> <simpara> name - nom de la colonne. Si la colonne est le résultat d'une - fonction, le nom de la colonne sera computed#N, oú #N est un + fonction, le nom de la colonne sera computed#N, où #N est un numéro de série. </simpara> </listitem> <listitem> <simpara> - column_source - le nom de la table d'oú la colonne est originaire. + column_source - le nom de la table d'où la colonne est originaire. </simpara> </listitem> <listitem> @@ -213,7 +237,8 @@ </simpara></listitem> </itemizedlist> <para> - Voir aussi <function>mssql_field_seek</function>. + Voir aussi + <function>mssql_field_seek</function>. </para> </refsect1> </refentry> @@ -225,8 +250,10 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>mssql_fetch_object</function></funcdef> + <funcprototype> + <funcdef>object <function>mssql_fetch_object</function></funcdef> <paramdef>resource <parameter>result</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_fetch_object</function> retourne un objet dont les @@ -262,8 +289,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>mssql_fetch_row</function></funcdef> <paramdef>resource <parameter>result</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_fetch_row</function> retourne un tableau qui @@ -449,6 +478,54 @@ </funcsynopsis> </refsect1> </refentry> + <refentry id="function.mssql-next-result"> + <refnamediv> + <refname>fbsql_next_result</refname> + <refpurpose>Déplace le pointeur interne vers le résultat suivant</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool + <function>mssql_next_result</function> + </funcdef> + <paramdef>resource <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Lorsque vous envoyez plus d'une commande SQL au serveur, ou que vous + exécutez une procédure stockée avec de multiple résultats, cela va + conduire le serveur à retourner plusieurs jeu de lignes. + <function>mssql_next_result</function> va vérifier l'existence de + plusieurs résultats disponibles sur le serveur. Si un autre + jeu de résultat existe, <function>mssql_next_result</function> va + détruire de résultat précédent, et + préparer la lecture dans les nouvelles lignes. + </para> + <para> + <function>mssql_next_result</function> retourne <literal>TRUE</literal> si + un autre résultat est disponbile, ou <literal>FALSE</literal> sinon. + </para> + <example> + <title>Exemple avec <function>mssql_next_result</function></title> + <programlisting role="php"> +<?php + $link = mssql_connect ("localhost", "userid", "secret"); + mssql_select_db("MyDB", $link); + $SQL = "Select * from table1 select * from table2"; + $rs = mssql_query($SQL, $link); + do { + while ($row = mssql_fetch_row($rs)) { + } + } while (mssql_next_result($rs)); + mssql_free_result($rs); + mssql_close ($link); +?> + </programlisting> + </example> + </refsect1> + </refentry> <refentry id="function.mssql-num-fields"> <refnamediv> <refname>mssql_num_fields</refname> @@ -533,8 +610,8 @@ Premièrement, lors de la connexion, la fonction va commencer par rechercher un lien persistant déjà ouvert avec le même hôte, le même nom d'utilisateur, - <parameter><optional>username</optional></parameter> et le même - mot de passe <parameter><optional>password</optional></parameter>. + <parameter>username</parameter> et le même + mot de passe <parameter>password</parameter>. Si un tel lien est trouvé, cet identifiant sera retourné, au lieux d'en ouvrir une autre connexion. </para> @@ -573,8 +650,8 @@ <para> <function>mssql_query</function> envoie la requête au serveur courant, associé à l'identifiant - <parameter><optional>link_identifier</optional></parameter> (ou la - base par défaut, si il est omis). Si aucun lien n'est ouvert, + <parameter>link_identifier</parameter> (ou la + base par défaut, s'il est omis). Si aucun lien n'est ouvert, <function>mssql_query</function> essaiera d'en ouvrir une, en appelant <function>mssql_connect</function>. </para> @@ -588,15 +665,17 @@ <refentry id="function.mssql-result"> <refnamediv> <refname>mssql_result</refname> - <refpurpose>Get result data.</refpurpose> + <refpurpose>Lit les données d'un résultat.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>mssql_result</function></funcdef> <paramdef>mssql_query <parameter>result</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> <paramdef>mixed <parameter>field</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_result</function> retourne la valeur de la colonne, à la @@ -606,7 +685,7 @@ <para> <function>mssql_result</function> retourne le contenu d'une des cellules d'un résultat MS SQL. Le nom du champs - peut être son nom litéral ou son offet, ou + peut être son nom littéral ou son offet, ou encore, le nom de la table + "." + le nom du champs, ou encore la même chose avec le nom de la base de données. Si la colonne a été @@ -633,16 +712,18 @@ <refentry id="function.mssql-select-db"> <refnamediv> <refname>mssql_select_db</refname> - <refpurpose>Selectionne la base de données MS SQL.</refpurpose> + <refpurpose>Sélectionne la base de données MS SQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>mssql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_select_db</function> retourne &true; Index: phpdoc/fr/functions/misc.xml diff -u phpdoc/fr/functions/misc.xml:1.11 phpdoc/fr/functions/misc.xml:1.12 --- phpdoc/fr/functions/misc.xml:1.11 Thu Jul 12 07:11:33 2001 +++ phpdoc/fr/functions/misc.xml Wed Nov 14 16:31:43 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.12 $ --> <reference id="ref.misc"> <title>Fonctions diverses</title> <titleabbrev>Divers</titleabbrev> @@ -225,7 +227,7 @@ <refnamediv> <refname>die</refname> <refpurpose> - Affiche un message et termine le script courant + Alias de la fonction <function>die</function> </refpurpose> </refnamediv> <refsect1> @@ -237,22 +239,9 @@ </funcprototype> </funcsynopsis> <simpara> - <function>die</function> affiche la chaîne passée - en paramètre, puis termine l'exécution - du script. Il ne retourne rien de plus. + <function>die</function> est un alias de + <function>exit</function>. </simpara> - <para> - <example> - <title>Exemple avec <function>die</function></title> - <programlisting role="php"> -<?php -$filename = '/path/to/data-file'; -$file = fopen ($filename, 'r') - or die("impossible d'ouvrir le fichier ($filename)"); -?> - </programlisting> - </example> - </para> </refsect1> </refentry> <refentry id="function.eval"> @@ -320,14 +309,43 @@ <funcsynopsis> <funcprototype> <funcdef>void <function>exit</function></funcdef> - <paramdef>mixed <parameter>status</parameter></paramdef> + <paramdef>string <parameter>status</parameter></paramdef> </funcprototype> - </funcsynopsis> + <funcprototype> + <funcdef>void <function>exit</function></funcdef> + <paramdef>int <parameter>status</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <note> + <simpara> + <function>exit</function> n'est pas une véritable fonction, + mais un élément de langage. + </simpara> + </note> <simpara> <function>exit</function> termine l'éxécution du script courant. Elle n'a pas de valeur de retour (et pour cause!), mais elle utilisera le message <parameter>status</parameter> comme message de fin d'exécution. </simpara> + <note> + <simpara> + La fonction <function>die</function> est un alias de la fonction + <function>exit</function>. + </simpara> + </note> + <para> + <example> + <title><function>exit</function> example</title> + <programlisting role="php"> +<?php + $filename = '/chemin/jusqua/fichier'; + $file = fopen ($filename, 'r') + or exit("Impossible d'ouvrir le fichier $filename"); +?> + </programlisting> + <!-- TODO: example with integer exit-statis --> + </example> + </para> </refsect1> </refentry> <refentry id="function.get-browser">
Index: phpdoc/fr/functions/mnogosearch.xml diff -u phpdoc/fr/functions/mnogosearch.xml:1.8 phpdoc/fr/functions/mnogosearch.xml:1.9 --- phpdoc/fr/functions/mnogosearch.xml:1.8 Wed Aug 8 05:39:06 2001 +++ phpdoc/fr/functions/mnogosearch.xml Wed Nov 14 16:31:42 2001 @@ -1,4 +1,5 @@ -<!-- $Revision: 1.8 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.9 $ --> <reference id="ref.mnogo"> <title>mnoGoSearch</title> <titleabbrev>mnoGoSearch</titleabbrev> @@ -1248,7 +1249,7 @@ utilise le cache et les bases de données internes. Par défaut, le dossier <literal>/var</literal> de l'installation de <application>mnoGoSearch</application> est utilisé. Ce - paramètre est disponible en PHP 4.0.7 et plus récent. + paramètre est disponible en PHP 4.1.0 et plus récent. </simpara> </listitem> </itemizedlist> Index: phpdoc/fr/functions/msql.xml diff -u phpdoc/fr/functions/msql.xml:1.9 phpdoc/fr/functions/msql.xml:1.10 --- phpdoc/fr/functions/msql.xml:1.9 Sat Jul 7 18:22:16 2001 +++ phpdoc/fr/functions/msql.xml Wed Nov 14 16:31:43 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> <reference id="ref.msql"> <title>mSQL</title> <titleabbrev>mSQL</titleabbrev> @@ -6,8 +8,8 @@ Ces fonctions vous permettent d'accéder aux bases de données mSQL. Pour cela, vous devez compiler PHP avec le support msql, en utilisant l'option de configuration - <option role="configure">--with-msql[=dir]</option>. Par défaut, - le chemin est '/usr/local/Hughes'. + <link linkend="install.configure.with-msql"><option role="configure">--with-msql[=dir]</option></link>. + Par défaut, le chemin est <filename>'/usr/local/Hughes'</filename>. </simpara> <simpara> Plus d'informations sur mSQL à <ulink url="&url.msql;">&url.msql;</ulink>. @@ -104,7 +106,8 @@ <function>msql_pconnect</function>. </para> <para> - Voir aussi: <function>msql_connect</function> et + Voir aussi + <function>msql_connect</function> et <function>msql_pconnect</function>. </para> </refsect1> @@ -126,7 +129,7 @@ </paramdef> <paramdef>string <parameter> - <optional>hostname<optional>:port</optional></optional> + <optional>hostname:port</optional> </parameter> </paramdef> <paramdef>string @@ -162,7 +165,9 @@ ou bien, manuellement, lors de l'appel de <function>msql_close</function>. </para> <para> - Voir aussi <function>msql_pconnect</function> et <function>msql_close</function>. + Voir aussi + <function>msql_pconnect</function> et + <function>msql_close</function>. </para> </refsect1> </refentry> @@ -176,7 +181,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>msql_create_db</function></funcdef> - <paramdef>string <parameter>database name</parameter></paramdef> + <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> @@ -184,12 +189,13 @@ </funcsynopsis> <para> <function>msql_create_db</function> essaie de créer une - nouvelle base de données sur le serveur - référencé par l'identifiant - <parameter><optional>link_identifier</optional></parameter>. + nouvelle base de données nommée <parameter>database_name</parameter> + sur le serveur référencé par l'identifiant + <parameter>link_identifier</parameter>. </para> <para> - Voir aussi: <function>msql_drop_db</function>. + Voir aussi + <function>msql_drop_db</function>. </para> </refsect1> </refentry> @@ -203,7 +209,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>msql_createdb</function></funcdef> - <paramdef>string <parameter>database name</parameter></paramdef> + <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> @@ -223,7 +229,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int </funcdef> + <funcdef>bool <function>msql_data_seek</function></funcdef> <paramdef>resource <parameter>query_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> @@ -239,7 +245,8 @@ <function>msql_fetch_row</function> retournera cette ligne. </para> <para> - Voir aussi: <function>msql_fetch_row</function>. + Voir aussi + <function>msql_fetch_row</function>. </para> </refsect1> </refentry> @@ -350,16 +357,16 @@ si il n'y a pas d'autres lignes. </para> <para> - <function>msql_fetch_array</function> est une version évoluée de - <function>msql_fetch_row</function>. En plus d'enregistrer les données - dans un tableau à indice numérique, il peut enregistrer les - données dans un tableau associatif, en utilisant les noms des champs - comme clés. + <function>msql_fetch_array</function> est une version évoluée + de <function>msql_fetch_row</function>. En plus d'enregistrer les + données dans un tableau à indice numérique, il peut + enregistrer les données dans un tableau associatif, en utilisant les + noms des champs comme clés. </para> <para> Le deuxième argument <parameter>result_type</parameter> de - <function>msql_fetch_array</function> est une constante, et peut prendre les - valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MYSQL_BOTH. + <function>msql_fetch_array</function> est une constante, et peut prendre + les valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH. </para> <para> Méfiez vous des requêtes qui retournent une ligne qui ne @@ -367,8 +374,8 @@ </para> <para> Il est important de noter que <function>msql_fetch_array</function> est - marginalement plus lent que <function>msql_fetch_row</function>, alors qu'elle - apporte un confort d'utilisation appréciable. + marginalement plus lent que <function>msql_fetch_row</function>, alors + qu'elle apporte un confort d'utilisation appréciable. </para> <para> Voir aussi @@ -435,7 +442,8 @@ </itemizedlist> </para> <para> - Voir aussi <function>msql_field_seek</function>. + Voir aussi + <function>msql_field_seek</function>. </para> </refsect1> </refentry> @@ -471,8 +479,8 @@ </para> <para> L'argument optionnel <parameter>result_type</parameter> de - <function>msql_fetch_array</function> est une constante qui peut prendre les - valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH. + <function>msql_fetch_array</function> est une constante qui peut prendre + les valeurs suivantes : MSQL_ASSOC, MSQL_NUM, et MSQL_BOTH. </para> <para> <function>msql_fetch_object</function> est aussi rapide que @@ -567,7 +575,7 @@ <para> <function>msql_field_seek</function> recherche l'offset du champs <parameter>field_offset</parameter>. Le prochain appel à - <function>msql_fetch_field</function> qui d'aura pas d'argument + <function>msql_fetch_field</function> sans l'argument <parameter>field_offset</parameter>, retournera ce champs. </para> <para> @@ -681,7 +689,7 @@ <parameter>query_identifier</parameter>. Lorsque PHP a terminé une requête, cette mémoire est libérée, ce qui fait que vous n'aurez pas besoin de cette fonction. Vous pouvez toujours - l'utiliser pour vous assurez que vous n'utilisez pas trop de mémoire + l'utiliser pour vous assurer que vous n'utilisez pas trop de mémoire durant un script. </para> </refsect1> @@ -724,11 +732,12 @@ retourne -1 si une erreur survient. Une chaîne décrivant l'erreur sera placée dans la variable <literal>$phperrmsg</literal>, et à moins que cette fonction n'ai été appelée - avec @ (<literal>@msql_list_fields()</literal>), alors cette erreur sera + avec @ (<literal>@msql_list_fields()</literal>), alors cette erreur sera affichée. </para> <para> - Voir aussi <function>msql_error</function>. + Voir aussi + <function>msql_error</function>. </para> </refsect1> </refentry> @@ -857,7 +866,9 @@ <parameter>query_identifier</parameter>. </para> <para> - Voir aussi: <function>msql</function>, <function>msql_query</function> et + Voir aussi + <function>msql</function>, + <function>msql_query</function> et <function>msql_fetch_row</function>. </para> </refsect1> @@ -915,7 +926,7 @@ </paramdef> <paramdef>string <parameter> - <optional>hostname<optional>:port</optional></optional> + <optional>hostname:port</optional> </parameter> </paramdef> <paramdef>string @@ -936,19 +947,21 @@ </para> <para> <function>msql_pconnect</function> se comporte presque comme - <function>msql_connect</function> mais avec deux différences majeures. + <function>msql_connect</function> mais avec deux différences + majeures. </para> <para> - D'abord, lors de la connexion, <function>msql_pconnect</function> cherche si une connexion - persistante a déjà été ouverte sur le - même hôte. Si une telle connexion est trouvée, elle - sera utilisée. + D'abord, lors de la connexion, <function>msql_pconnect</function> cherche + si une connexion persistante a déjà été + ouverte sur le même hôte. Si une telle connexion est + trouvée, elle sera utilisée. </para> <para> - Deuxièmement, la connexion au serveur SQL ne sera pas terminée - lors de la fin de l'exécution du script. A la place, le lien restera - ouvert pour d'autres connexions futures. (<function>msql_close</function> ne - fermera pas un lien ouvert par <function>msql_pconnect</function>). + Deuxièmement, la connexion au serveur SQL ne sera pas + terminée lors de la fin de l'exécution du script. A la place, + le lien restera ouvert pour d'autres connexions futures. + (<function>msql_close</function> ne fermera pas un lien ouvert par + <function>msql_pconnect</function>). </para> <para> C'est pourquoi une telle connexion est considérée comme @@ -972,18 +985,21 @@ </funcsynopsis> <para> <function>msql_query</function> envoie une requête à - la base de donnée active, sur le serveur associé à + la base de données active, sur le serveur associé à l'identifiant de connexion <parameter>link_identifier</parameter>. Si <parameter>link_identifier</parameter> n'est pas fourni, PHP tentera d'utiliser la dernière connexion ouverte. Si aucune connexion n'a été ouverte, la fonction tentera de se connecter par elle - même, avec <function>msql_connect</function> appelé sans argument. + même, avec <function>msql_connect</function> appelé sans + argument. </para> <para> - Retourne un identifiant positif mSQL en cas de succès, et &false; sinon. + <function>msql_query</function> retourne un identifiant positif mSQL en + cas de succès, et &false; sinon. </para> <para> - Voir aussi: <function>msql</function>, + Voir aussi + <function>msql</function>, <function>msql_select_db</function>, et <function>msql_connect</function>. </para> @@ -1037,7 +1053,7 @@ <para> Lorsque vous travailler sur des résutats de grande taille, il est préférable d'utiliser les fonctions qui récupèrent - toute la ligne (voir ci dessous). Comme ces fonctions retournent plusieurs + toute la ligne (voir ci-dessous). Comme ces fonctions retournent plusieurs cellules en même temps, elles sont beaucoup plus rapide que <function>msql_result</function>. De plus, sachez qu'accéder à un champs avec son indice numérique est beaucoup plus rapide qu'en @@ -1058,9 +1074,11 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>msql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter>link_identifier</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>msql_select_db</function> retourne &true; @@ -1095,7 +1113,8 @@ <refsect1> <title>Description</title> <para> - Voir <function>msql_select_db</function>. + Voir aussi + <function>msql_select_db</function>. </para> </refsect1> </refentry> @@ -1128,7 +1147,7 @@ $i = 0; while ($i < msql_numrows ($result)) { $tb_names[$i] = msql_tablename ($result, $i); - echo $tb_names[$i] . "<BR>"; + echo $tb_names[$i] . "<br>"; $i++; } ?> Index: phpdoc/fr/functions/mssql.xml diff -u phpdoc/fr/functions/mssql.xml:1.5 phpdoc/fr/functions/mssql.xml:1.6 --- phpdoc/fr/functions/mssql.xml:1.5 Sat Jul 7 18:22:16 2001 +++ phpdoc/fr/functions/mssql.xml Wed Nov 14 16:31:43 2001 @@ -1,7 +1,31 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.6 $ --> <reference id="ref.mssql"> <title>Microsoft SQL Server</title> <titleabbrev>MS SQL Serveur</titleabbrev> - <refentry id="function.mssql-close"> + <partintro> + <simpara> + L'extension MSSQL n'est disponible que sous Windows 32 bits. Vous pouvez + utiliser l'extension Sybase pour vous connecter à un serveur MSSQL, depuis + d'autres plate-formes. + </simpara> + <simpara> + Ces fonctions vous permettent d'accéder aux serveurs de données MS SQL. + Vous avez besoin d'un client MS SQL Client Tools sur votre système, accessible + à PHP. Les Client Tools peuvent être installé depuis le CD + MS SQL Server CD ou en copiant <filename>ntwdblib.dll</filename> depuis le dossier + <filename>\winnt\system32</filename> du serveur MS SQL vers + <filename>\winnt\system32</filename> sur le serveur PHP. + Copier <filename>ntwdblib.dll</filename> ne fera que fournir le moyen + d'accès. La configuration du client requiert l'installation des autres + outils. + </simpara> + <simpara> + L'extension MSSQL est activée par la ligne <literal>extension=php_mssql.dll</literal> + dans le fichier <filename>php.ini</filename>. + </simpara> + </partintro> + <refentry id="function.mssql-close"> <refnamediv> <refname>mssql_close</refname> <refpurpose>Ferme une connexion MS SQL Server.</refpurpose> @@ -10,7 +34,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>bool <function>mssql_close</function></funcdef> + <funcdef>boolean <function>mssql_close</function></funcdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> @@ -23,7 +47,7 @@ <para> <function>mssql_close</function> ferme la connexion à la base MS SQL Server, qui était associé à - l'identifiant <parameter><optional>link_identifier</optional></parameter>. + l'identifiant <parameter>link_identifier</parameter>. Si ce dernier n'est pas précisé, la dernière connexion ouverte sera fermée. </para> @@ -193,13 +217,13 @@ <listitem> <simpara> name - nom de la colonne. Si la colonne est le résultat d'une - fonction, le nom de la colonne sera computed#N, oú #N est un + fonction, le nom de la colonne sera computed#N, où #N est un numéro de série. </simpara> </listitem> <listitem> <simpara> - column_source - le nom de la table d'oú la colonne est originaire. + column_source - le nom de la table d'où la colonne est originaire. </simpara> </listitem> <listitem> @@ -213,7 +237,8 @@ </simpara></listitem> </itemizedlist> <para> - Voir aussi <function>mssql_field_seek</function>. + Voir aussi + <function>mssql_field_seek</function>. </para> </refsect1> </refentry> @@ -225,8 +250,10 @@ <refsect1> <title>Description</title> <funcsynopsis> - <funcdef>int <function>mssql_fetch_object</function></funcdef> + <funcprototype> + <funcdef>object <function>mssql_fetch_object</function></funcdef> <paramdef>resource <parameter>result</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_fetch_object</function> retourne un objet dont les @@ -262,8 +289,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>mssql_fetch_row</function></funcdef> <paramdef>resource <parameter>result</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_fetch_row</function> retourne un tableau qui @@ -449,6 +478,54 @@ </funcsynopsis> </refsect1> </refentry> + <refentry id="function.mssql-next-result"> + <refnamediv> + <refname>fbsql_next_result</refname> + <refpurpose>Déplace le pointeur interne vers le résultat suivant</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool + <function>mssql_next_result</function> + </funcdef> + <paramdef>resource <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Lorsque vous envoyez plus d'une commande SQL au serveur, ou que vous + exécutez une procédure stockée avec de multiple résultats, cela va + conduire le serveur à retourner plusieurs jeu de lignes. + <function>mssql_next_result</function> va vérifier l'existence de + plusieurs résultats disponibles sur le serveur. Si un autre + jeu de résultat existe, <function>mssql_next_result</function> va + détruire de résultat précédent, et + préparer la lecture dans les nouvelles lignes. + </para> + <para> + <function>mssql_next_result</function> retourne <literal>TRUE</literal> si + un autre résultat est disponbile, ou <literal>FALSE</literal> sinon. + </para> + <example> + <title>Exemple avec <function>mssql_next_result</function></title> + <programlisting role="php"> +<?php + $link = mssql_connect ("localhost", "userid", "secret"); + mssql_select_db("MyDB", $link); + $SQL = "Select * from table1 select * from table2"; + $rs = mssql_query($SQL, $link); + do { + while ($row = mssql_fetch_row($rs)) { + } + } while (mssql_next_result($rs)); + mssql_free_result($rs); + mssql_close ($link); +?> + </programlisting> + </example> + </refsect1> + </refentry> <refentry id="function.mssql-num-fields"> <refnamediv> <refname>mssql_num_fields</refname> @@ -533,8 +610,8 @@ Premièrement, lors de la connexion, la fonction va commencer par rechercher un lien persistant déjà ouvert avec le même hôte, le même nom d'utilisateur, - <parameter><optional>username</optional></parameter> et le même - mot de passe <parameter><optional>password</optional></parameter>. + <parameter>username</parameter> et le même + mot de passe <parameter>password</parameter>. Si un tel lien est trouvé, cet identifiant sera retourné, au lieux d'en ouvrir une autre connexion. </para> @@ -573,8 +650,8 @@ <para> <function>mssql_query</function> envoie la requête au serveur courant, associé à l'identifiant - <parameter><optional>link_identifier</optional></parameter> (ou la - base par défaut, si il est omis). Si aucun lien n'est ouvert, + <parameter>link_identifier</parameter> (ou la + base par défaut, s'il est omis). Si aucun lien n'est ouvert, <function>mssql_query</function> essaiera d'en ouvrir une, en appelant <function>mssql_connect</function>. </para> @@ -588,15 +665,17 @@ <refentry id="function.mssql-result"> <refnamediv> <refname>mssql_result</refname> - <refpurpose>Get result data.</refpurpose> + <refpurpose>Lit les données d'un résultat.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>mssql_result</function></funcdef> <paramdef>mssql_query <parameter>result</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> <paramdef>mixed <parameter>field</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_result</function> retourne la valeur de la colonne, à la @@ -606,7 +685,7 @@ <para> <function>mssql_result</function> retourne le contenu d'une des cellules d'un résultat MS SQL. Le nom du champs - peut être son nom litéral ou son offet, ou + peut être son nom littéral ou son offet, ou encore, le nom de la table + "." + le nom du champs, ou encore la même chose avec le nom de la base de données. Si la colonne a été @@ -633,16 +712,18 @@ <refentry id="function.mssql-select-db"> <refnamediv> <refname>mssql_select_db</refname> - <refpurpose>Selectionne la base de données MS SQL.</refpurpose> + <refpurpose>Sélectionne la base de données MS SQL.</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>mssql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> + </funcprototype> </funcsynopsis> <para> <function>mssql_select_db</function> retourne &true; Index: phpdoc/fr/functions/misc.xml diff -u phpdoc/fr/functions/misc.xml:1.11 phpdoc/fr/functions/misc.xml:1.12 --- phpdoc/fr/functions/misc.xml:1.11 Thu Jul 12 07:11:33 2001 +++ phpdoc/fr/functions/misc.xml Wed Nov 14 16:31:43 2001 @@ -1,3 +1,5 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.12 $ --> <reference id="ref.misc"> <title>Fonctions diverses</title> <titleabbrev>Divers</titleabbrev> @@ -225,7 +227,7 @@ <refnamediv> <refname>die</refname> <refpurpose> - Affiche un message et termine le script courant + Alias de la fonction <function>die</function> </refpurpose> </refnamediv> <refsect1> @@ -237,22 +239,9 @@ </funcprototype> </funcsynopsis> <simpara> - <function>die</function> affiche la chaîne passée - en paramètre, puis termine l'exécution - du script. Il ne retourne rien de plus. + <function>die</function> est un alias de + <function>exit</function>. </simpara> - <para> - <example> - <title>Exemple avec <function>die</function></title> - <programlisting role="php"> -<?php -$filename = '/path/to/data-file'; -$file = fopen ($filename, 'r') - or die("impossible d'ouvrir le fichier ($filename)"); -?> - </programlisting> - </example> - </para> </refsect1> </refentry> <refentry id="function.eval"> @@ -320,14 +309,43 @@ <funcsynopsis> <funcprototype> <funcdef>void <function>exit</function></funcdef> - <paramdef>mixed <parameter>status</parameter></paramdef> + <paramdef>string <parameter>status</parameter></paramdef> </funcprototype> - </funcsynopsis> + <funcprototype> + <funcdef>void <function>exit</function></funcdef> + <paramdef>int <parameter>status</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <note> + <simpara> + <function>exit</function> n'est pas une véritable fonction, + mais un élément de langage. + </simpara> + </note> <simpara> <function>exit</function> termine l'éxécution du script courant. Elle n'a pas de valeur de retour (et pour cause!), mais elle utilisera le message <parameter>status</parameter> comme message de fin d'exécution. </simpara> + <note> + <simpara> + La fonction <function>die</function> est un alias de la fonction + <function>exit</function>. + </simpara> + </note> + <para> + <example> + <title><function>exit</function> example</title> + <programlisting role="php"> +<?php + $filename = '/chemin/jusqua/fichier'; + $file = fopen ($filename, 'r') + or exit("Impossible d'ouvrir le fichier $filename"); +?> + </programlisting> + <!-- TODO: example with integer exit-statis --> + </example> + </para> </refsect1> </refentry> <refentry id="function.get-browser">