dams Tue Feb 27 03:57:41 2001 EDT Modified files: /phpdoc/fr/language control-structures.xml functions.xml variables.xml constants.xml Log: Added minor examples translation. Corrected a few typos
Index: phpdoc/fr/language/control-structures.xml diff -u phpdoc/fr/language/control-structures.xml:1.8 phpdoc/fr/language/control-structures.xml:1.9 --- phpdoc/fr/language/control-structures.xml:1.8 Mon Feb 26 03:11:18 2001 +++ phpdoc/fr/language/control-structures.xml Tue Feb 27 03:57:41 2001 @@ -29,16 +29,16 @@ </informalexample> </para> <simpara> - Comme nous l'avons vu dans le paragraphe consacré aux expressions, - <replaceable>expr</replaceable> est évaluée à - sa vraie valeur. Si l'expression <replaceable>expr</replaceable> est - <literal>TRUE</literal>, PHP exécutera l'instruction et si elle - est <literal>FALSE</literal>, l'instruction sera ignorée. + Comme nous l'avons vu dans le paragraphe consacré aux expressions, + <replaceable>expr</replaceable> est évaluée à + sa vraie valeur. Si l'expression <replaceable>expr</replaceable> est + <literal>TRUE</literal>, PHP exécutera l'instruction et si elle + est <literal>FALSE</literal>, l'instruction sera ignorée. </simpara> <para> - L'exemple suivant affiche la phrase <computeroutput>a est plus grand - que b</computeroutput> si <replaceable>$a</replaceable> est plus grand - que <replaceable>$b</replaceable>: + L'exemple suivant affiche la phrase <computeroutput>a est plus grand + que b</computeroutput> si <replaceable>$a</replaceable> est plus grand + que <replaceable>$b</replaceable>: <informalexample> <programlisting role="php"> <?php @@ -70,26 +70,26 @@ </informalexample> </para> <simpara> - Vous pouvez imbriquer indéfiniment des instructions - <literal>if</literal> les unes dans les autres, ce qui permet - une grande flexibilité dans l'exécution d'une - partie de code suivant un grand nombre de conditions. + Vous pouvez imbriquer indéfiniment des instructions + <literal>if</literal> les unes dans les autres, ce qui permet + une grande flexibilité dans l'exécution d'une + partie de code suivant un grand nombre de conditions. </simpara> </sect1> <sect1 id="control-structures.else"> <title><literal>else</literal></title> <para> - Souvent, vous voulez exécuter une instruction si une - condition est remplie, et une autre instruction si cette condition - n'est pas remplie. C'est à cela que sert <literal>else</literal>. - <literal>else</literal> fonctionne avec après un - <literal>if</literal> et exécute les instructions - correspondantes au cas oú l'expression du <literal>if</literal> - est <literal>FALSE</literal>. Dans l'exemple suivant, ce bout de code - affiche <computeroutput>a est plus grand que b</computeroutput> si la - variable <replaceable>$a</replaceable> est plus grande que la variable - <replaceable>$a</replaceable>, et <computeroutput>a est plus petit que b - </computeroutput> sinon: + Souvent, vous voulez exécuter une instruction si une + condition est remplie, et une autre instruction si cette condition + n'est pas remplie. C'est à cela que sert <literal>else</literal>. + <literal>else</literal> fonctionne avec après un + <literal>if</literal> et exécute les instructions + correspondantes au cas oú l'expression du <literal>if</literal> + est <literal>FALSE</literal>. Dans l'exemple suivant, ce bout de code + affiche <computeroutput>a est plus grand que b</computeroutput> si la + variable <replaceable>$a</replaceable> est plus grande que la variable + <replaceable>$a</replaceable>, et <computeroutput>a est plus petit que +b</computeroutput> + sinon: <informalexample> <programlisting role="php"> <?php @@ -101,10 +101,10 @@ ?> </programlisting> </informalexample> - Les instructions après le <literal>else</literal> ne sont - exécutées que si l'expression du <literal>if</literal> - est <literal>FALSE</literal>, et si elle n'est pas suivi par l'expression - <literal>elseif</literal>. + Les instructions après le <literal>else</literal> ne sont + exécutées que si l'expression du <literal>if</literal> + est <literal>FALSE</literal>, et si elle n'est pas suivi par l'expression + <literal>elseif</literal>. </para> </sect1> <sect1 id="control-structures.elseif"> @@ -156,15 +156,15 @@ <sect1 id="control-structures.alternative-syntax"> <title>Syntaxe alternative</title> <para> - Le PHP propose une autre manière de rassembler des - instructions à l'intérieur d'un bloc, pour les - fonctions de contrôle <literal>if</literal>, - <literal>while</literal>, <literal>for</literal>, et - <literal>switch</literal>. Dans chaque cas, le principe - est de remplacer l'accolade d'ouverture par deux points (:) - et l'accolade de fermeture par, respectivement, - <literal>endif;</literal>, <literal>endwhile;</literal>, - <literal>endfor;</literal>, ou <literal>endswitch;</literal>. + Le PHP propose une autre manière de rassembler des + instructions à l'intérieur d'un bloc, pour les + fonctions de contrôle <literal>if</literal>, + <literal>while</literal>, <literal>for</literal>, et + <literal>switch</literal>. Dans chaque cas, le principe + est de remplacer l'accolade d'ouverture par deux points (:) + et l'accolade de fermeture par, respectivement, + <literal>endif;</literal>, <literal>endwhile;</literal>, + <literal>endfor;</literal>, ou <literal>endswitch;</literal>. <informalexample> <programlisting role="php"> <?php if ($a == 5): ?> @@ -357,35 +357,35 @@ </informalexample> </para> <simpara> - La première expression (<replaceable>expr1</replaceable>) est - évaluée (exécutée), quoi qu'il arrive au - début de la boucle. + La première expression (<replaceable>expr1</replaceable>) est + évaluée (exécutée), quoi qu'il arrive au + début de la boucle. </simpara> <simpara> - Au début de chaque itération, l'expression - <replaceable>expr2</replaceable> est évaluée. - Si l'évaluation vaut <literal>TRUE</literal>, la boucle - continue et l'instruction est exécutée. Si - l'évaluation vaut <literal>FALSE</literal>, - l'exécution de la boucle s'arrête. + Au début de chaque itération, l'expression + <replaceable>expr2</replaceable> est évaluée. + Si l'évaluation vaut <literal>TRUE</literal>, la boucle + continue et l'instruction est exécutée. Si + l'évaluation vaut <literal>FALSE</literal>, + l'exécution de la boucle s'arrête. </simpara> <simpara> - A la fin de chaque itération, l'expression - <replaceable>expr3</replaceable> est évaluée - (exécutée). + A la fin de chaque itération, l'expression + <replaceable>expr3</replaceable> est évaluée + (exécutée). </simpara> <simpara> - Les expressions peuvent éventuellement être - laissées vides. Si l'expression <replaceable>expr2</replaceable> - est laissée vide, cela signifie que c'est une boucle infinie - (PHP considère implicitement qu'elle vaut <literal>TRUE</literal>, comme en C). - Cela n'est pas vraiment très utile, à moins que vous - souhaitiez terminer votre boucle par l'instruction conditionnelle - <link linkend="control-structures.break"><literal>break</literal></link>. + Les expressions peuvent éventuellement être + laissées vides. Si l'expression <replaceable>expr2</replaceable> + est laissée vide, cela signifie que c'est une boucle infinie + (PHP considère implicitement qu'elle vaut <literal>TRUE</literal>, + comme en C). Cela n'est pas vraiment très utile, à moins que vous + souhaitiez terminer votre boucle par l'instruction conditionnelle + <link linkend="control-structures.break"><literal>break</literal></link>. </simpara> <para> - Considérons les exemples suivants. Tous affichent les chiffres de - 1 à 10: + Considérons les exemples suivants. Tous affichent les chiffres de + 1 à 10: <informalexample> <programlisting role="php"> <?php @@ -638,7 +638,7 @@ à cela que sert l'instruction <literal>switch</literal>. </simpara> <para> - L4es deux exemples suivants sont deux manières + Les deux exemples suivants sont deux manières différentes d'écrire la même chose, l'une en utilisant une séries de <literal>if</literal>, et l'autre en utilisant l'instruction <literal>switch</literal>: @@ -1185,20 +1185,20 @@ </informalexample> </para> <para> - Notez aussi que, de la même manière que les - préprocesseur traitent les <literal>#include</literal>, - cette commande est exécutée au moment de la - compilation, c'est à dire lorsque le script est - analysée, et avant qu'il soit exécuté, - et ne doit pas être utilisée pour insérer - des données dynamiques liées à - l'éxécution. Il vaut alors mieux utiliser - <function>include_once</function> ou <function>include</function>. + Notez aussi que, de la même manière que les + préprocesseur traitent les <literal>#include</literal>, + cette commande est exécutée au moment de la + compilation, c'est à dire lorsque le script est + analysée, et avant qu'il soit exécuté, + et ne doit pas être utilisée pour insérer + des données dynamiques liées à + l'éxécution. Il vaut alors mieux utiliser + <function>include_once</function> ou <function>include</function>. </para> <para> - Pour plus d'exemples avec <function>require_once</function> et - <function>include_once</function>, jetez un oeil dans le code de PEAR - inclus dans la dernière distribution de PHP. + Pour plus d'exemples avec <function>require_once</function> et + <function>include_once</function>, jetez un oeil dans le code de PEAR + inclus dans la dernière distribution de PHP. </para> <para> Voir aussi : <function>require</function>, Index: phpdoc/fr/language/functions.xml diff -u phpdoc/fr/language/functions.xml:1.5 phpdoc/fr/language/functions.xml:1.6 --- phpdoc/fr/language/functions.xml:1.5 Fri Jan 19 00:51:16 2001 +++ phpdoc/fr/language/functions.xml Tue Feb 27 03:57:41 2001 @@ -16,17 +16,17 @@ </informalexample> </para> <simpara> - Tout code PHP, correct syntaxiquement, peut apparaître - dans une fonction et dans une définition de - <link linkend="keyword.class">classe</link>. + Tout code PHP, correct syntaxiquement, peut apparaître + dans une fonction et dans une définition de + <link linkend="keyword.class">classe</link>. </simpara> <simpara> En PHP 3, les fonctions doivent être définies avant qu'elles ne soient utilisées. Ce n'est plus le cas en PHP 4. </simpara> <simpara> - PHP ne supporte pas le surchargement de fonction, ni la destruction ou la - redéfinition de fonctions déjà déclarées. + PHP ne supporte pas le surchargement de fonction, ni la destruction ou la + redéfinition de fonctions déjà déclarées. </simpara> <simpara> PHP 3 ne supporte pas un nombre variable d'arguments (voir Index: phpdoc/fr/language/variables.xml diff -u phpdoc/fr/language/variables.xml:1.21 phpdoc/fr/language/variables.xml:1.22 --- phpdoc/fr/language/variables.xml:1.21 Fri Feb 9 05:57:59 2001 +++ phpdoc/fr/language/variables.xml Tue Feb 27 03:57:41 2001 @@ -11,7 +11,7 @@ Les noms de variables suivent les mêmes règles de nommage que les autres entitées PHP. Un nom de variable valide doit commencer par une lettre ou un souligné (_), suivi de lettres, chiffres ou soulignés. - Exprimé sous forme d'expressions régulière, cela donne : + Exprimé sous forme d'une expression régulière, cela donne : '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*' </para> <note> @@ -27,16 +27,16 @@ <?php $var = "Jean"; $Var = "Paul"; -echo "$var, $Var"; // affiche "Jean, Paul" +echo "$var, $Var"; // affiche "Jean, Paul" $4site = 'pas encore'; // invalide : commence par un nombre $_4site = 'pas encore'; // valide : commence par un souligné -$maïs = 'jaune'; // valide; 'ï' est ASCII 239. +$maïs = 'jaune'; // valide; 'ï' est ASCII 239. ?> </programlisting> </informalexample> </para> <para> - En PHP3, les variables sont toujours assignées par valeur. + En PHP 3, les variables sont toujours assignées par valeur. C'est à dire, lorsque vous assignez une expression à une variable, la valeur de l'expression est recopiée dans la variable. Cela signifie, par exemple, qu'après avoir @@ -46,7 +46,7 @@ <link linkend="language.expressions">Expressions</link>. </para> <para> - PHP 4.0 permet aussi d'assigner les valeurs aux variables + PHP 4 permet aussi d'assigner les valeurs aux variables <emphasis>par référence</emphasis>. Cela signifie que la nouvelle variable ne fait que référencer (en d'autres terme, "devient un alias de", ou encore "pointe sur") la @@ -412,10 +412,12 @@ alors ces variables seront aussi disponibles comme variable global du script : c'est à dire, indépendamment des tableaux <varname>$HTTP_*_VARS</varname>. Cette fonctionnalité - doit être utilisée avec précautions, et de préférence, désactivée. - Si <varname>$HTTP_*_VARS</varname> est sécurisé, les équivalents - globaux peuvent être écrasé par les données d'entrée de l'utilisateur, - avec des intrusions possibles. Si vous ne pouvez pas desactiver + doit être utilisée avec précautions, et de + préférence, désactivée. + Si <varname>$HTTP_*_VARS</varname> est sécurisé, + les équivalents globaux peuvent être écrasé + par les données d'entrée de l'utilisateur, + avec des intrusions possibles. Si vous ne pouvez pas désactiver <link linkend="ini.register-globals">register_globals</link>, vous devez prendre toutes les dispositions possibles pour vous assurer que les données utilisées sont sûres. @@ -502,8 +504,9 @@ fichiers téléchargés avec la méthode HTTP POST. Reportez vous au chapitre <link linkend="features.file-upload.post-method"> - Téléchargement par méthode POST</link> pour plus de détails - sur le contenu de <varname>$HTTP_POST_FILES</varname>. + Téléchargement par méthode POST</link> + pour plus de détails sur le contenu de + <varname>$HTTP_POST_FILES</varname>. </simpara> <para> <varname>$HTTP_POST_FILES</varname> n'est disponible que dans @@ -563,7 +566,7 @@ <informalexample> <programlisting role="php"> <?php -$a = 1; /* portée global */ +$a = 1; /* portée globale */ function test() { echo $a; /* portée locale */ } @@ -954,8 +957,8 @@ les convertit (généralement) comme il faut, ce n'est pas toujours le type de variable que vous souhaitez. PHP inclus des fonctions permettant de déterminer le - type d'une variable. Les fonctions <function>gettype</function>, - <function>is_long</function>, + type d'une variable. Les fonctions + <function>gettype</function>, <function>is_long</function>, <function>is_double</function>, <function>is_string</function>, <function>is_array</function>, et <function>is_object</function>. </para> Index: phpdoc/fr/language/constants.xml diff -u phpdoc/fr/language/constants.xml:1.9 phpdoc/fr/language/constants.xml:1.10 --- phpdoc/fr/language/constants.xml:1.9 Fri Jan 12 03:48:39 2001 +++ phpdoc/fr/language/constants.xml Tue Feb 27 03:57:41 2001 @@ -56,7 +56,7 @@ <term><literal>TRUE</literal></term> <listitem> <simpara> - La valeur <literal>TRUE</literal>. + La valeur vraie booléenne, <literal>TRUE</literal>. </simpara> </listitem> </varlistentry> @@ -64,7 +64,7 @@ <term><literal>FALSE</literal></term> <listitem> <simpara> - La valeur <literal>FALSE</literal>. + La valeur faux booléenne, <literal>FALSE</literal>. </simpara> </listitem> </varlistentry> @@ -72,7 +72,7 @@ <term>E_ERROR</term> <listitem> <simpara> - Dénote une erreur autre qu'une "parsing error" (erreur d'analyse) + Dénote une erreur autre qu'une erreur d'analyse ("parse error") qu'il n'est pas possible de corriger. </simpara> </listitem> @@ -140,8 +140,9 @@ <title>Définition de constantes </title> <programlisting role="php"> <?php -define("CONSTANT", "Bonjour le monde."); -echo CONSTANT; // affiche "Bonjourle monde." +define("CONSTANTE", "Bonjour le monde."); +echo CONSTANTE; +// affiche "Bonjourle monde." ?> </programlisting> </example> @@ -149,10 +150,10 @@ <title>Utilisation des constantes __FILE__ et __LINE__ </title> <programlisting role="php"> <?php -function report_error($file, $line, $message) { - echo "Une erreur a eu lieu dans le fichier $file à la ligne $line: $message."; +function rapport_erreur($file, $line, $message) { + echo "Une erreur est survenue dans le fichier $file à la ligne $line: +$message."; } -report_error(__FILE__,__LINE__, "Y a un problème!"); +rapport_erreur(__FILE__,__LINE__, "Y a un problème!"); ?> </programlisting> </example>