cvs: phpdoc-fr /language functions.xml operators.xml types.xml variables.xml
| From: | Damien Seguy | Date: | Thu, 06 Feb 2003 03:54:20 +0000 |
| Subject: | cvs: phpdoc-fr /language functions.xml operators.xml types.xml variables.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-212@lists.php.net to get a copy of this message | ||
dams Wed Feb 5 22:54:20 2003 EDT
Modified files:
/phpdoc-fr/language functions.xml operators.xml types.xml
variables.xml
Log:
spring cleaning
Index: phpdoc-fr/language/functions.xml diff -u phpdoc-fr/language/functions.xml:1.13 phpdoc-fr/language/functions.xml:1.14 --- phpdoc-fr/language/functions.xml:1.13 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/functions.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <chapter id="functions"> <title>Les fonctions</title> <sect1 id="functions.user-defined"> @@ -7,7 +7,7 @@ <para> Une fonction peut être définie en utilisant la syntaxe suivante : <example> - <title>Dfinition d'une fonction</title> + <title>Définition d'une fonction</title> <programlisting role="php"> <![CDATA[ <?php @@ -30,8 +30,8 @@ qu'elles ne soient utilisées. Ce n'est plus le cas en PHP 4. </simpara> <para> - Lorsqu'une fonction est dfinie de manire conditionnelle, comme dans - les exemples ci-dessous, leur dfinition doit <emphasis>prcder</emphasis> + Lorsqu'une fonction est définie de manière conditionnelle, comme dans + les exemples ci-dessous, leur définition doit <emphasis>précéder</emphasis> leur utilisation. <example> <title>Fonctions conditionnelles</title> @@ -50,7 +50,7 @@ if ($makefoo) { function foo () { - echo "Je n'existe pas tant que le programme n'est pas pass ici.\n"; + echo "Je n'existe pas tant que le programme n'est pas passé ici.\n"; } } @@ -61,7 +61,7 @@ function bar() { { - echo "J'existe ds de dbut du programme.\n"; + echo "J'existe dès de début du programme.\n"; } ?> @@ -77,7 +77,7 @@ { function bar() { - echo "Je n'existe pas tant que foo() n'est pas appel.\n"; + echo "Je n'existe pas tant que foo() n'est pas appelé.\n"; } } Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.20 phpdoc-fr/language/operators.xml:1.21 --- phpdoc-fr/language/operators.xml:1.20 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/operators.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <chapter id="language.operators"> <title>Les opérateurs</title> <simpara> @@ -259,7 +259,7 @@ // Affiche '5' echo "12" ^ "9"; -// Affiche le caractre d'effacement (ascii 8) +// Affiche le caractère d'effacement (ascii 8) // ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8 echo "hallo" ^ "hello"; Index: phpdoc-fr/language/types.xml diff -u phpdoc-fr/language/types.xml:1.21 phpdoc-fr/language/types.xml:1.22 --- phpdoc-fr/language/types.xml:1.21 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/types.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="language.types"> <title>Les types</title> <sect1 id="language.types.intro"> @@ -80,34 +80,34 @@ </simpara> <note> <simpara> - Si vous voulez vrifier le type et la valeur d'une variable + Si vous voulez vérifier le type et la valeur d'une variable ou d'une <link linkend="language.expressions">expression</link>, utilisez la fonction <function>var_dump</function>. </simpara> <para> - Si vous souhaitez simplement une reprsentation lisible pour du dbogage, - utilisez la fonction <function>gettype</function>. Pour vrifier la prsence + Si vous souhaitez simplement une représentation lisible pour du débogage, + utilisez la fonction <function>gettype</function>. Pour vérifier la présence de certains types, <emphasis>n'utilisez pas</emphasis> <function>gettype</function>, - mais plutt les fonctions <literal>is_<replaceable>type</replaceable></literal>. + mais plutôt les fonctions <literal>is_<replaceable>type</replaceable></literal>. Par exemple : <example> - <title>Exemples de vrification de type de variable</title> + <title>Exemples de vérification de type de variable</title> <programlisting role="php"> <![CDATA[ <?php -$bool = TRUE; // un boolen -$str = "foo"; // une chane de caractres +$bool = TRUE; // un booléen +$str = "foo"; // une chaîne de caractères $int = 12; // un entier echo gettype($bool); // affiche "boolean" echo gettype($str); // affiche "string" -// Ceci est un engier, on l'incrmente de 4 +// Ceci est un engier, on l'incrémente de 4 if (is_int($int)) { $int += 4; } -// Si $bool est une chane, l'afficher +// Si $bool est une chaîne, l'afficher // (Ne pas imprimer n'importe quoi). if (is_string($bool)) { echo "Chaine : $bool"; @@ -150,7 +150,7 @@ <![CDATA[ <?php $foo = True; - // assigne la valeur TRUE la variable $foo + // assigne la valeur TRUE à la variable $foo ?> ]]> </programlisting> @@ -244,7 +244,7 @@ </simpara> </warning> <example> - <title>Conversion en boolen</title> + <title>Conversion en booléen</title> <programlisting role="php"> <![CDATA[ <?php @@ -373,14 +373,14 @@ </simpara> </warning> <para> - Il n'existe pas de division entire en PHP. - <literal>1/2</literal> gnrera le <type>float</type> + Il n'existe pas de division entière en PHP. + <literal>1/2</literal> génèrera le <type>float</type> <literal>0.5</literal>. Vous pouvez forcer la valeur au format entier pour faire l'arrondi, ou bien utiliser les fonctions <function>round</function>, <function>floor</function> ou <function>ceil</function>. <example> - <title>Divisions entires</title> + <title>Divisions entières</title> <programlisting role="php"> <![CDATA[ <?php @@ -869,8 +869,8 @@ <programlisting role="php"> <![CDATA[ <?php -// Ces exemples sont spcifiques l'utilisation de tableaux dans une chane. -// Lorsque vous tes hors d'une chane, utilisez toujours des guillemets +// Ces exemples sont spécifiques à l'utilisation de tableaux dans une chaîne. +// Lorsque vous êtes hors d'une chaîne, utilisez toujours des guillemets // autour des index de tableau, et n'utilisez pas d'{accolades}. // Affichons toutes les erreurs @@ -879,14 +879,14 @@ $fruits = array('fraise' => 'rouge', 'banane' => 'jaune'); // Fonctionne mais notez que cela fonctionne pas comme -// si cela tait hors d'une chane +// si cela était hors d'une chaîne echo "Une banane est $fruits[banane]."; // Fonctionne echo "Une banane est {$fruits['banane']}."; -// Fonctionne mais PHP cherche une constante appele banane -// tel que dcrit ci-dessous +// Fonctionne mais PHP cherche une constante appelée banane +// tel que décrit ci-dessous echo "Une banane est {$fruits[banane]}."; // Ne fonctionne pas, il manque les accolades. Cela donne une erreur d'analyse @@ -896,10 +896,10 @@ echo "Une banane est " . $fruits['banane'] . "."; // Fonctionne -echo "Ce carr a un cot de $square->width mtres de large."; +echo "Ce carré a un coté de $square->width mètres de large."; // Ne fonctionne pas. Pour une solution, voyez la syntaxe complexe. -echo "Ce carr a un cot de $square->width00 centimtres."; +echo "Ce carré a un coté de $square->width00 centimètres."; ?> ]]> </programlisting> @@ -927,7 +927,7 @@ exemples : </simpara> <example> - <title>Syntaxe complexe de chane</title> + <title>Syntaxe complexe de chaîne</title> <programlisting role="php"> <![CDATA[ <?php @@ -944,25 +944,25 @@ echo "This is ${super}"; // Fonctionne -echo "Ce carr a un cot de {$square->width}00 centimtres."; +echo "Ce carré a un coté de {$square->width}00 centimètres."; // Fonctionne echo "Ceci fonctionne : {$arr[4][3]}"; -// Ceci est faut pour la mme raison que $foo[bar] est faux -// hors d'une chane. En d'autres terme, cela va fonctionne -// car PHP recherche d'abord une constante appele foo, mais -// il gnrera une note E_NOTICE (undefined constant). +// Ceci est faut pour la même raison que $foo[bar] est faux +// hors d'une chaîne. En d'autres terme, cela va fonctionne +// car PHP recherche d'abord une constante appelée foo, mais +// il générera une note E_NOTICE (undefined constant). echo "Ceci est faux : {$arr[foo][3]}"; // Fonctionne. Lorsuqe vous utilisez un tableau multidimensionnel dans -// une chane, n'oubliez jamais les accolades. +// une chaîne, n'oubliez jamais les accolades. echo "Ceci fonctionne : {$arr['foo'][3]}"; // Fonctionne echo "Ceci fonctionne : " . $arr['foo'][3]; -echo "Vous pouvez mme crire {$obj->values[3]->name}"; +echo "Vous pouvez même écrire {$obj->values[3]->name}"; echo "Ceci est une valeur de variable variable : {${$name}}"; ?> @@ -991,14 +991,14 @@ <programlisting role="php"> <![CDATA[ <?php -// Lit le premier caractre de la chane +// Lit le premier caractère de la chaîne $str = 'Ceci est un test.'; $first = $str{0}; -// Lit le troisime caractre de la chane +// Lit le troisième caractère de la chaîne $third = $str{2}; -// Lit le dernier caractre de la chane +// Lit le dernier caractère de la chaîne $str = 'Ceci est un test.'; $last = $str{strlen($str)-1}; ?> @@ -1194,7 +1194,7 @@ <replaceable>value</replaceable> , ... ) // <replaceable>key</replaceable> est soit une <type>string</type> soit un <type>integer</type> positif -// <replaceable>value</replaceable> peut tre n'importe quoi +// <replaceable>value</replaceable> peut être n'importe quoi </synopsis> </para> <para> @@ -1247,7 +1247,7 @@ <programlisting role="php"> <![CDATA[ <?php -// Ce tableau est identique +// Ce tableau est identique à array(5 => 43, 32, 56, "b" => 12); // Celui ci @@ -1258,19 +1258,19 @@ </informalexample> </para> <para> - Utiliser &true; comme cl revient utiliser le type + Utiliser &true; comme clé revient à utiliser le type <type>integer</type> de valeur <literal>1</literal>. - Utiliser &false; comme cl revient utiliser le type + Utiliser &false; comme clé revient à utiliser le type <type>integer</type> de valeur <literal>0</literal>. - Utiliser &null; comme cl revient utiliser le type + Utiliser &null; comme clé revient à utiliser le type <type>string</type> de valeur <literal>""</literal>. - Utiliser la chane vide comme index va crer cet index, - et ce n'est pas la mme chose que d'utiliser des + Utiliser la chaîne vide comme index va créer cet index, + et ce n'est pas la même chose que d'utiliser des crochets vides. </para> <para> Il n'est pas possible d'utiliser des tableaux ou des objets comme - cls. Ce faisant, vous gnrerez une alerte : <literal>Illegal offset type</literal>. + clés. Ce faisant, vous générerez une alerte : <literal>Illegal offset type</literal>. </para> </sect3> <sect3 id="language.types.array.syntax.modifying"> @@ -1294,19 +1294,19 @@ valeur, assignez lui une nouvelle valeur. Pour supprimer une valeur, utilisez la fonction <function>unset</function>. <example> - <title>Manipuler des lments de tableau</title> + <title>Manipuler des éléments de tableau</title> <programlisting role="php"> <![CDATA[ <?php $arr = array(5 => 1, 12 => 2); -$arr[] = 56; // Ceci revient $arr[13] = 56; - // ce moment du script +$arr[] = 56; // Ceci revient à $arr[13] = 56; + // à ce moment du script -$arr["x"] = 42; // Ceci ajoute un nouvel lment +$arr["x"] = 42; // Ceci ajoute un nouvel élément // avec l'index "x" -unset($arr[5]); // Ceci efface un lment du tableau +unset($arr[5]); // Ceci efface un élément du tableau unset($arr); // Ceci efface tout le tableau ?> @@ -1326,17 +1326,17 @@ <para> La fonction <function>unset</function> permet d'effacer des index dans un tableau. Sachez bien que le tableau ne sera PAS - rindex. Si vous utilisez uniquement des index numriques - (commenant zro, et incrments de un), vous pouvez effectuer - la rindexation en utilisant <function>array_values</function>. + réindexé. Si vous utilisez uniquement des index numériques + (commençant à zéro, et incrémentés de un), vous pouvez effectuer + la réindexation en utilisant <function>array_values</function>. <example> - <title>Manipuler des lments de tableau</title> + <title>Manipuler des éléments de tableau</title> <programlisting role="php"> <![CDATA[ <?php $a = array(1 => 'un', 2 => 'deux', 3 => 'trois'); unset($a[2]); -/* Cela va produire un tableau qui aurait t +/* Cela va produire un tableau qui aurait été $a = array(1 => 'un', 3 => 'trois'); et non pas $a = array(1 => 'un', 2 =>'trois'); @@ -1373,54 +1373,54 @@ </programlisting> </informalexample> Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison - est que PHP attend une constante entre crochets (bar) plutt qu'une chane - ('bar', notez les guillemets). Or, PHP pourrait dfinir dans le futur des + est que PHP attend une constante entre crochets (bar) plutôt qu'une chaîne + ('bar', notez les guillemets). Or, PHP pourrait définir dans le futur des constantes qui, malheureusement pour votre code, auront ce nom. Actuellement, - cela fonctionne car la constante indfinie est transforme en chane ayant la - mme valeur. + cela fonctionne car la constante indéfinie est transformée en chaîne ayant la + même valeur. </para> <para> D'autres exemples : <example> - <title>Exemples de conflits de constantes indfinies</title> + <title>Exemples de conflits de constantes indéfinies</title> <programlisting role="php"> <![CDATA[ <?php // Affichons toutes les erreurs error_reporting(E_ALL); -$arr = array('fruit' => 'pomme', 'lgume' => 'carotte'); +$arr = array('fruit' => 'pomme', 'légume' => 'carotte'); // Correct print $arr['fruit']; // pomme -print $arr['lgume']; // carotte +print $arr['légume']; // carotte // Incorrect. Cela fonctionne mais PHP affiche une alerte car -// il y a utilisation d'une constante indfinie appele fruit +// il y a utilisation d'une constante indéfinie appelée fruit // // Notice: Use of undefined constant fruit - assumed 'fruit' in... print $arr[fruit]; // pomme -// Dfinissons une constante pour illustrer le problme. -// Nous crons une constante appele fruit, qui vaut 'lgume'. -define('fruit','lgume'); +// Définissons une constante pour illustrer le problème. +// Nous créons une constante appelée fruit, qui vaut 'légume'. +define('fruit','légume'); -// Notez la diffrence +// Notez la différence print $arr['fruit']; // pomme print $arr[fruit]; // carotte -// La suite est correcte si cela se passe dans une chane. -// Les constantes ne sont pas remplaces par leur valeur dans une chane +// La suite est correcte si cela se passe dans une chaîne. +// Les constantes ne sont pas remplacées par leur valeur dans une chaîne print "Bonjour $arr[fruit]"; // Bonjour pomme -// A une exception, les accolades entourant un tableau dans une chane +// A une exception, les accolades entourant un tableau dans une chaîne // permettent d'utiliser les constantes print "Bonjour {$arr[fruit]}"; // Bonjour carotte print "Bonjour {$arr['fruit']}"; // Bonjour pomme // Ceci ne fonctionnera pas, et donnera une erreur d'analyse // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING' -// Cela s'applique aussi aux autoglobales dans les chanes +// Cela s'applique aussi aux autoglobales dans les chaînes print "Bonjour $arr['fruit']"; print "Bonjour $_GET['foo']"; @@ -1435,14 +1435,14 @@ Lorsque vous activez le <function>error_reporting</function> pour afficher les erreurs de niveau <constant>E_NOTICE</constant> (en utilisant le niveau <constant>E_ALL</constant>) alors, vous verrez ces erreurs. - Par dfaut, <link linkend="ini.error-reporting">error_reporting</link> + Par défaut, <link linkend="ini.error-reporting">error_reporting</link> est trop faible pour les afficher. </para> <para> - Comme indiqu dans la section <link linkend="language.types.array.syntax">syntaxe</link>, + Comme indiqué dans la section <link linkend="language.types.array.syntax">syntaxe</link>, il doit y avoir une expression entre les crochets ('<literal>[</literal>' and '<literal>]</literal>'). - Cela signifie que vous pouvez crire ceci : + Cela signifie que vous pouvez écrire ceci : <informalexample> <programlisting role="php"> <![CDATA[ @@ -1460,7 +1460,7 @@ <![CDATA[ <?php $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; -$error_descriptions[E_WARNING] = "PHP met une alerte"; +$error_descriptions[E_WARNING] = "PHP émet une alerte"; $error_descriptions[E_NOTICE] = "Ceci est juste une alerte informationnelle"; ?> ]]> @@ -1468,13 +1468,13 @@ </informalexample> Notez que <literal>E_ERROR</literal> est aussi un identifiant valide, tout comme <literal>bar</literal> dans le premier exemple. Mais le dernier - exemple est identique ceci : + exemple est identique à ceci : <informalexample> <programlisting role="php"> <![CDATA[ <?php $error_descriptions[1] = "Une erreur fatale est survenue"; -$error_descriptions[2] = "PHP met une alerte"; +$error_descriptions[2] = "PHP émet une alerte"; $error_descriptions[8] = "Ceci est juste une alerte informationnelle"; ?> ]]> @@ -1483,31 +1483,31 @@ car <literal>E_ERROR</literal> vaut <literal>1</literal>, etc... </para> <para> - Comme nous l'avons dj expliqu dans les exemple ci-dessus, + Comme nous l'avons déjà expliqué dans les exemple ci-dessus, <literal>$foo[bar]</literal> fonctionne mais est dangereux. - Cela fonctionne car <literal>bar</literal> est identifi comme une + Cela fonctionne car <literal>bar</literal> est identifié comme une constante. Mais, si la constante n'existe pas, &php; suppose que vous souhaitez utiliser <literal>bar</literal> litteralement, - sous la forme <literal>"bar"</literal>, mais que vous avez oubli les + sous la forme <literal>"bar"</literal>, mais que vous avez oublié les guillemets. </para> <sect4> <title>Pourquoi est-ce aussi dangereux?</title> <para> - A l'avenir, la PHP team peut dcider d'ajouter une constante ou - un autre mot cl, ou bien vous souhaiterez aussi ajouter une - constante dans votre application, et vous serez bloqu. Par exemple, + A l'avenir, la PHP team peut décider d'ajouter une constante ou + un autre mot clé, ou bien vous souhaiterez aussi ajouter une + constante dans votre application, et vous serez bloqué. Par exemple, vous ne pouvez pas utiliser mots comme <literal>empty</literal> et - <literal>default</literal> de cette manire, car il sont dj - <link linkend="reserved">rservs</link>. + <literal>default</literal> de cette manière, car il sont déjà + <link linkend="reserved">réservés</link>. </para> <note> <simpara> - Pour insister, l'intrieur d'une <type>string</type> guillemets doubles, + Pour insister, à l'intérieur d'une <type>string</type> à guillemets doubles, il est correct de ne pas utiliser les guillemets simples dans les index, et <literal>"$foo[bar]"</literal> est valide. Voyez les exemples - ci-dessus pour plus de dtails sur la syntaxe des - <link linkend="language.types.string.parsing">variable dans les chanes</link>. + ci-dessus pour plus de détails sur la syntaxe des + <link linkend="language.types.string.parsing">variable dans les chaînes</link>. </simpara> </note> </sect4> @@ -1729,7 +1729,7 @@ ), "trou" => array ( "premier", 5 => "second", - "troisime" + "troisième" ) ); @@ -1738,7 +1738,7 @@ echo $fruits["fruits"]["a"]; // affiche "orange" unset($fruits["trou"][0]); // supprime "premier" -// Crer un tableau multidimensionnel +// Créer un tableau multidimensionnel $juices["pomme"]["vert"] = "bon"; ?> ]]> @@ -2050,8 +2050,8 @@ <programlisting role="php"> <![CDATA[ <?php -$a = "1"; // $a est une chane -$a[0] = "f"; // Mais que sont les index de chane? +$a = "1"; // $a est une chaîne +$a[0] = "f"; // Mais que sont les index de chaîne? ?> ]]> </programlisting> @@ -2066,24 +2066,24 @@ caractères $a? </para> <para> - Les versions courantes de &php; interprte le second assignement - comme un index de chane, et donc $a devient "f", et le - rsultat de cette conversion automatique doit tre considr comme - indfini. &php; 4 a introduit la syntaxe avec les accolabes pour - accder aux caractres d'une chane. Utilisez plutt le code + Les versions courantes de &php; interprête le second assignement + comme un index de chaîne, et donc $a devient "f", et le + résultat de cette conversion automatique doit être considéré comme + indéfini. &php; 4 a introduit la syntaxe avec les accolabes pour + accéder aux caractères d'une chaîne. Utilisez plutôt le code ci-dessous : <informalexample> <programlisting role="php"> <![CDATA[ <?php -$a = "abc"; // $a est une chane +$a = "abc"; // $a est une chaîne $a{1} = "f"; // $a vaut maintenant "afc" ?> ]]> </programlisting> </informalexample> - Voyez la section <link linkend="language.types.string.substr">Accs aux caractres d'une chane</link> - pour plus de dtails. + Voyez la section <link linkend="language.types.string.substr">Accès aux caractères d'une chaîne</link> + pour plus de détails. </para> </note> <sect2 id="language.types.typecasting"> @@ -2144,15 +2144,15 @@ </para> <note> <para> - Au lieu de transtyper une variable en chane, vous pouvez aussi - l'insrer entre deux guillemets doubles : + Au lieu de transtyper une variable en chaîne, vous pouvez aussi + l'insérer entre deux guillemets doubles : <informalexample> <programlisting role="php"> <![CDATA[ <?php $foo = 10; // $foo est un entier -$str = "$foo"; // $str est une chane -$fst = (string) $foo; // $fst est aussi une chane +$str = "$foo"; // $str est une chaîne +$fst = (string) $foo; // $fst est aussi une chaîne // Ceci affiche : "Identique" if ($fst === $str) { @@ -2170,7 +2170,7 @@ <itemizedlist> <listitem> <simpara><link linkend="language.types.boolean.casting">Conversion en - boolen</link></simpara> + booléen</link></simpara> </listitem> <listitem> <simpara><link linkend="language.types.integer.casting">Conversion en @@ -2178,11 +2178,11 @@ </listitem> <listitem> <simpara><link linkend="language.types.float.casting">Conversion en - nombre virgule flottante</link></simpara> + nombre à virgule flottante</link></simpara> </listitem> <listitem> <simpara><link linkend="language.types.string.casting">Conversion en - chane de caractres</link></simpara> + chaîne de caractères</link></simpara> </listitem> <listitem> <simpara><link linkend="language.types.array.casting">Conversion en Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.36 phpdoc-fr/language/variables.xml:1.37 --- phpdoc-fr/language/variables.xml:1.36 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/variables.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.36 $ --> +<!-- $Revision: 1.37 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -104,13 +104,13 @@ </informalexample> </para> <para> - &php; suit les conventions de Perl pour la gestion des oprateurs - arithmiques, et non pas celles du lanage C. Par exemple, en Perl + &php; suit les conventions de Perl pour la gestion des opérateurs + arithméiques, et non pas celles du lanage C. Par exemple, en Perl <literal>'Z'+1</literal> devient <literal>'AA'</literal>, tandis que en langage C <literal>'Z'+1</literal> devient <literal>'['</literal> ({ ord('Z') == 90, ord('[') == 91 ). <example> - <title>Oprations arithmtiques et caractres</title> + <title>Opérations arithmétiques et caractères</title> <programlisting role="php"> <![CDATA[ <?php @@ -148,11 +148,11 @@ </simpara> <warning> <simpara> - Depuis la version &php; 4.2.0, la valeur par dfaut de la directive &php; + Depuis la version &php; 4.2.0, la valeur par défaut de la directive &php; <link linkend="ini.register-globals">register_globals</link> est - <emphasis>off</emphasis>. Ceci est une volution majeure de &php;. - Avoir la directive register_globals <emphasis>off</emphasis> affecte les - variables prdfinies du contexte globale. Par exemple, pour lire + <emphasis>off</emphasis>. Ceci est une évolution majeure de &php;. + Avoir la directive register_globals à <emphasis>off</emphasis> affecte les + variables prédéfinies du contexte globale. Par exemple, pour lire <varname>DOCUMENT_ROOT</varname> vous devez utiliser <varname>$_SERVER['DOCUMENT_ROOT']</varname> au lieu de <varname>$DOCUMENT_ROOT</varname>, ou bien il faut lire <varname>$_GET['id']</varname> @@ -161,16 +161,16 @@ <varname>$HOME</varname>. </simpara> <simpara> - Pour des informations lies cette volution, lisez la documentation de la + Pour des informations liées à cette évolution, lisez la documentation de la directive <link linkend="ini.register-globals">register_globals</link>, le chapitre - sur la scrit, propos de l'<link linkend="security.registerglobals">Utilisation des variables super-globales</link>, + sur la sécrité, à propos de l'<link linkend="security.registerglobals">Utilisation des variables super-globales</link>, ainsi que les annonces de &php; <ulink url="&url.php.release4.1.0;">4.1.0</ulink> et <ulink url="&url.php.release4.2.0;">4.2.0</ulink>. </simpara> <simpara> - L'utilisation des variables prdfinies de &php;, comme les + L'utilisation des variables prédéfinies de &php;, comme les <link linkend="language.variables.superglobals">tableaux superglobaux</link>, - est recommand. + est recommandé. </simpara> </warning> <simpara> @@ -186,21 +186,21 @@ connaître le détails de leur contenu, et une présentation approfondie sur les variables prédéfinies &php;, et leur nature, reportez vous à la section <link linkend="reserved.variables">variables prédefinies</link>. - De plus, vous noterez que les anciennes variables prdfinies + De plus, vous noterez que les anciennes variables prédéfinies (<varname>$HTTP_*_VARS</varname>) existent toujours. </simpara> <note> <title>Variables variables</title> <para> - Les superglobales ne peuvent pas tre utilises comme + Les superglobales ne peuvent pas être utilisées comme <link linkend="language.variables.variable">variable variables</link>. </para> </note> <para> Si certaines variables de <link linkend="ini.variables-order">variables_order</link> - ne sont pas dfinies, leur tableau prdfini &php; correspondant est laiss vide. + ne sont pas définies, leur tableau prédéfini &php; correspondant est laissé vide. </para> <variablelist id="language.variables.superglobals"> @@ -428,14 +428,14 @@ <?php function test_global() { - // La plupart des variables prdfinies ne sont pas des "superglobales" et - // requiert le mot cl 'global' pour tre disponible dans une fonction. + // La plupart des variables prédéfinies ne sont pas des "superglobales" et + // requiert le mot clé 'global' pour être disponible dans une fonction. global $HTTP_POST_VARS; print $HTTP_POST_VARS['name']; // Les superglobales sont accessibles dans tous les contextes - // et ne requirent pas 'global'. Les superglobales sont disponibles + // et ne requièrent pas 'global'. Les superglobales sont disponibles // depuis PHP 4.1.0 print $_POST['name']; } @@ -522,12 +522,12 @@ </programlisting> </informalexample> <simpara> - Le Zend Engine 1, sur qui repose <literal>PHP4</literal>, implmente les + Le Zend Engine 1, sur qui repose <literal>PHP4</literal>, implémente les options <literal>static</literal> et <literal>global</literal> pour les variables, - en terme de rfrences. Par exemple, une vrai variable globale - est importe dans un contexte de fonction avec <literal>global</literal>. - Cette commande cre en fait une rfrence sur la variable globale. Ce - peut vous mener des comportement inattendus, comme par exemple : + en terme de références. Par exemple, une vrai variable globale + est importée dans un contexte de fonction avec <literal>global</literal>. + Cette commande crée en fait une référence sur la variable globale. Ce + peut vous mener à des comportement inattendus, comme par exemple : </simpara> <informalexample> <programlisting role="php"> @@ -553,7 +553,7 @@ </informalexample> <simpara> - Excuter cet exemple vous donnera : + Exécuter cet exemple vous donnera : </simpara> <screen> @@ -563,8 +563,8 @@ </screen> <simpara> - Un comportement similaire s'applique la commande <literal>static</literal>. - Les rfrences ne sont pas stockes dynamiquement : + Un comportement similaire s'applique à la commande <literal>static</literal>. + Les références ne sont pas stockées dynamiquement : </simpara> <informalexample> @@ -577,7 +577,7 @@ echo "Objet statique : "; var_dump($obj); if (!isset($obj)) { - // Assigne une rfrence une variable statique + // Assigne une référence à une variable statique $obj = &new stdclass; } $obj->property++; @@ -590,7 +590,7 @@ echo "Objet statique : "; var_dump($obj); if (!isset($obj)) { - // Assigne une objet une variable statique + // Assigne une objet à une variable statique $obj = new stdclass; } $obj->property++; @@ -608,7 +608,7 @@ </informalexample> <simpara> - Excuter cet exemple vous donnera : + Exécuter cet exemple vous donnera : </simpara> <screen> @@ -623,9 +623,9 @@ </screen> <simpara> - Ces exemples illustrent les problmes rencontrs lors de l'assignation - de rfrence des variables statiuqes, qui sont - <emphasis>oublies</emphasis> lorsque vous appelez + Ces exemples illustrent les problèmes rencontrés lors de l'assignation + de référence à des variables statiuqes, qui sont + <emphasis>oubliées</emphasis> lorsque vous appelez <literal>&get_instance_ref()</literal> une seconde fois. </simpara> </sect1> @@ -730,14 +730,14 @@ </para> <para> - Suivant votre configuration particulier et vos prfrences, - vous avez plusieurs mthodes pour accder aux variables du formulaires. + Suivant votre configuration particulièer et vos préférences, + vous avez plusieurs méthodes pour accéder aux variables du formulaires. Voici quelques exemples : </para> <para> <example> - <title>Accder simplement des variables de formulaires POST</title> + <title>Accéder simplement à des variables de formulaires POST</title> <programlisting role="html"> <![CDATA[ <?php @@ -754,8 +754,8 @@ print $HTTP_POST_VARS['username']; // Disponibles si la directive register_globals = on. Depuis -// PHP 4.2.0 la valeur par dfaut de cette directive est register_globals = off. -// Utiliser ou prsumer cette mthode est dcourag. +// PHP 4.2.0 la valeur par défaut de cette directive est register_globals = off. +// Utiliser ou présumer cette méthode est découragé. print $username; ?> @@ -765,11 +765,11 @@ </para> <para> Utiliser un formulaire de type GET est similaire, hormis le fait que - vpis devez utiliser les variables prdfinies du GET la place. - GET s'applique aussi la QUERY_STRING (les informations disponibles aprs + vpis devez utiliser les variables prédéfinies du GET à la place. + GET s'applique aussi à la QUERY_STRING (les informations disponibles après le '?' dans une URL). De ce fait, par exemple, <literal>http://www.exemple.com/test.php?id=3</literal> - contient les donnes de GET, qui sont accessibles via <varname>$_GET['id']</varname>. + contient les données de GET, qui sont accessibles via <varname>$_GET['id']</varname>. Voyez aussi <link linkend="reserved.variables.request">$_REQUEST</link> et <function>import_request_variables</function>. </para> @@ -794,9 +794,9 @@ <note> <para> La directive de configuraion <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - affecte les valeurs de GET, POST et cookies. Si elle est active, - une valeur comme celle de (C'est "PHP!") sera magiquement transforme en (C\'est \"PHP!\"). - La protection des caractres est ncessaire pour l'insertion dans les bases de donnes. + affecte les valeurs de GET, POST et cookies. Si elle est activée, + une valeur comme celle de (C'est "PHP!") sera magiquement transformée en (C\'est \"PHP!\"). + La protection des caractères est nécessaire pour l'insertion dans les bases de données. Voyez aussi les fonctions <function>addslashes</function>, <function>stripslashes</function> et <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>. @@ -807,8 +807,8 @@ &php; comprend aussi les tableaux dans le contexte des formulaires. (voir aussi <link linkend="faq.html">related faq</link>). Vous pouvez, par exemple, grouper des variables ensembles, ou bien utiliser cette - fonctionnalit pour lire des valeurs multiples d'un menu droulant. - Par exemple, voici un formulaire qui se poste lui mme des donnes, + fonctionnalité pour lire des valeurs multiples d'un menu déroulant. + Par exemple, voici un formulaire qui se poste lui même des données, et les affiche : </simpara> @@ -822,7 +822,7 @@ print '<pre>'; print_r($HTTP_POST_VARS); - print '<a href="'. $HTTP_SERVER_VARS['PHP_SELF'] .'">Essayez nouveau</a>'; + print '<a href="'. $HTTP_SERVER_VARS['PHP_SELF'] .'">Essayez à nouveau</a>'; print '</pre>'; } else { @@ -848,8 +848,8 @@ </para> <para> - En PHP 3, la syntaxe de tableau HTML est limite aux tableaux - uni-dimensionnels. En PHP 4, ces limitations ont t leves. + En PHP 3, la syntaxe de tableau HTML est limitée aux tableaux + uni-dimensionnels. En PHP 4, ces limitations ont été levées. </para> <sect3 id="language.variables.external.form.submit"> @@ -870,11 +870,11 @@ <simpara> Lorque l'utilisateur clique sur cette image, le formulaire - associ est envoy au serveur, avec deux donnes supplmentaires, + associé est envoyé au serveur, avec deux données supplémentaires, <varname>sub_x</varname> et <varname>sub_y</varname>. Elles contiennent - les coordonnes du clic de l'utilisateur dans l'image. Vous noterez - que ces variables sont envoyes par le navigateur avec un point dans leur - nom, mais &php; convertit ces points en souligns. + les coordonnées du clic de l'utilisateur dans l'image. Vous noterez + que ces variables sont envoyées par le navigateur avec un point dans leur + nom, mais &php; convertit ces points en soulignés. </simpara> </sect3> </sect2>
Index: phpdoc-fr/language/functions.xml diff -u phpdoc-fr/language/functions.xml:1.13 phpdoc-fr/language/functions.xml:1.14 --- phpdoc-fr/language/functions.xml:1.13 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/functions.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <chapter id="functions"> <title>Les fonctions</title> <sect1 id="functions.user-defined"> @@ -7,7 +7,7 @@ <para> Une fonction peut être définie en utilisant la syntaxe suivante : <example> - <title>Dfinition d'une fonction</title> + <title>Définition d'une fonction</title> <programlisting role="php"> <![CDATA[ <?php @@ -30,8 +30,8 @@ qu'elles ne soient utilisées. Ce n'est plus le cas en PHP 4. </simpara> <para> - Lorsqu'une fonction est dfinie de manire conditionnelle, comme dans - les exemples ci-dessous, leur dfinition doit <emphasis>prcder</emphasis> + Lorsqu'une fonction est définie de manière conditionnelle, comme dans + les exemples ci-dessous, leur définition doit <emphasis>précéder</emphasis> leur utilisation. <example> <title>Fonctions conditionnelles</title> @@ -50,7 +50,7 @@ if ($makefoo) { function foo () { - echo "Je n'existe pas tant que le programme n'est pas pass ici.\n"; + echo "Je n'existe pas tant que le programme n'est pas passé ici.\n"; } } @@ -61,7 +61,7 @@ function bar() { { - echo "J'existe ds de dbut du programme.\n"; + echo "J'existe dès de début du programme.\n"; } ?> @@ -77,7 +77,7 @@ { function bar() { - echo "Je n'existe pas tant que foo() n'est pas appel.\n"; + echo "Je n'existe pas tant que foo() n'est pas appelé.\n"; } } Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.20 phpdoc-fr/language/operators.xml:1.21 --- phpdoc-fr/language/operators.xml:1.20 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/operators.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <chapter id="language.operators"> <title>Les opérateurs</title> <simpara> @@ -259,7 +259,7 @@ // Affiche '5' echo "12" ^ "9"; -// Affiche le caractre d'effacement (ascii 8) +// Affiche le caractère d'effacement (ascii 8) // ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8 echo "hallo" ^ "hello"; Index: phpdoc-fr/language/types.xml diff -u phpdoc-fr/language/types.xml:1.21 phpdoc-fr/language/types.xml:1.22 --- phpdoc-fr/language/types.xml:1.21 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/types.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> +<!-- $Revision: 1.22 $ --> <chapter id="language.types"> <title>Les types</title> <sect1 id="language.types.intro"> @@ -80,34 +80,34 @@ </simpara> <note> <simpara> - Si vous voulez vrifier le type et la valeur d'une variable + Si vous voulez vérifier le type et la valeur d'une variable ou d'une <link linkend="language.expressions">expression</link>, utilisez la fonction <function>var_dump</function>. </simpara> <para> - Si vous souhaitez simplement une reprsentation lisible pour du dbogage, - utilisez la fonction <function>gettype</function>. Pour vrifier la prsence + Si vous souhaitez simplement une représentation lisible pour du débogage, + utilisez la fonction <function>gettype</function>. Pour vérifier la présence de certains types, <emphasis>n'utilisez pas</emphasis> <function>gettype</function>, - mais plutt les fonctions <literal>is_<replaceable>type</replaceable></literal>. + mais plutôt les fonctions <literal>is_<replaceable>type</replaceable></literal>. Par exemple : <example> - <title>Exemples de vrification de type de variable</title> + <title>Exemples de vérification de type de variable</title> <programlisting role="php"> <![CDATA[ <?php -$bool = TRUE; // un boolen -$str = "foo"; // une chane de caractres +$bool = TRUE; // un booléen +$str = "foo"; // une chaîne de caractères $int = 12; // un entier echo gettype($bool); // affiche "boolean" echo gettype($str); // affiche "string" -// Ceci est un engier, on l'incrmente de 4 +// Ceci est un engier, on l'incrémente de 4 if (is_int($int)) { $int += 4; } -// Si $bool est une chane, l'afficher +// Si $bool est une chaîne, l'afficher // (Ne pas imprimer n'importe quoi). if (is_string($bool)) { echo "Chaine : $bool"; @@ -150,7 +150,7 @@ <![CDATA[ <?php $foo = True; - // assigne la valeur TRUE la variable $foo + // assigne la valeur TRUE à la variable $foo ?> ]]> </programlisting> @@ -244,7 +244,7 @@ </simpara> </warning> <example> - <title>Conversion en boolen</title> + <title>Conversion en booléen</title> <programlisting role="php"> <![CDATA[ <?php @@ -373,14 +373,14 @@ </simpara> </warning> <para> - Il n'existe pas de division entire en PHP. - <literal>1/2</literal> gnrera le <type>float</type> + Il n'existe pas de division entière en PHP. + <literal>1/2</literal> génèrera le <type>float</type> <literal>0.5</literal>. Vous pouvez forcer la valeur au format entier pour faire l'arrondi, ou bien utiliser les fonctions <function>round</function>, <function>floor</function> ou <function>ceil</function>. <example> - <title>Divisions entires</title> + <title>Divisions entières</title> <programlisting role="php"> <![CDATA[ <?php @@ -869,8 +869,8 @@ <programlisting role="php"> <![CDATA[ <?php -// Ces exemples sont spcifiques l'utilisation de tableaux dans une chane. -// Lorsque vous tes hors d'une chane, utilisez toujours des guillemets +// Ces exemples sont spécifiques à l'utilisation de tableaux dans une chaîne. +// Lorsque vous êtes hors d'une chaîne, utilisez toujours des guillemets // autour des index de tableau, et n'utilisez pas d'{accolades}. // Affichons toutes les erreurs @@ -879,14 +879,14 @@ $fruits = array('fraise' => 'rouge', 'banane' => 'jaune'); // Fonctionne mais notez que cela fonctionne pas comme -// si cela tait hors d'une chane +// si cela était hors d'une chaîne echo "Une banane est $fruits[banane]."; // Fonctionne echo "Une banane est {$fruits['banane']}."; -// Fonctionne mais PHP cherche une constante appele banane -// tel que dcrit ci-dessous +// Fonctionne mais PHP cherche une constante appelée banane +// tel que décrit ci-dessous echo "Une banane est {$fruits[banane]}."; // Ne fonctionne pas, il manque les accolades. Cela donne une erreur d'analyse @@ -896,10 +896,10 @@ echo "Une banane est " . $fruits['banane'] . "."; // Fonctionne -echo "Ce carr a un cot de $square->width mtres de large."; +echo "Ce carré a un coté de $square->width mètres de large."; // Ne fonctionne pas. Pour une solution, voyez la syntaxe complexe. -echo "Ce carr a un cot de $square->width00 centimtres."; +echo "Ce carré a un coté de $square->width00 centimètres."; ?> ]]> </programlisting> @@ -927,7 +927,7 @@ exemples : </simpara> <example> - <title>Syntaxe complexe de chane</title> + <title>Syntaxe complexe de chaîne</title> <programlisting role="php"> <![CDATA[ <?php @@ -944,25 +944,25 @@ echo "This is ${super}"; // Fonctionne -echo "Ce carr a un cot de {$square->width}00 centimtres."; +echo "Ce carré a un coté de {$square->width}00 centimètres."; // Fonctionne echo "Ceci fonctionne : {$arr[4][3]}"; -// Ceci est faut pour la mme raison que $foo[bar] est faux -// hors d'une chane. En d'autres terme, cela va fonctionne -// car PHP recherche d'abord une constante appele foo, mais -// il gnrera une note E_NOTICE (undefined constant). +// Ceci est faut pour la même raison que $foo[bar] est faux +// hors d'une chaîne. En d'autres terme, cela va fonctionne +// car PHP recherche d'abord une constante appelée foo, mais +// il générera une note E_NOTICE (undefined constant). echo "Ceci est faux : {$arr[foo][3]}"; // Fonctionne. Lorsuqe vous utilisez un tableau multidimensionnel dans -// une chane, n'oubliez jamais les accolades. +// une chaîne, n'oubliez jamais les accolades. echo "Ceci fonctionne : {$arr['foo'][3]}"; // Fonctionne echo "Ceci fonctionne : " . $arr['foo'][3]; -echo "Vous pouvez mme crire {$obj->values[3]->name}"; +echo "Vous pouvez même écrire {$obj->values[3]->name}"; echo "Ceci est une valeur de variable variable : {${$name}}"; ?> @@ -991,14 +991,14 @@ <programlisting role="php"> <![CDATA[ <?php -// Lit le premier caractre de la chane +// Lit le premier caractère de la chaîne $str = 'Ceci est un test.'; $first = $str{0}; -// Lit le troisime caractre de la chane +// Lit le troisième caractère de la chaîne $third = $str{2}; -// Lit le dernier caractre de la chane +// Lit le dernier caractère de la chaîne $str = 'Ceci est un test.'; $last = $str{strlen($str)-1}; ?> @@ -1194,7 +1194,7 @@ <replaceable>value</replaceable> , ... ) // <replaceable>key</replaceable> est soit une <type>string</type> soit un <type>integer</type> positif -// <replaceable>value</replaceable> peut tre n'importe quoi +// <replaceable>value</replaceable> peut être n'importe quoi </synopsis> </para> <para> @@ -1247,7 +1247,7 @@ <programlisting role="php"> <![CDATA[ <?php -// Ce tableau est identique +// Ce tableau est identique à array(5 => 43, 32, 56, "b" => 12); // Celui ci @@ -1258,19 +1258,19 @@ </informalexample> </para> <para> - Utiliser &true; comme cl revient utiliser le type + Utiliser &true; comme clé revient à utiliser le type <type>integer</type> de valeur <literal>1</literal>. - Utiliser &false; comme cl revient utiliser le type + Utiliser &false; comme clé revient à utiliser le type <type>integer</type> de valeur <literal>0</literal>. - Utiliser &null; comme cl revient utiliser le type + Utiliser &null; comme clé revient à utiliser le type <type>string</type> de valeur <literal>""</literal>. - Utiliser la chane vide comme index va crer cet index, - et ce n'est pas la mme chose que d'utiliser des + Utiliser la chaîne vide comme index va créer cet index, + et ce n'est pas la même chose que d'utiliser des crochets vides. </para> <para> Il n'est pas possible d'utiliser des tableaux ou des objets comme - cls. Ce faisant, vous gnrerez une alerte : <literal>Illegal offset type</literal>. + clés. Ce faisant, vous générerez une alerte : <literal>Illegal offset type</literal>. </para> </sect3> <sect3 id="language.types.array.syntax.modifying"> @@ -1294,19 +1294,19 @@ valeur, assignez lui une nouvelle valeur. Pour supprimer une valeur, utilisez la fonction <function>unset</function>. <example> - <title>Manipuler des lments de tableau</title> + <title>Manipuler des éléments de tableau</title> <programlisting role="php"> <![CDATA[ <?php $arr = array(5 => 1, 12 => 2); -$arr[] = 56; // Ceci revient $arr[13] = 56; - // ce moment du script +$arr[] = 56; // Ceci revient à $arr[13] = 56; + // à ce moment du script -$arr["x"] = 42; // Ceci ajoute un nouvel lment +$arr["x"] = 42; // Ceci ajoute un nouvel élément // avec l'index "x" -unset($arr[5]); // Ceci efface un lment du tableau +unset($arr[5]); // Ceci efface un élément du tableau unset($arr); // Ceci efface tout le tableau ?> @@ -1326,17 +1326,17 @@ <para> La fonction <function>unset</function> permet d'effacer des index dans un tableau. Sachez bien que le tableau ne sera PAS - rindex. Si vous utilisez uniquement des index numriques - (commenant zro, et incrments de un), vous pouvez effectuer - la rindexation en utilisant <function>array_values</function>. + réindexé. Si vous utilisez uniquement des index numériques + (commençant à zéro, et incrémentés de un), vous pouvez effectuer + la réindexation en utilisant <function>array_values</function>. <example> - <title>Manipuler des lments de tableau</title> + <title>Manipuler des éléments de tableau</title> <programlisting role="php"> <![CDATA[ <?php $a = array(1 => 'un', 2 => 'deux', 3 => 'trois'); unset($a[2]); -/* Cela va produire un tableau qui aurait t +/* Cela va produire un tableau qui aurait été $a = array(1 => 'un', 3 => 'trois'); et non pas $a = array(1 => 'un', 2 =>'trois'); @@ -1373,54 +1373,54 @@ </programlisting> </informalexample> Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison - est que PHP attend une constante entre crochets (bar) plutt qu'une chane - ('bar', notez les guillemets). Or, PHP pourrait dfinir dans le futur des + est que PHP attend une constante entre crochets (bar) plutôt qu'une chaîne + ('bar', notez les guillemets). Or, PHP pourrait définir dans le futur des constantes qui, malheureusement pour votre code, auront ce nom. Actuellement, - cela fonctionne car la constante indfinie est transforme en chane ayant la - mme valeur. + cela fonctionne car la constante indéfinie est transformée en chaîne ayant la + même valeur. </para> <para> D'autres exemples : <example> - <title>Exemples de conflits de constantes indfinies</title> + <title>Exemples de conflits de constantes indéfinies</title> <programlisting role="php"> <![CDATA[ <?php // Affichons toutes les erreurs error_reporting(E_ALL); -$arr = array('fruit' => 'pomme', 'lgume' => 'carotte'); +$arr = array('fruit' => 'pomme', 'légume' => 'carotte'); // Correct print $arr['fruit']; // pomme -print $arr['lgume']; // carotte +print $arr['légume']; // carotte // Incorrect. Cela fonctionne mais PHP affiche une alerte car -// il y a utilisation d'une constante indfinie appele fruit +// il y a utilisation d'une constante indéfinie appelée fruit // // Notice: Use of undefined constant fruit - assumed 'fruit' in... print $arr[fruit]; // pomme -// Dfinissons une constante pour illustrer le problme. -// Nous crons une constante appele fruit, qui vaut 'lgume'. -define('fruit','lgume'); +// Définissons une constante pour illustrer le problème. +// Nous créons une constante appelée fruit, qui vaut 'légume'. +define('fruit','légume'); -// Notez la diffrence +// Notez la différence print $arr['fruit']; // pomme print $arr[fruit]; // carotte -// La suite est correcte si cela se passe dans une chane. -// Les constantes ne sont pas remplaces par leur valeur dans une chane +// La suite est correcte si cela se passe dans une chaîne. +// Les constantes ne sont pas remplacées par leur valeur dans une chaîne print "Bonjour $arr[fruit]"; // Bonjour pomme -// A une exception, les accolades entourant un tableau dans une chane +// A une exception, les accolades entourant un tableau dans une chaîne // permettent d'utiliser les constantes print "Bonjour {$arr[fruit]}"; // Bonjour carotte print "Bonjour {$arr['fruit']}"; // Bonjour pomme // Ceci ne fonctionnera pas, et donnera une erreur d'analyse // Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING' -// Cela s'applique aussi aux autoglobales dans les chanes +// Cela s'applique aussi aux autoglobales dans les chaînes print "Bonjour $arr['fruit']"; print "Bonjour $_GET['foo']"; @@ -1435,14 +1435,14 @@ Lorsque vous activez le <function>error_reporting</function> pour afficher les erreurs de niveau <constant>E_NOTICE</constant> (en utilisant le niveau <constant>E_ALL</constant>) alors, vous verrez ces erreurs. - Par dfaut, <link linkend="ini.error-reporting">error_reporting</link> + Par défaut, <link linkend="ini.error-reporting">error_reporting</link> est trop faible pour les afficher. </para> <para> - Comme indiqu dans la section <link linkend="language.types.array.syntax">syntaxe</link>, + Comme indiqué dans la section <link linkend="language.types.array.syntax">syntaxe</link>, il doit y avoir une expression entre les crochets ('<literal>[</literal>' and '<literal>]</literal>'). - Cela signifie que vous pouvez crire ceci : + Cela signifie que vous pouvez écrire ceci : <informalexample> <programlisting role="php"> <![CDATA[ @@ -1460,7 +1460,7 @@ <![CDATA[ <?php $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; -$error_descriptions[E_WARNING] = "PHP met une alerte"; +$error_descriptions[E_WARNING] = "PHP émet une alerte"; $error_descriptions[E_NOTICE] = "Ceci est juste une alerte informationnelle"; ?> ]]> @@ -1468,13 +1468,13 @@ </informalexample> Notez que <literal>E_ERROR</literal> est aussi un identifiant valide, tout comme <literal>bar</literal> dans le premier exemple. Mais le dernier - exemple est identique ceci : + exemple est identique à ceci : <informalexample> <programlisting role="php"> <![CDATA[ <?php $error_descriptions[1] = "Une erreur fatale est survenue"; -$error_descriptions[2] = "PHP met une alerte"; +$error_descriptions[2] = "PHP émet une alerte"; $error_descriptions[8] = "Ceci est juste une alerte informationnelle"; ?> ]]> @@ -1483,31 +1483,31 @@ car <literal>E_ERROR</literal> vaut <literal>1</literal>, etc... </para> <para> - Comme nous l'avons dj expliqu dans les exemple ci-dessus, + Comme nous l'avons déjà expliqué dans les exemple ci-dessus, <literal>$foo[bar]</literal> fonctionne mais est dangereux. - Cela fonctionne car <literal>bar</literal> est identifi comme une + Cela fonctionne car <literal>bar</literal> est identifié comme une constante. Mais, si la constante n'existe pas, &php; suppose que vous souhaitez utiliser <literal>bar</literal> litteralement, - sous la forme <literal>"bar"</literal>, mais que vous avez oubli les + sous la forme <literal>"bar"</literal>, mais que vous avez oublié les guillemets. </para> <sect4> <title>Pourquoi est-ce aussi dangereux?</title> <para> - A l'avenir, la PHP team peut dcider d'ajouter une constante ou - un autre mot cl, ou bien vous souhaiterez aussi ajouter une - constante dans votre application, et vous serez bloqu. Par exemple, + A l'avenir, la PHP team peut décider d'ajouter une constante ou + un autre mot clé, ou bien vous souhaiterez aussi ajouter une + constante dans votre application, et vous serez bloqué. Par exemple, vous ne pouvez pas utiliser mots comme <literal>empty</literal> et - <literal>default</literal> de cette manire, car il sont dj - <link linkend="reserved">rservs</link>. + <literal>default</literal> de cette manière, car il sont déjà + <link linkend="reserved">réservés</link>. </para> <note> <simpara> - Pour insister, l'intrieur d'une <type>string</type> guillemets doubles, + Pour insister, à l'intérieur d'une <type>string</type> à guillemets doubles, il est correct de ne pas utiliser les guillemets simples dans les index, et <literal>"$foo[bar]"</literal> est valide. Voyez les exemples - ci-dessus pour plus de dtails sur la syntaxe des - <link linkend="language.types.string.parsing">variable dans les chanes</link>. + ci-dessus pour plus de détails sur la syntaxe des + <link linkend="language.types.string.parsing">variable dans les chaînes</link>. </simpara> </note> </sect4> @@ -1729,7 +1729,7 @@ ), "trou" => array ( "premier", 5 => "second", - "troisime" + "troisième" ) ); @@ -1738,7 +1738,7 @@ echo $fruits["fruits"]["a"]; // affiche "orange" unset($fruits["trou"][0]); // supprime "premier" -// Crer un tableau multidimensionnel +// Créer un tableau multidimensionnel $juices["pomme"]["vert"] = "bon"; ?> ]]> @@ -2050,8 +2050,8 @@ <programlisting role="php"> <![CDATA[ <?php -$a = "1"; // $a est une chane -$a[0] = "f"; // Mais que sont les index de chane? +$a = "1"; // $a est une chaîne +$a[0] = "f"; // Mais que sont les index de chaîne? ?> ]]> </programlisting> @@ -2066,24 +2066,24 @@ caractères $a? </para> <para> - Les versions courantes de &php; interprte le second assignement - comme un index de chane, et donc $a devient "f", et le - rsultat de cette conversion automatique doit tre considr comme - indfini. &php; 4 a introduit la syntaxe avec les accolabes pour - accder aux caractres d'une chane. Utilisez plutt le code + Les versions courantes de &php; interprête le second assignement + comme un index de chaîne, et donc $a devient "f", et le + résultat de cette conversion automatique doit être considéré comme + indéfini. &php; 4 a introduit la syntaxe avec les accolabes pour + accéder aux caractères d'une chaîne. Utilisez plutôt le code ci-dessous : <informalexample> <programlisting role="php"> <![CDATA[ <?php -$a = "abc"; // $a est une chane +$a = "abc"; // $a est une chaîne $a{1} = "f"; // $a vaut maintenant "afc" ?> ]]> </programlisting> </informalexample> - Voyez la section <link linkend="language.types.string.substr">Accs aux caractres d'une chane</link> - pour plus de dtails. + Voyez la section <link linkend="language.types.string.substr">Accès aux caractères d'une chaîne</link> + pour plus de détails. </para> </note> <sect2 id="language.types.typecasting"> @@ -2144,15 +2144,15 @@ </para> <note> <para> - Au lieu de transtyper une variable en chane, vous pouvez aussi - l'insrer entre deux guillemets doubles : + Au lieu de transtyper une variable en chaîne, vous pouvez aussi + l'insérer entre deux guillemets doubles : <informalexample> <programlisting role="php"> <![CDATA[ <?php $foo = 10; // $foo est un entier -$str = "$foo"; // $str est une chane -$fst = (string) $foo; // $fst est aussi une chane +$str = "$foo"; // $str est une chaîne +$fst = (string) $foo; // $fst est aussi une chaîne // Ceci affiche : "Identique" if ($fst === $str) { @@ -2170,7 +2170,7 @@ <itemizedlist> <listitem> <simpara><link linkend="language.types.boolean.casting">Conversion en - boolen</link></simpara> + booléen</link></simpara> </listitem> <listitem> <simpara><link linkend="language.types.integer.casting">Conversion en @@ -2178,11 +2178,11 @@ </listitem> <listitem> <simpara><link linkend="language.types.float.casting">Conversion en - nombre virgule flottante</link></simpara> + nombre à virgule flottante</link></simpara> </listitem> <listitem> <simpara><link linkend="language.types.string.casting">Conversion en - chane de caractres</link></simpara> + chaîne de caractères</link></simpara> </listitem> <listitem> <simpara><link linkend="language.types.array.casting">Conversion en Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.36 phpdoc-fr/language/variables.xml:1.37 --- phpdoc-fr/language/variables.xml:1.36 Tue Feb 4 12:47:00 2003 +++ phpdoc-fr/language/variables.xml Wed Feb 5 22:54:19 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.36 $ --> +<!-- $Revision: 1.37 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -104,13 +104,13 @@ </informalexample> </para> <para> - &php; suit les conventions de Perl pour la gestion des oprateurs - arithmiques, et non pas celles du lanage C. Par exemple, en Perl + &php; suit les conventions de Perl pour la gestion des opérateurs + arithméiques, et non pas celles du lanage C. Par exemple, en Perl <literal>'Z'+1</literal> devient <literal>'AA'</literal>, tandis que en langage C <literal>'Z'+1</literal> devient <literal>'['</literal> ({ ord('Z') == 90, ord('[') == 91 ). <example> - <title>Oprations arithmtiques et caractres</title> + <title>Opérations arithmétiques et caractères</title> <programlisting role="php"> <![CDATA[ <?php @@ -148,11 +148,11 @@ </simpara> <warning> <simpara> - Depuis la version &php; 4.2.0, la valeur par dfaut de la directive &php; + Depuis la version &php; 4.2.0, la valeur par défaut de la directive &php; <link linkend="ini.register-globals">register_globals</link> est - <emphasis>off</emphasis>. Ceci est une volution majeure de &php;. - Avoir la directive register_globals <emphasis>off</emphasis> affecte les - variables prdfinies du contexte globale. Par exemple, pour lire + <emphasis>off</emphasis>. Ceci est une évolution majeure de &php;. + Avoir la directive register_globals à <emphasis>off</emphasis> affecte les + variables prédéfinies du contexte globale. Par exemple, pour lire <varname>DOCUMENT_ROOT</varname> vous devez utiliser <varname>$_SERVER['DOCUMENT_ROOT']</varname> au lieu de <varname>$DOCUMENT_ROOT</varname>, ou bien il faut lire <varname>$_GET['id']</varname> @@ -161,16 +161,16 @@ <varname>$HOME</varname>. </simpara> <simpara> - Pour des informations lies cette volution, lisez la documentation de la + Pour des informations liées à cette évolution, lisez la documentation de la directive <link linkend="ini.register-globals">register_globals</link>, le chapitre - sur la scrit, propos de l'<link linkend="security.registerglobals">Utilisation des variables super-globales</link>, + sur la sécrité, à propos de l'<link linkend="security.registerglobals">Utilisation des variables super-globales</link>, ainsi que les annonces de &php; <ulink url="&url.php.release4.1.0;">4.1.0</ulink> et <ulink url="&url.php.release4.2.0;">4.2.0</ulink>. </simpara> <simpara> - L'utilisation des variables prdfinies de &php;, comme les + L'utilisation des variables prédéfinies de &php;, comme les <link linkend="language.variables.superglobals">tableaux superglobaux</link>, - est recommand. + est recommandé. </simpara> </warning> <simpara> @@ -186,21 +186,21 @@ connaître le détails de leur contenu, et une présentation approfondie sur les variables prédéfinies &php;, et leur nature, reportez vous à la section <link linkend="reserved.variables">variables prédefinies</link>. - De plus, vous noterez que les anciennes variables prdfinies + De plus, vous noterez que les anciennes variables prédéfinies (<varname>$HTTP_*_VARS</varname>) existent toujours. </simpara> <note> <title>Variables variables</title> <para> - Les superglobales ne peuvent pas tre utilises comme + Les superglobales ne peuvent pas être utilisées comme <link linkend="language.variables.variable">variable variables</link>. </para> </note> <para> Si certaines variables de <link linkend="ini.variables-order">variables_order</link> - ne sont pas dfinies, leur tableau prdfini &php; correspondant est laiss vide. + ne sont pas définies, leur tableau prédéfini &php; correspondant est laissé vide. </para> <variablelist id="language.variables.superglobals"> @@ -428,14 +428,14 @@ <?php function test_global() { - // La plupart des variables prdfinies ne sont pas des "superglobales" et - // requiert le mot cl 'global' pour tre disponible dans une fonction. + // La plupart des variables prédéfinies ne sont pas des "superglobales" et + // requiert le mot clé 'global' pour être disponible dans une fonction. global $HTTP_POST_VARS; print $HTTP_POST_VARS['name']; // Les superglobales sont accessibles dans tous les contextes - // et ne requirent pas 'global'. Les superglobales sont disponibles + // et ne requièrent pas 'global'. Les superglobales sont disponibles // depuis PHP 4.1.0 print $_POST['name']; } @@ -522,12 +522,12 @@ </programlisting> </informalexample> <simpara> - Le Zend Engine 1, sur qui repose <literal>PHP4</literal>, implmente les + Le Zend Engine 1, sur qui repose <literal>PHP4</literal>, implémente les options <literal>static</literal> et <literal>global</literal> pour les variables, - en terme de rfrences. Par exemple, une vrai variable globale - est importe dans un contexte de fonction avec <literal>global</literal>. - Cette commande cre en fait une rfrence sur la variable globale. Ce - peut vous mener des comportement inattendus, comme par exemple : + en terme de références. Par exemple, une vrai variable globale + est importée dans un contexte de fonction avec <literal>global</literal>. + Cette commande crée en fait une référence sur la variable globale. Ce + peut vous mener à des comportement inattendus, comme par exemple : </simpara> <informalexample> <programlisting role="php"> @@ -553,7 +553,7 @@ </informalexample> <simpara> - Excuter cet exemple vous donnera : + Exécuter cet exemple vous donnera : </simpara> <screen> @@ -563,8 +563,8 @@ </screen> <simpara> - Un comportement similaire s'applique la commande <literal>static</literal>. - Les rfrences ne sont pas stockes dynamiquement : + Un comportement similaire s'applique à la commande <literal>static</literal>. + Les références ne sont pas stockées dynamiquement : </simpara> <informalexample> @@ -577,7 +577,7 @@ echo "Objet statique : "; var_dump($obj); if (!isset($obj)) { - // Assigne une rfrence une variable statique + // Assigne une référence à une variable statique $obj = &new stdclass; } $obj->property++; @@ -590,7 +590,7 @@ echo "Objet statique : "; var_dump($obj); if (!isset($obj)) { - // Assigne une objet une variable statique + // Assigne une objet à une variable statique $obj = new stdclass; } $obj->property++; @@ -608,7 +608,7 @@ </informalexample> <simpara> - Excuter cet exemple vous donnera : + Exécuter cet exemple vous donnera : </simpara> <screen> @@ -623,9 +623,9 @@ </screen> <simpara> - Ces exemples illustrent les problmes rencontrs lors de l'assignation - de rfrence des variables statiuqes, qui sont - <emphasis>oublies</emphasis> lorsque vous appelez + Ces exemples illustrent les problèmes rencontrés lors de l'assignation + de référence à des variables statiuqes, qui sont + <emphasis>oubliées</emphasis> lorsque vous appelez <literal>&get_instance_ref()</literal> une seconde fois. </simpara> </sect1> @@ -730,14 +730,14 @@ </para> <para> - Suivant votre configuration particulier et vos prfrences, - vous avez plusieurs mthodes pour accder aux variables du formulaires. + Suivant votre configuration particulièer et vos préférences, + vous avez plusieurs méthodes pour accéder aux variables du formulaires. Voici quelques exemples : </para> <para> <example> - <title>Accder simplement des variables de formulaires POST</title> + <title>Accéder simplement à des variables de formulaires POST</title> <programlisting role="html"> <![CDATA[ <?php @@ -754,8 +754,8 @@ print $HTTP_POST_VARS['username']; // Disponibles si la directive register_globals = on. Depuis -// PHP 4.2.0 la valeur par dfaut de cette directive est register_globals = off. -// Utiliser ou prsumer cette mthode est dcourag. +// PHP 4.2.0 la valeur par défaut de cette directive est register_globals = off. +// Utiliser ou présumer cette méthode est découragé. print $username; ?> @@ -765,11 +765,11 @@ </para> <para> Utiliser un formulaire de type GET est similaire, hormis le fait que - vpis devez utiliser les variables prdfinies du GET la place. - GET s'applique aussi la QUERY_STRING (les informations disponibles aprs + vpis devez utiliser les variables prédéfinies du GET à la place. + GET s'applique aussi à la QUERY_STRING (les informations disponibles après le '?' dans une URL). De ce fait, par exemple, <literal>http://www.exemple.com/test.php?id=3</literal> - contient les donnes de GET, qui sont accessibles via <varname>$_GET['id']</varname>. + contient les données de GET, qui sont accessibles via <varname>$_GET['id']</varname>. Voyez aussi <link linkend="reserved.variables.request">$_REQUEST</link> et <function>import_request_variables</function>. </para> @@ -794,9 +794,9 @@ <note> <para> La directive de configuraion <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - affecte les valeurs de GET, POST et cookies. Si elle est active, - une valeur comme celle de (C'est "PHP!") sera magiquement transforme en (C\'est \"PHP!\"). - La protection des caractres est ncessaire pour l'insertion dans les bases de donnes. + affecte les valeurs de GET, POST et cookies. Si elle est activée, + une valeur comme celle de (C'est "PHP!") sera magiquement transformée en (C\'est \"PHP!\"). + La protection des caractères est nécessaire pour l'insertion dans les bases de données. Voyez aussi les fonctions <function>addslashes</function>, <function>stripslashes</function> et <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>. @@ -807,8 +807,8 @@ &php; comprend aussi les tableaux dans le contexte des formulaires. (voir aussi <link linkend="faq.html">related faq</link>). Vous pouvez, par exemple, grouper des variables ensembles, ou bien utiliser cette - fonctionnalit pour lire des valeurs multiples d'un menu droulant. - Par exemple, voici un formulaire qui se poste lui mme des donnes, + fonctionnalité pour lire des valeurs multiples d'un menu déroulant. + Par exemple, voici un formulaire qui se poste lui même des données, et les affiche : </simpara> @@ -822,7 +822,7 @@ print '<pre>'; print_r($HTTP_POST_VARS); - print '<a href="'. $HTTP_SERVER_VARS['PHP_SELF'] .'">Essayez nouveau</a>'; + print '<a href="'. $HTTP_SERVER_VARS['PHP_SELF'] .'">Essayez à nouveau</a>'; print '</pre>'; } else { @@ -848,8 +848,8 @@ </para> <para> - En PHP 3, la syntaxe de tableau HTML est limite aux tableaux - uni-dimensionnels. En PHP 4, ces limitations ont t leves. + En PHP 3, la syntaxe de tableau HTML est limitée aux tableaux + uni-dimensionnels. En PHP 4, ces limitations ont été levées. </para> <sect3 id="language.variables.external.form.submit"> @@ -870,11 +870,11 @@ <simpara> Lorque l'utilisateur clique sur cette image, le formulaire - associ est envoy au serveur, avec deux donnes supplmentaires, + associé est envoyé au serveur, avec deux données supplémentaires, <varname>sub_x</varname> et <varname>sub_y</varname>. Elles contiennent - les coordonnes du clic de l'utilisateur dans l'image. Vous noterez - que ces variables sont envoyes par le navigateur avec un point dans leur - nom, mais &php; convertit ces points en souligns. + les coordonnées du clic de l'utilisateur dans l'image. Vous noterez + que ces variables sont envoyées par le navigateur avec un point dans leur + nom, mais &php; convertit ces points en soulignés. </simpara> </sect3> </sect2>