cvs: phpdoc-fr /language control-structures.xml functions.xml oop.xml operators.xml types.xml variables.xml
| From: | Damien Seguy | Date: | Tue, 04 Feb 2003 17:47:00 +0000 |
| Subject: | cvs: phpdoc-fr /language control-structures.xml functions.xml oop.xml operators.xml types.xml variables.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-204@lists.php.net to get a copy of this message | ||
dams Tue Feb 4 12:47:00 2003 EDT
Modified files:
/phpdoc-fr/language control-structures.xml functions.xml oop.xml
operators.xml types.xml variables.xml
Log:
early spring cleaning
Index: phpdoc-fr/language/control-structures.xml diff -u phpdoc-fr/language/control-structures.xml:1.19 phpdoc-fr/language/control-structures.xml:1.20 --- phpdoc-fr/language/control-structures.xml:1.19 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/control-structures.xml Tue Feb 4 12:47:00 2003 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="control-structures"> <title>Les structures de contrôle</title> <simpara> - Tous les scripts PHP sont une suite d'instructions. Une instruction + Tous les scripts &php; sont une suite d'instructions. Une instruction peut être une assignation, un appel de fonction, une instruction conditionnelle ou bien une instruction qui ne fait rien (une instruction vide). Une instruction se termine habituellement par un point virgule @@ -17,10 +17,10 @@ <title><literal>if</literal></title> <para> L'instruction <literal>if</literal> est une des plus importantes - instructions de tous les langages, PHP inclus. Elle permet + instructions de tous les langages, &php; inclus. Elle permet l'exécution conditionnelle d'une partie de code. Les fonctionnalités de l'instruction <literal>if</literal> - sont les mêmes en PHP qu'en C : + sont les mêmes en &php; qu'en C : <informalexample> <programlisting role="php"> <![CDATA[ @@ -37,7 +37,7 @@ <link linkend="language.expressions">expressions</link>, <replaceable>expr</replaceable> est convertie en sa valeur booléenne. Si l'expression <replaceable>expr</replaceable> vaut - &true;, PHP exécutera l'instruction et si elle + &true;, &php; exécutera l'instruction et si elle vaut &false;, l'instruction sera ignorée. Plus de détails sur les vlaeurs qui valent &false; est disponbile dans la section @@ -156,7 +156,7 @@ Vous pouvez avoir plusieurs <literal>elseif</literal> qui se suivent les uns après les autres, après un <literal>if</literal> initial. Le premier <literal>elseif</literal> qui sera évalué - à &true; sera exécuté. En PHP, vous + à &true; sera exécuté. En &php;, vous pouvez aussi écrire "else if" en deux mots et son comportement sera identique à la version en un seul mot. La sémantique des deux expression est légèrement différente, mais au bout du compte, @@ -174,7 +174,7 @@ <sect1 id="control-structures.alternative-syntax"> <title>Syntaxe alternative</title> <para> - Le PHP propose une autre manière de rassembler des + &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>, @@ -233,7 +233,7 @@ <title><literal>while</literal></title> <para> La boucle <literal>while</literal> est le moyen le plus - simple d'implémenter une boucle en PHP. Cette boucle + simple d'implémenter une boucle en &php;. Cette boucle se comporte de la même manière qu'en C. L'exemple le plus simple d'une boucle <literal>while</literal> est le suivant : @@ -249,14 +249,14 @@ </para> <simpara> La signification d'une boucle <literal>while</literal> est - très simple. Le PHP exécute l'instruction tant + très simple. PHP exécute l'instruction tant que l'expression de la boucle <literal>while</literal> est évaluée comme &true;. La valeur de l'expression est vérifiée à chaque début de boucle, et, si la valeur change durant l'exécution de l'instruction, l'exécution ne s'arrêtera qu'à la fin de l'itération - (chaque fois que le PHP exécute l'instruction, on appelle + (chaque fois que &php; exécute l'instruction, on appelle cela une itération). De temps en temps, si l'expression du <literal>while</literal> est &false; avant la première itération, l'instruction ne sera jamais @@ -378,7 +378,7 @@ <sect1 id="control-structures.for"> <title><literal>for</literal></title> <para> - Les boucles <literal>for</literal> sont les boucles les plus complexes en PHP. + Les boucles <literal>for</literal> sont les boucles les plus complexes en &php;. Elles fonctionnent comme les boucles <literal>for</literal> du langage C. La syntaxe des boucles for est la suivante: <informalexample> @@ -413,7 +413,7 @@ 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 &true;, + (&php; considère implicitement qu'elle vaut &true;, 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>. @@ -459,7 +459,7 @@ boucle <literal>for</literal> peut être utile parfois. </simpara> <para> - PHP supporte aussi la syntaxe alternative suivante pour les boucles + &php; supporte aussi la syntaxe alternative suivante pour les boucles <literal>for</literal> : <informalexample> <programlisting role="php"> @@ -473,9 +473,9 @@ </para> <para> Les autres langages ont l'instruction <literal>foreach</literal> - pour accéder aux éléments d'un tableau. PHP 3 - ne dispose pas d'une telle fonction; PHP 4 en dispose (voir - <link linkend="control-structures.foreach">foreach</link>). En PHP 3, + pour accéder aux éléments d'un tableau. &php; 3 + ne dispose pas d'une telle fonction; &php; 4 en dispose (voir + <link linkend="control-structures.foreach">foreach</link>). En &php; 3, vous pouvez combiner <link linkend="control-structures.while">while</link> avec <function>list</function> et <function>each</function> pour obtenir le même résultat. Reportez-vous aux exemples @@ -485,7 +485,7 @@ <sect1 id="control-structures.foreach"> <title><literal>foreach</literal></title> <para> - PHP 4 (mais pas PHP 3) inclut une commande <literal>foreach</literal>, + &php; 4 (mais pas &php; 3) inclut une commande <literal>foreach</literal>, comme en Perl ou d'autres langages. C'est un moyen simple de passer en revue un tableau. Il y a deux syntaxes possibles : la seconde est une extension mineure mais pratique de la première: @@ -653,27 +653,30 @@ <programlisting role="php"> <![CDATA[ <?php -$i = 0; -while ($i < 10) { - if ($arr[$i] == "stop") { - break; /* Vous pouvez aussi écrire 'break 1;' ici. */ +$arr = array ('un', 'deux', 'trois', 'quatre', 'stop', 'cinq'); +while (list (, $val) = each ($arr)) { + if ($val == 'stop') { + break; /* Vous pourriez aussi utiliser 'break 1;' ici. */ } - $i++; + echo "$val<br>\n"; } + /* Utilisation de l'argument optionnel. */ + $i = 0; -while ( ++$i ) { - switch ( $i ) { +while (++$i) { + switch ($i) { case 5: - echo "à 5<br>\n"; - break 1; /* Ne sort que du switch. */ + echo "A 5<br>\n"; + break 1; /* Termine uniquement le switch. */ case 10: - echo "à 10; quitting<br>\n"; - break 2; /* Sort du switch et du while. */ + echo "At 10; quitting<br>\n"; + break 2; /* Termine le switch et la buocle while. */ default: break; } } + ?> ]]> </programlisting> @@ -777,13 +780,13 @@ est exécutée ligne par ligne. Au début, aucun code n'est exécuté. Seulement lorsqu'un <literal>case</literal> est vérifié, - PHP exécute alors les instructions correspondantes. - PHP continue d'exécuter les instructions jusqu'à + &php; exécute alors les instructions correspondantes. + &php; continue d'exécuter les instructions jusqu'à la fin du bloc d'instructions du <literal>switch</literal>, ou bien dès qu'il trouve l'instruction <literal>break</literal>. Si vous ne pouvez pas utiliser l'instruction <literal>break</literal> à la fin de l'instruction - <literal>case</literal>, PHP continuera à exécuter + <literal>case</literal>, &php; continuera à exécuter toutes les instructions qui suivent. Par exemple : <informalexample> <programlisting role="php"> @@ -803,9 +806,9 @@ </informalexample> </para> <simpara> - Dans cet exemple, si $i est égal à 0, PHP va + Dans cet exemple, si $i est égal à 0, &php; va exécuter quand même toutes les instructions qui - suivent. Si $i est égal à 1, PHP exécutera + suivent. Si $i est égal à 1, &php; exécutera les deux dernières instructions. Et seulement si $i est égal à 2, vous obtiendrez le résultat escompté, c'est-à-dire, l'affiche de @@ -825,7 +828,7 @@ </simpara> <para> La liste de commandes d'un <literal>case</literal> peut - être vide, auquel cas PHP utilisera la liste de + être vide, auquel cas &php; utilisera la liste de commandes du cas suivant. <informalexample> <programlisting role="php"> @@ -953,7 +956,7 @@ </para> <para> <example> - <title>Profile a section of PHP code</title> + <title>Profiler une section de code &php;</title> <programlisting role="php"> <![CDATA[ <?php @@ -988,7 +991,7 @@ ]]> </programlisting> </example> - Cet exemple profile le code PHP dans le bloc de déclaration, + Cet exemple profile le code &php; dans le bloc de déclaration, et enregistre l'heure de chaque commande bas niveau. Cette information peut être réutilisée pour débusquer les segments de code lents. Vous pouvez implémenter d'autres méthodes, mais @@ -997,7 +1000,7 @@ <simpara> Les ticks sont bien pratiques pour débugger, implémenter un multi-tâches simple, des entrées sorties en tâche de - fond, ou bien d'autres choses, avec PHP. + fond, ou bien d'autres choses, avec &php;. </simpara> <simpara> Voir aussi @@ -1044,7 +1047,7 @@ <title><function>require</function></title> <simpara> <function>require</function> inclut et exécute un - fichier PHP. + fichier &php;. </simpara> <simpara> La commande <function>require</function> se remplace elle-même @@ -1072,12 +1075,11 @@ <programlisting role="php"> <![CDATA[ <?php - require ("file.inc?varone=1&vartwo=2"); -/* Ne fonctionne pas. */ - $varone = 1; - $vartwo = 2; - require ("file.inc"); -/* $varone et $vartwo seront accessibles à file.inc */ + require 'prepend.php'; + + require $somefile; + + require ('unfichier.txt'); ?> ]]> </programlisting> @@ -1089,7 +1091,7 @@ </simpara> <note> <simpara> - Avant PHP 4.0.2, ceci s'appliquait : <function>require</function> tentait + Avant &php; 4.0.2, ceci s'appliquait : <function>require</function> tentait de lire le fichier cible, même si les lignes n'étaient pas utilisées. Une condition if n'avait aucun effet sur <function>require</function>. Cependant, si la ligne du <function>require</function> n'est jamais utilisée, @@ -1210,7 +1212,7 @@ parent ne sera pas interrompue. Pour cette raison, le code qui est dans le fichier doit être placé entre <link linkend="language.basic-syntax.phpmode">les balises - habituelles de PHP</link>. + habituelles de &php;</link>. </simpara> <simpara> Si les "<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>" @@ -1219,7 +1221,7 @@ bien avec un gestionnaire adapté : voir <xref linkend="wrappers"/> pour une liste des protocoles), au lieu d'un simple chemin local. Si le serveur distant interprête le fichier comme du code - PHP, des variables peuvent être transmises au serveur distant + &php;, des variables peuvent être transmises au serveur distant via l'URL et la méthode GET. Ce n'est pas, à strictement parler, la même chose que d'hériter du contexte de variable. Le fichier inclus est en fait un script exécuté à distance, @@ -1304,7 +1306,7 @@ </simpara> <note> <simpara> - En PHP 3, le retourn n'est pas utilisable à moins que ce + En &php; 3, le retourn n'est pas utilisable à moins que ce ne soit dans un bloc de fonction, auquel cas le <function>return</function> s'applique à une fonction et non pas au fichier. @@ -1394,11 +1396,11 @@ Pour des exemples avec <function>require_once</function> et <function>include_once</function>, reportez-vous au code <ulink url="&url.php.pear;">PEAR</ulink> inclut dans les - dernières distributions PHP. + dernières distributions &php;. </para> <note> <para> - <function>require_once</function> a été ajouté en PHP 4.0.1pl2 + <function>require_once</function> a été ajouté en &php; 4.0.1pl2 </para> </note> <note> @@ -1440,9 +1442,7 @@ sera pas une seconde fois. </para> <para> - Comme précisé dans la section - <function>require_once</function>, la fonction - <function>include_once</function> est utilisée de + La fonction <function>include_once</function> est utilisée de préférence lorsque le fichier doit être inclus ou évalué plusieurs fois dans un script, ou bien lorsque vous voulez être sûr qu'il ne sera inclus @@ -1450,16 +1450,41 @@ de fonction. </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> + <note> + <para> + <function>include_once</function> a été ajouté en &php; 4.0.1pl2 + </para> + </note> + <note> + <para> + Attention, <function>include_once</function> et + <function>include_once</function> sont sensibles à la casse + sous Windows. + <example> + <title><function>include_once</function> est sensible à la casse</title> + <programlisting role="php"> +<![CDATA[ +include_once("a.php"); // ceci inclut le fichier a.php +include_once("A.php"); // ceci inclut encore le fichier a.php sous Windows! +]]> + </programlisting> + </example> + </para> + </note> + &warn.no-win32-fopen-wrapper; <para> - Voir aussi: <function>require</function>, - <function>include</function>, <function>require_once</function>, + Voir aussi + <function>require</function>, + <function>include</function>, + <function>require_once</function>, <function>get_required_files</function>, - <function>get_included_files</function>, <function>readfile</function>, - et <function>virtual</function>. + <function>get_included_files</function>, + <function>readfile</function> et + <function>virtual</function>. </para> </sect1> </chapter> Index: phpdoc-fr/language/functions.xml diff -u phpdoc-fr/language/functions.xml:1.12 phpdoc-fr/language/functions.xml:1.13 --- phpdoc-fr/language/functions.xml:1.12 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/functions.xml Tue Feb 4 12:47:00 2003 @@ -1,12 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <chapter id="functions"> <title>Les fonctions</title> <sect1 id="functions.user-defined"> - <title>Les fonctions utilisateur</title> + <title>Les fonctions</title> <para> Une fonction peut être définie en utilisant la syntaxe suivante : - <informalexample> + <example> + <title>Dfinition d'une fonction</title> <programlisting role="php"> <![CDATA[ <?php @@ -17,7 +18,7 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> Tout code PHP, correct syntaxiquement, peut apparaître @@ -28,6 +29,74 @@ 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> + <para> + Lorsqu'une fonction est dfinie de manire conditionnelle, comme dans + les exemples ci-dessous, leur dfinition doit <emphasis>prcder</emphasis> + leur utilisation. + <example> + <title>Fonctions conditionnelles</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$makefoo = true; + +/* Impossible d'appeler foo() ici, + car cette fonction n'existe pas. + Mais nous pouvons utiliser bar() */ + +bar(); + +if ($makefoo) { + function foo () + { + echo "Je n'existe pas tant que le programme n'est pas pass ici.\n"; + } +} + +/* Maitenant, nous pouvons appeler foo() + car $makefoo est maintenant vrai */ + +if ($makefoo) foo(); + +function bar() { +{ + echo "J'existe ds de dbut du programme.\n"; +} + +?> +]]> + </programlisting> + </example> + <example> + <title>Fonctions dans une autre fonctions</title> + <programlisting role="php"> +<![CDATA[ +<?php +function foo() +{ + function bar() + { + echo "Je n'existe pas tant que foo() n'est pas appel.\n"; + } +} + +/* Impossible d'appeler bar() ici + car il n'existe pas. */ + +foo(); + +/* Maintenant, nous pouvons appeler bar(), + car l'utilisation de foo() l'a rendu + accessible. */ + +bar(); + +?> +]]> + </programlisting> + </example> + </para> <simpara> PHP ne supporte pas le surchargement de fonction, ni la destruction ou la redéfinition de fonctions déjà déclarées. @@ -93,7 +162,7 @@ <programlisting role="php"> <![CDATA[ <?php -function add_some_extra(&$string) { +function add_some_extra(&$string) { $string .= ', et un peu plus.'; } $str = 'Ceci est une chaîne'; @@ -119,7 +188,7 @@ $str = Ceci est une chaîne'; foo ($str); echo $str; // affiche 'Ceci est une chaîne' -foo (&$str); +foo (&$str); echo $str; // affiche 'Ceci est une chaîne, et un peu plus.' ?> ]]> @@ -268,10 +337,10 @@ <programlisting role="php"> <![CDATA[ <?php -function &retourne_reference() { +function &retourne_reference() { return $uneref; } -$newref =&retourne_reference(); +$newref =& retourne_reference(); ?> ]]> </programlisting> @@ -326,10 +395,10 @@ <![CDATA[ <?php function foo() { - echo "dans foo()<br>\n"; + echo "dans foo()<br>\n"; } function bar( $arg = '' ) { - echo "Dans bar(); l'argument était '$arg'.<br>\n"; + echo "Dans bar(); l'argument était '$arg'.<br>\n"; } $func = 'foo'; $func(); Index: phpdoc-fr/language/oop.xml diff -u phpdoc-fr/language/oop.xml:1.19 phpdoc-fr/language/oop.xml:1.20 --- phpdoc-fr/language/oop.xml:1.19 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/oop.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="language.oop"> <title>Les classes et les objets</title> <sect1 id="keyword.class"> @@ -668,7 +668,7 @@ crée dans le constructeur crée dans le constructeur crée dans le constructeur */ - $bar2 =&new foo('crée dans le constructeur'); + $bar2 =&new foo('crée dans le constructeur'); $bar2->echoName(); $globalref[1]->echoName(); /* affiche : @@ -747,8 +747,8 @@ } } class b { - function b(&$a) { - $this->a = &$a; + function b(&$a) { + $this->a = &$a; } function echoValue() { echo "<br>","class ",get_class($this),': ',$this->a->value; @@ -757,7 +757,7 @@ // Essayez de comprendre pourquoi une copie simple va // conduire à un résultat indésirable à // la ligne marquée d'une étoile -$a =&new a(10); +$a =&new a(10); $a->createRef(); $a->echoValue(); $a->b->echoValue(); Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.19 phpdoc-fr/language/operators.xml:1.20 --- phpdoc-fr/language/operators.xml:1.19 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/operators.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="language.operators"> <title>Les opérateurs</title> <simpara> @@ -190,7 +190,8 @@ assignée. Par exemple, la valeur de l'expression '$a = 3' est la valeur 3. Cela permet d'utiliser des astuces telles que : - <informalexample> + <example> + <title>Astuce d'assignation</title> <programlisting role="php"> <![CDATA[ <?php @@ -199,7 +200,7 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <para> En plus du simple opérateur d'assignation, il existe des @@ -208,9 +209,10 @@ chaînes de caractères. Cela permet d'utiliser la valeur d'une variable dans une expression et d'affecter le résultat de cette expression à cette variable. - Par exemple: - <informalexample> - <programlisting role="php"> + Par exemple : + <example> + <title>Exemples avec les opérateurs d'assignation</title> + <programlisting role="php"> <![CDATA[ <?php $a = 3; @@ -225,7 +227,7 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <para> On peut noter que l'assignation copie le contenu de la variable originale @@ -247,6 +249,27 @@ Les opérateurs sur les bits vous permettent de manipuler les bits dans un entier. </simpara> + <para> + <example> + <title>Exemples avec les ppérateurs sur les bits</title> + <programlisting role="php"> +<![CDATA[ +<?php + echo 12 ^ 9; +// Affiche '5' + + echo "12" ^ "9"; +// Affiche le caractre d'effacement (ascii 8) +// ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8 + +echo "hallo" ^ "hello"; +// Affiche la valeur asciie : s #0 #4 #0 #0 #0 +// 'a' ^ 'e' = #4 +?> +]]> + </programlisting> + </example> + </para> <table> <title>Les opérateurs sur les bits</title> <tgroup cols="3"> Index: phpdoc-fr/language/types.xml diff -u phpdoc-fr/language/types.xml:1.20 phpdoc-fr/language/types.xml:1.21 --- phpdoc-fr/language/types.xml:1.20 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/types.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <chapter id="language.types"> <title>Les types</title> <sect1 id="language.types.intro"> @@ -70,15 +70,7 @@ C'est un pseudo-type, qui indique que le paramètre peut indifféremment prendre plusieurs types. </simpara> - <!-- - Just an idea, maybe useful for some func-defs? - (at least it is for the operator-defs) - <simpara> - In parameter definitions you can also encouter the 'number' pseudo-type, - that indicates a parameter that is either <type>integer</type> or - <type>float</type>. - </simpara> - --> + </note> <simpara> Habituellement, le type d'une variable n'est pas déclaré @@ -86,6 +78,46 @@ l'exécution par le PHP, en fonction du contexte dans lequel la variable est utilisée. </simpara> + <note> + <simpara> + Si vous voulez vrifier 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 + de certains types, <emphasis>n'utilisez pas</emphasis> <function>gettype</function>, + mais plutt les fonctions <literal>is_<replaceable>type</replaceable></literal>. + Par exemple : + <example> + <title>Exemples de vrification de type de variable</title> + <programlisting role="php"> +<![CDATA[ +<?php +$bool = TRUE; // un boolen +$str = "foo"; // une chane de caractres +$int = 12; // un entier + +echo gettype($bool); // affiche "boolean" +echo gettype($str); // affiche "string" + +// Ceci est un engier, on l'incrmente de 4 +if (is_int($int)) { + $int += 4; +} + +// Si $bool est une chane, l'afficher +// (Ne pas imprimer n'importe quoi). +if (is_string($bool)) { + echo "Chaine : $bool"; +} +?> +]]> + </programlisting> + </example> + </para> + </note> <simpara> Si vous voulez forcer une variable à être convertie en un certain type, vous devez transtyper @@ -116,7 +148,10 @@ <informalexample> <programlisting role="php"> <![CDATA[ -$foo = True; // assign the value TRUE to $foo +<?php + $foo = True; + // assigne la valeur TRUE la variable $foo +?> ]]> </programlisting> </informalexample> @@ -163,7 +198,8 @@ <itemizedlist> <listitem> <simpara> - Le <link linkend="language.types.boolean">booléen</link> FALSE </simpara> + Le <link linkend="language.types.boolean">booléen</link>FALSE + </simpara> </listitem> <listitem> <simpara> @@ -207,8 +243,22 @@ <literal>-1</literal> est considéré comme vrai! </simpara> </warning> - <!-- and/or a few examples, for the people only looking at - the examples... </XXX> --> + <example> + <title>Conversion en boolen</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo gettype((bool) ""); // bool(false) +echo gettype((bool) 1); // bool(true) +echo gettype((bool) -2); // bool(true) +echo gettype((bool) "foo"); // bool(true) +echo gettype((bool) 2.3e5); // bool(true) +echo gettype((bool) array(12)); // bool(true) +echo gettype((bool) array()); // bool(false) +?> +]]> + </programlisting> + </example> </para> </sect2> </sect1> @@ -276,38 +326,34 @@ <para> Si un nombre est hors de l'intervalle de validité des entiers, il sera interprété comme un <type>float</type>. - <informalexample> + <example> + <title>Dépassement de capacité des entiers</title> <programlisting role="php"> <![CDATA[ <?php - $large_number = 2147483647; - var_dump($large_number); +$large_number = 2147483647; +var_dump($large_number); // affiche : int(2147483647) - var_dump( 0x80000000 ); - // affiche : float(2147483648) +$large_number = 2147483648; +var_dump($large_number); +// affiche : float(2147483648) + +// this goes also for hexadecimal specified integers: +var_dump( 0x80000000 ); +// affiche : float(2147483648) -var_dump( 25/7 ); -// affiche : float(3.5714285714286) +$million = 1000000; +$large_number = 50000 * $million; +var_dump($large_number); +// affiche : float(50000000000) ?> ]]> </programlisting> - </informalexample> + </example> De même, si une fonction ou un opérateur retourne un entier qui est hors des limites de validité des entiers, il sera aussi automatiquement converti en <type>float</type>. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $million = 1000000; - $large_number = 50000 * $million; - var_dump($large_number); -// affiche : float(50000000000) -?> -]]> - </programlisting> - </informalexample> </para> <para> En PHP, il n'y a pas de division entière. <literal>1/2</literal> @@ -326,6 +372,29 @@ <literal>-429496728</literal>. </simpara> </warning> + <para> + Il n'existe pas de division entire en PHP. + <literal>1/2</literal> gnrera 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> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(25/7); + // float(3.5714285714286) +var_dump((int) (25/7)); + // int(3) +var_dump(round(25/7)); + // float(4) +?> +]]> + </programlisting> + </example> + </para> </sect2> <sect2 id="language.types.integer.casting"> <title>Conversion en entiers</title> @@ -798,17 +867,39 @@ <example> <title>Utilisation des accolades {} dans les chaînes pour les tableaux</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php - $fruits = array( 'fraise' => 'rouge' , 'banane' => 'jaune' ); - echo "Une banane est $fruits[banane]."; - // OK. Notez toutefois que pour cet exemple, cela fonctionne - // différemment. Voyez <literal>$foo[bar]</literal> hors des chaînes - echo "Ce carré est large de $carre->largeur mètres."; - // OK - echo "Ce carré est large de $carre->largeur00 mètres.."; - // pas OK - // pour résoudre ce problème, voyez la syntaxe complexe. +// Ces exemples sont spcifiques l'utilisation de tableaux dans une chane. +// Lorsque vous tes hors d'une chane, utilisez toujours des guillemets +// autour des index de tableau, et n'utilisez pas d'{accolades}. + +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$fruits = array('fraise' => 'rouge', 'banane' => 'jaune'); + +// Fonctionne mais notez que cela fonctionne pas comme +// si cela tait hors d'une chane +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 +echo "Une banane est {$fruits[banane]}."; + +// Ne fonctionne pas, il manque les accolades. Cela donne une erreur d'analyse +echo "Une banane est $fruits['banane']."; + +// Fonctionne +echo "Une banane est " . $fruits['banane'] . "."; + +// Fonctionne +echo "Ce carr a un cot de $square->width mtres de large."; + +// Ne fonctionne pas. Pour une solution, voyez la syntaxe complexe. +echo "Ce carr a un cot de $square->width00 centimtres."; ?> ]]> </programlisting> @@ -835,35 +926,49 @@ pour obtenir un <literal>"{$"</literal> littéral. Voici quelques exemples : </simpara> - <informalexample> + <example> + <title>Syntaxe complexe de chane</title> <programlisting role="php"> <![CDATA[ <?php - $super = 'fantastique'; - echo "C'est { $super}"; -// ne fonctionne pas, -// affiche "C'est { fantastique}" - echo "C'est {$super}"; -// fonctionne, -// affiche "C'est fantastique" - echo "Ce carré a {$square->width}00 centimètres de large."; - echo "Ceci fonctionne : {$tableau[4][3]}"; - echo "Ceci échoue : {$tableau[foo][3]}"; -// pour la même raison que $tableau[bar] ne fonctionne pas hors d'une chaîne - <!-- XXX see the still-to-write explaination in the arrays-section. --> - echo "Essayez plutôt comme ceci : {$tableau['foo'][3]}"; - echo "Vous pouvez même écrire {$objet->valeurs[3]->nom}"; - echo "Voici la valeur de la variable nommée $name: {${$name}}"; - <!-- <xxx> maybe it's better to leave this out?? --> -// cela fonctionne, mais c'est vivement déconseillé. -// Et pour finir, on peut combiner avec des fonctions - $inv = 'Bordeaux'; - echo "Je reprendrai bien un verre de cet excellent {${ strrev('niv') }}, hips"; - <!-- </xxx> --> +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$super = 'fantastique'; + +// Ne fonctionne pas. Affiche : Ceci est { fantastique} +echo "Ceci est { $super}"; + +// Fonctionne. Affiche Ceci est fantastique +echo "This is {$super}"; +echo "This is ${super}"; + +// Fonctionne +echo "Ce carr a un cot de {$square->width}00 centimtres."; + +// 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). +echo "Ceci est faux : {$arr[foo][3]}"; + +// Fonctionne. Lorsuqe vous utilisez un tableau multidimensionnel dans +// une chane, 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 "Ceci est une valeur de variable variable : {${$name}}"; ?> ]]> </programlisting> - </informalexample> + </example> </sect4> </sect3> <sect3 id="language.types.string.substr"> @@ -884,29 +989,18 @@ <example> <title>Exemples de chaînes</title> <programlisting role="php"> -<!-- TODO: either move these examples to a example section, -as with arrays, or distribute them under the applicable -sections. --> -<![CDATA[ -<?php -/* Affectation d'une chaîne. */ - $str = "Ceci est une chaîne"; -/* Concaténation. */ - $str = $str . " avec un peu plus de texte"; -/* Une autre méthode de concaténation. */ - $str .= " et une nouvelle ligne à la fin.\n"; -/* Cette chaîne finira comme : '<p>Nombre: 9</p>' */ - $num = 9; - $str = "<p>Nombre: $num</p>"; -/* Celle-ci sera '<p>Nombre: $num</p>' */ - $num = 9; - $str = '<p>Nombre: $num</p>'; -/* Premier caractère d'une chaîne */ - $str = 'Ceci est un test.'; - $first = $str{0}; -/* Dernier caractère d'une chaîne. */ - $str = 'This is still a test.'; - $last = $str{strlen($str)-1}; +<![CDATA[ +<?php +// Lit le premier caractre de la chane +$str = 'Ceci est un test.'; +$first = $str{0}; + +// Lit le troisime caractre de la chane +$third = $str{2}; + +// Lit le dernier caractre de la chane +$str = 'Ceci est un test.'; +$last = $str{strlen($str)-1}; ?> ]]> </programlisting> @@ -1095,20 +1189,31 @@ <replaceable>value</replaceable></literal>, séparées par des virgules. </para> <para> - Une clé <varname>key</varname> est soit un entier positif + <synopsis> +array( <optional> <replaceable>key</replaceable> => </optional> +<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 + </synopsis> + </para> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$arr = array("foo" => "bar", 12 => true); + +echo $arr["foo"]; // bar +echo $arr[12]; // 1 +?> +]]> + </programlisting> + </informalexample> + </para> + <para> + Une clé <varname>key</varname> est soit un entier ou bien une chaîne. - <!-- - Negative integers are also allowed, however, IMO it's best to not - document that, or even disencourage it. - Why? - First, because it is very tricky. But the real reason is that the key - '-1' will be interpreted as a string, and not as a integer. Therefore, - the usage - "the -1'st value of \$arr is $arr[-1]" is ambigious. By the way, - it results in a parse-error anyway, which is another argument for - not documenting it. - -Jeroen - --> Si une clé est la représentation standard d'un entier positif, elle sera interprété comme tel. (i.e. <literal>'8'</literal> sera interprété comme <literal>8</literal>, tandis que <literal>'08'</literal> @@ -1121,7 +1226,12 @@ <programlisting role="php"> <![CDATA[ <?php - array("somearray" => array(6 => 5, 13 => 9, "a" => 43)); + array("untableau" => array(6 => 5, 13 => 9, "a" => 43)); + +echo $arr["untableau"][6]; // 5 +echo $arr["untableau"][13]; // 9 +echo $arr["untableau"]["a"]; // 42 + ?> ]]> </programlisting> @@ -1133,18 +1243,35 @@ indice numérique n'a été généré, ce sera 0. Si vous spécifiez une qui a déjà été assigné, la nouvelle valeur écrasera la précédente. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +// Ce tableau est identique +array(5 => 43, 32, 56, "b" => 12); + +// Celui ci +array(5 => 43, 6 => 32, 7 => 56, "b" => 12); +?> +]]> + </programlisting> + </informalexample> </para> - <para> - <synopsis> -array( <optional><replaceable>key</replaceable> => </optional> -<replaceable>value</replaceable> - , ... - ) -// <replaceable>key</replaceable> is either <type>string</type> -ou entier <type>integer</type> positif -// <replaceable>value</replaceable> peut être n'importe quoi - </synopsis> - </para> + <para> + Utiliser &true; comme cl revient utiliser le type + <type>integer</type> de valeur <literal>1</literal>. + Utiliser &false; comme cl revient utiliser le type + <type>integer</type> de valeur <literal>0</literal>. + 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 + 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>. + </para> </sect3> <sect3 id="language.types.array.syntax.modifying"> <title>La syntaxe à crochets</title> @@ -1166,6 +1293,26 @@ en fait une alternative pour créer un tableau. Pour modifier une valeur, assignez lui une nouvelle valeur. Pour supprimer une valeur, utilisez la fonction <function>unset</function>. + <example> + <title>Manipuler des lments 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["x"] = 42; // Ceci ajoute un nouvel lment + // avec l'index "x" + +unset($arr[5]); // Ceci efface un lment du tableau + +unset($arr); // Ceci efface tout le tableau +?> +]]> + </programlisting> + </example> </para> </sect3> </sect2><!-- end syntax --> @@ -1175,6 +1322,34 @@ Il y a toute une panoplie de fonctions pratiques pour travailler avec les tableau : <link linkend="ref.array">array-functions</link>. </para> + <note> + <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>. + <example> + <title>Manipuler des lments 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 + $a = array(1 => 'un', 3 => 'trois'); + et non pas + $a = array(1 => 'un', 2 =>'trois'); +*/ + +$b = array_values($a); +// Maintenant b est le tableau array(1 => 'un', 2 =>'trois') +?> +]]> + </programlisting> + </example> + </para> + </note> <para> L'élément de langage <link linkend="control-structures.foreach">foreach</link> est spécifiquement dédiée aux tableau : elle permet de passer en @@ -1198,91 +1373,144 @@ </programlisting> </informalexample> Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison - est que PHP réclame une expression entre les crochets (comme - indiqué dans la section sur la - <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). - Cela signifie que vous pouvez écrire quelque chose comme : + 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 + constantes qui, malheureusement pour votre code, auront ce nom. Actuellement, + cela fonctionne car la constante indfinie est transforme en chane ayant la + mme valeur. + </para> + <para> + D'autres exemples : + <example> + <title>Exemples de conflits de constantes indfinies</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$arr = array('fruit' => 'pomme', 'lgume' => 'carotte'); + +// Correct +print $arr['fruit']; // pomme +print $arr['lgume']; // carotte + +// Incorrect. Cela fonctionne mais PHP affiche une alerte car +// il y a utilisation d'une constante indfinie appele 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'); + +// Notez la diffrence +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 +print "Bonjour $arr[fruit]"; // Bonjour pomme + +// A une exception, les accolades entourant un tableau dans une chane +// 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 +print "Bonjour $arr['fruit']"; +print "Bonjour $_GET['foo']"; + +// La concatenation est une alternative +print "Bonjour " . $arr['fruit']; // Bonjour pomme +?> +]]> + </programlisting> + </example> + </para> + <para> + 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> + est trop faible pour les afficher. + </para> + <para> + 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 : <informalexample> <programlisting role="php"> <![CDATA[ <?php - echo $arr[ foo(true) ]; +echo $arr[somefunc($bar)]; ?> ]]> </programlisting> </informalexample> - Ceci est un exemple d'utilisation de retour de fonction dans un - index de tableau. PHP reconnait aussi les constantes, et vous - pouvez avoir déjà rencontré <literal>E_*</literal>. + Ceci est un exemple d'utilisation de retour de fonction comme + index de tableau. &php; reconnait aussi les constantes, comme + par exemple la famille des <literal>E_*</literal>. <informalexample> <programlisting role="php"> <![CDATA[ <?php - $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; - $error_descriptions[E_WARNING] = "PHP a généré une alerte"; - $error_descriptions[E_NOTICE] = "Ceci est juste une note grâcieuse"; +$error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; +$error_descriptions[E_WARNING] = "PHP met une alerte"; +$error_descriptions[E_NOTICE] = "Ceci est juste une alerte informationnelle"; ?> ]]> </programlisting> </informalexample> - Notez que <literal>E_ERROR</literal> est aussi un identifiant - vlaide, tout comme <literal>bar</literal> dans le premier exemple. - Mais le dernier exemple revient à écrire : + 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 : <informalexample> <programlisting role="php"> <![CDATA[ <?php - $error_descriptions[1] = "Une erreur fatale est survenue"; - $error_descriptions[2] = "PHP a généré une alerte"; - $error_descriptions[8] = "Ceci est juste une note grâcieuse"; +$error_descriptions[1] = "Une erreur fatale est survenue"; +$error_descriptions[2] = "PHP met une alerte"; +$error_descriptions[8] = "Ceci est juste une alerte informationnelle"; ?> ]]> </programlisting> </informalexample> - car <literal>E_ERROR</literal> égale <literal>1</literal>, etc. + car <literal>E_ERROR</literal> vaut <literal>1</literal>, etc... </para> <para> - Alors, comment se fait-t-il que <literal>$foo[bar]</literal> fonctionne? - C'est parce que <literal>bar</literal> est considéré comme une - constante. Cependant, dans ce cas, aucune constante n'a pour nom - <literal>bar</literal>. PHP suppose alors que vous voulez dire - <literal>bar</literal> littéralement, c'est-à-dire la - chaîne <literal>"bar"</literal>, mais que vous avez oublié les - guillements. + Comme nous l'avons dj expliqu dans les exemple ci-dessus, + <literal>$foo[bar]</literal> fonctionne mais est dangereux. + 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 + guillemets. </para> + <sect4> + <title>Pourquoi est-ce aussi dangereux?</title> <para> - Dans le futur, l'équipe de développement peut vouloir ajouter une - nouvelle constante et vous vous retrouverez dans la panade. Par - exemple, vous ne pouvez déjà pas utiliser les constantes - <literal>empty</literal> et <literal>default</literal>, car ce - sont des mots reservés. - <!-- <jeroen>hmm... i'm doubting this myself. Finish it if you like</jeroen> - But probably - the most threatening - thing is yourself, or whoever will maintain the script. You'll - maybe get very strange behaviour, and - --> - </para> - <para> - Et, pour en mettre une autre couche, cette syntaxe est tout simplement - obsolète, et risque de ne plus fonctionner du tout un jour ou l'autre. + 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, + 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>. </para> <note> <simpara> - Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> - avec <literal>E_ALL</literal>, PHP générera des notes à chaque fois que cette - syntaxe est utilisée. Essayez donc <literal>error_reporting(E_ALL);</literal> - dans vos scripts, pour voir). + Pour insister, l'intrieur 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>. </simpara> </note> - <note> - <simpara> - Dans une chaîne à guillements doubles, une autre syntaxe est - valide. Voyez la section sur - <link linkend="language.types.string.parsing">Traitement des variables - dans les chaînes</link> pour plus de détails. - </simpara> - </note> + </sect4> </sect3> </sect2> <sect2 id="language.types.array.casting"> @@ -1365,13 +1593,6 @@ , '02' => 77 // clé = '02' , 0 => 12 // la valeur de la clé 10 sera remplacée par 12 ); -<!-- TODO example of -- mixed keys -- overwriting keys -- integer keys as string -- using vars/functions as key/values -- mixed skipping ---> // empty array $empty = array(); ?> @@ -1459,7 +1680,7 @@ <programlisting role="php"> <![CDATA[ <?php -// remplis un tableau avec les noms de fichiers d'un dossier +// remplit un tableau avec les noms de fichiers d'un dossier $handle = opendir('.'); while ( $file = readdir($handle) ){ $files[] = $file; @@ -1495,41 +1716,30 @@ <programlisting role="php"> <![CDATA[ <?php - $fruits = array ( "fruits" => array ( "a" => "orange" - , "b" => "banane" - , "c" => "pomme" - ) - , "nombres" => array ( 1 - , 2 - , 3 - , 4 - , 5 - , 6 - ) - , "trous" => array ( "premier" - , 5 => "second" - , "troisième" - ) - ); -<!-- quite duplicate... -$a = array( - "apple" => array( - "color" => "red", - "taste" => "sweet", - "shape" => "round" - ), - "orange" => array( - "color" => "orange", - "taste" => "tart", - "shape" => "round" - ), - "banana" => array( - "color" => "yellow", - "taste" => "paste-y", - "shape" => "banana-shaped" - ) -); ---> +$fruits = array ( "fruits" => array ( "a" => "orange", + "b" => "banane", + "c" => "pomme" + ), + "nombre" => array ( 1, + 2, + 3, + 4, + 5, + 6, + ), + "trou" => array ( "premier", + 5 => "second", + "troisime" + ) + ); + +// Exemples d'utilisations des tableaux ci-dessus +echo $fruits["trou"][5]; // affiche "second" +echo $fruits["fruits"]["a"]; // affiche "orange" +unset($fruits["trou"][0]); // supprime "premier" + +// Crer un tableau multidimensionnel +$juices["pomme"]["vert"] = "bon"; ?> ]]> </programlisting> @@ -1547,13 +1757,16 @@ <programlisting role="php"> <![CDATA[ <?php - class foo { - function faire_foo () { - echo "Faisant foo."; +class foo +{ + function faire_foo() + { + echo "Faisant foo."; } - } - $bar = new foo; - $bar->faire_foo(); +} + +$bar = new foo; +$bar->faire_foo(); ?> ]]> </programlisting> @@ -1831,27 +2044,14 @@ <para> Le comportement de la conversion automatique est actuellement indéfinie. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $a = 1; // $a est un entier - $a[0] = "f"; // $a devient un tableau, et $a[0] contient "f" -?> -]]> - </programlisting> - </informalexample> </para> <para> - Bien que dans l'exemple ci-dessus, il semble évident que - $a va devenir un tableau, dont le premier élément - est 'f', considérez l'exemple suivant : <informalexample> <programlisting role="php"> <![CDATA[ <?php - $a = "1"; // $a est une chaîne - $a[0] = "f"; // Qu'est ce qu'une position dans une chaîne ? que se passe t il? +$a = "1"; // $a est une chane +$a[0] = "f"; // Mais que sont les index de chane? ?> ]]> </programlisting> @@ -1866,11 +2066,25 @@ caractères $a? </para> <para> - Pour cette raison, aussi bien pour PHP 3.0.12 que PHP 4.0b3-RC4, - le résultat de la conversion automatique est - considéré comme indéfinie. Des solutions - sont en cours de discussion. - </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 + ci-dessous : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$a = "abc"; // $a est une chane +$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. + </para> </note> <sect2 id="language.types.typecasting"> <title>Transtypage</title> @@ -1928,103 +2142,71 @@ </programlisting> </informalexample> </para> + <note> + <para> + Au lieu de transtyper une variable en chane, vous pouvez aussi + l'insrer 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 + +// Ceci affiche : "Identique" +if ($fst === $str) { + echo "Identique"; +} +?> +]]> + </programlisting> + </informalexample> + </para> + </note> <para> Le transtypage n'a pas toujours de résultat prévisible. Pour plus d'informations, voyez : - </para> <itemizedlist> <listitem> - <simpara> - <link linkend="language.types.boolean.casting">Conversion en booléen</link> - </simpara> + <simpara><link linkend="language.types.boolean.casting">Conversion en + boolen</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.integer.casting">Conversion en entier</link> - </simpara> + <simpara><link linkend="language.types.integer.casting">Conversion en + entier</link></simpara> </listitem> - <!-- don't exist yet <listitem> - <simpara> - <link linkend="language.types.float.casting">Conversion en nombre à - virgule flottante</link> - </simpara> + <simpara><link linkend="language.types.float.casting">Conversion en + nombre virgule flottante</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.string.casting">Conversion en - chaîne de caractères</link> - </simpara> + <simpara><link linkend="language.types.string.casting">Conversion en + chane de caractres</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.array.casting">Conversion en tableau</link> - </simpara> + <simpara><link linkend="language.types.array.casting">Conversion en + tableau</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.object.casting">Conversion en objet</link> - </simpara> + <simpara><link linkend="language.types.object.casting">Conversion en + objet</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.resource.casting">Conversion en ressource</link> - </simpara> + <simpara><link linkend="language.types.resource.casting">Conversion en + ressource</link></simpara> </listitem> + <!-- don't exist yet <listitem> - <simpara> - <link linkend="language.types.null.casting">Conversion en NULL</link> - </simpara> + <simpara><link linkend="language.types.null.casting">Conversion en + &null;</link></simpara> </listitem> --> </itemizedlist> - <warning> - <simpara> - Pour transformer facilement une variable en chaîne, - entourez la simplement de guillements doubles. - </simpara> - </warning> - <para> - Lors de la conversion d'un tableau en chaîne, le résultat sera - le mot <literal>Array</literal> (tableau, en anglais). Lors de la - conversion d'un objet en chaîne, le résultat sera le mot - <literal>Object</literal> (objet, en anglais). Dans les deux cas, - une alerte sera affichée. - </para> - <para> - Lorsque vous transtypez un scalaire ou une chaîne en tableau, - la variable verra son contenu affecté au premier - élément du tableau. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $var = 'ciao'; - $arr = (array) $var; - echo $arr[0]; // affiche 'ciao' -?> -]]> - </programlisting> - </informalexample> - </para> - <para> - Lorsque vous transtypez un scalaire ou une chaîne en objet, - la valeur de la variable sera transformée en attribut de - l'objet. L'attribut s'appellera 'scalar': - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $var = 'ciao'; - $obj = (object) $var; - echo $obj->scalar; // affiche 'ciao' -?> -]]> - </programlisting> - </informalexample> </para> </sect2> </sect1> + </chapter> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.35 phpdoc-fr/language/variables.xml:1.36 --- phpdoc-fr/language/variables.xml:1.35 Mon Feb 3 07:49:41 2003 +++ phpdoc-fr/language/variables.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.35 $ --> +<!-- $Revision: 1.36 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -103,6 +103,37 @@ </programlisting> </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 + <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> + <programlisting role="php"> +<![CDATA[ +<?php +$i = 'W'; +for($n=0; $n<6; $n++) + echo ++$i . "\n"; + +/* + Affiche ceci : + +X +Y +Z +AA +AB +AC + +*/ +?> +]]> + </programlisting> + </example> + </para> </sect1> <sect1 id="language.variables.predefined"> <title>Variables prédéfinies</title> @@ -117,22 +148,29 @@ </simpara> <warning> <simpara> - En &php; 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont - disponibles dans l'environnement global a changé. Les variables - d'entrées et de serveurs ne sont plus <emphasis>par défaut</emphasis> - placées dans le contexte d'exécution global. Elles sont placées dans - les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. + Depuis la version &php; 4.2.0, la valeur par dfaut 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 + <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> + dans l'URL <literal>http://www.example.com/test.php?id=3</literal> au lieu + de <varname>$id</varname>, ou encore <varname>$_ENV['HOME']</varname> au lieu de + <varname>$HOME</varname>. </simpara> <simpara> - Vous pouvez toujours forcer l'ancien comportement de &php; en le configurant - avec <link linkend="ini.register-globals">register_globals</link> à - <literal>On</literal> votre fichier &php.ini;. + Pour des informations lies 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>, + 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> - Pour plus d'informations et d'explications sur ce changement, voyez - <ulink url="&url.php.release4.1.0;">l'annonce de &php; 4.1.0</ulink> - et and <ulink url="&url.php.release4.2.0;">l'annonce de &php; 4.2.0</ulink> - (en anglais). + L'utilisation des variables prdfinies de &php;, comme les + <link linkend="language.variables.superglobals">tableaux superglobaux</link>, + est recommand. </simpara> </warning> <simpara> @@ -148,7 +186,22 @@ 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 + (<varname>$HTTP_*_VARS</varname>) existent toujours. </simpara> + + <note> + <title>Variables variables</title> + <para> + Les superglobales ne peuvent pas tre utilises 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. + </para> <variablelist id="language.variables.superglobals"> <title>Tableaux superglobaux de &php;</title> @@ -362,8 +415,35 @@ <simpara> Le tableau $GLOBALS est un tableau associatif avec le nom des variables globales comme clef et les valeurs des éléments - du tableau comme valeur des variables. + du tableau comme valeur des variables. Notez que <varname>$GLOBALS</varname> + existe dans tous les contextes, car <varname>$GLOBALS</varname> est un + <link linkend="language.variables.superglobals">superglobal</link>. + Voici un exemple des super globaux : </simpara> + <para> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?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. + 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 + // depuis PHP 4.1.0 + print $_POST['name']; +} +?> +]]> + </programlisting> + </informalexample> + </para> <simpara> Une autre caractéristique importante de la portée des variables est la notion de variable <emphasis>static</emphasis>. Une variable statique a @@ -441,6 +521,113 @@ </programlisting> </informalexample> + <simpara> + Le Zend Engine 1, sur qui repose <literal>PHP4</literal>, implmente 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 : + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function test_global_ref() { + global $obj; + $obj = &new stdclass; +} + +function test_global_noref() { + global $obj; + $obj = new stdclass; +} + +test_global_ref(); +var_dump($obj); +test_global_noref(); +var_dump($obj); +?> +]]> + </programlisting> + </informalexample> + + <simpara> + Excuter cet exemple vous donnera : + </simpara> + + <screen> +NULL +object(stdClass)(0) { +} + </screen> + + <simpara> + Un comportement similaire s'applique la commande <literal>static</literal>. + Les rfrences ne sont pas stockes dynamiquement : + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function &get_instance_ref() { + static $obj; + + echo "Objet statique : "; + var_dump($obj); + if (!isset($obj)) { + // Assigne une rfrence une variable statique + $obj = &new stdclass; + } + $obj->property++; + return $obj; +} + +function &get_instance_noref() { + static $obj; + + echo "Objet statique : "; + var_dump($obj); + if (!isset($obj)) { + // Assigne une objet une variable statique + $obj = new stdclass; + } + $obj->property++; + return $obj; +} + +$obj1 = get_instance_ref(); +$still_obj1 = get_instance_ref(); +echo "\n"; +$obj2 = get_instance_noref(); +$still_obj2 = get_instance_noref(); +?> +]]> + </programlisting> + </informalexample> + + <simpara> + Excuter cet exemple vous donnera : + </simpara> + + <screen> +Objet statique : NULL +Objet statique : NULL + +Objet statique : NULL +Objet statique : object(stdClass)(1) { + ["property"]=> + int(1) +} + </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 + <literal>&get_instance_ref()</literal> une seconde fois. + </simpara> </sect1> <sect1 id="language.variables.variable"> <title>Les variables dynamiques</title> @@ -533,97 +720,161 @@ <programlisting role="html"> <![CDATA[ <form action="foo.php" method="post"> - Nom: <input type="text" name="nom"><BR> - <input type="submit"> + Name: <input type="text" name="username"><br> + Email: <input type="text" name="email"><br> + <input type="submit" name="submit" value="Submit me!"> </form> ]]> </programlisting> </example> </para> - <simpara> - Lorsque ce formulaire est envoyé, le &php; va créer la variable - <computeroutput>$nom</computeroutput>, qui contiendra la valeur - que vous avez entrée dans le champs <emphasis>Nom:</emphasis> - du formulaire. - </simpara> + + <para> + Suivant votre configuration particulier et vos prfrences, + vous avez plusieurs mthodes pour accder aux variables du formulaires. + Voici quelques exemples : + </para> + + <para> + <example> + <title>Accder simplement des variables de formulaires POST</title> + <programlisting role="html"> +<![CDATA[ +<?php +// Disponibles depuis &php; 4.1.0 + + print $_POST['username']; + print $_REQUEST['username']; + + import_request_variables('p', 'p_'); + print $p_username; + +// Disponibles depuis PHP 3. + + 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. + + print $username; +?> +]]> + </programlisting> + </example> + </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 + 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>. + Voyez aussi <link linkend="reserved.variables.request">$_REQUEST</link> et + <function>import_request_variables</function>. + </para> + + <note> + <para> + <link linkend="language.variables.superglobals">Les tableaux superglobaux</link>, + comme <varname>$_POST</varname> et <varname>$_GET</varname>, sont disponibles + depuis PHP 4.1.0 + </para> + </note> + + <para> + As shown, before PHP 4.2.0 the default value for <link + linkend="ini.register-globals">register_globals</link> + was <emphasis>on</emphasis>. And, in PHP 3 it was always on. The PHP + community is encouraging all to not rely on this directive + as it's preferred to assume it's <emphasis>off</emphasis> and code + accordingly. + </para> + <note> <para> - La directive de configuration <link - linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> affecte les valeurs - issues des méthodes GET et POST ainsi aue des Cookies. Si cette - directive est active, une valeur telle que <literal>It's "PHP!"</literal> - sera automagiquement transformée en <literal>It\'s - \"PHP!\"</literal>. - L'échappement est nécessaire pour les insertions en base de - données. Voyez <function>addslashes</function>, - <function>stripslashes</function> et + 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. + Voyez aussi les fonctions <function>addslashes</function>, + <function>stripslashes</function> et <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>. </para> </note> + <simpara> - Le &php; permet aussi l'utilisation des tableaux dans le contexte de - formulaire, mais seulement des tableaux à une seule dimension. Comme - cela, vous pouvez rassembler des variables ou utiliser cette - fonctionnalité pour récupérer les valeurs d'un choix - multiple : + &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, + et les affiche : </simpara> + <para> <example> - <title>Variables complexes de formulaire</title> - <programlisting role="html"> + <title>Variables de formulaires complexes</title> + <programlisting role="php"> <![CDATA[ -<form action="array.php" method="post"> - Name: <input type="text" name="personal[name]"><br> +<?php +if ($HTTP_POST_VARS['action'] == 'submitted') { + print '<pre>'; + + print_r($HTTP_POST_VARS); + print '<a href="'. $HTTP_SERVER_VARS['PHP_SELF'] .'">Essayez nouveau</a>'; + + print '</pre>'; +} else { +?> +<form action="<?php echo $HTTP_SERVER_VARS['PHP_SELF']; ?>" method="post"> + Name: <input type="text" name="personal[name]"><br> Email: <input type="text" name="personal[email]"><br> Beer: <br> <select multiple name="vin[]"> - <option value="medoc">Médoc - <option value="chablis">Chablis - <option value="riesling">Riesling - </select> - <input type="submit"> + <option value="bordeaux">bordeaux</option> + <option value="beaujolais">beaujolais</option> + <option value="loire">loire</option> + </select><br> + <input type="hidden" name="action" value="submitted"> + <input type="submit" name="submit" value="submit me!"> </form> +<?php +} +?> ]]> </programlisting> </example> </para> - <simpara> - Si l'option "track_vars" est activée, soit par l'option de - compilation - <link linkend="ini.track-vars">track_vars</link>, soit par la directive de - configuration <computeroutput> -<![CDATA[ - <? php_track_vars ?> -]]> -</computeroutput>, - les variables transmises par les méthodes POST et GET - pourront aussi être trouvées dans le tableau - associatif global $HTTP_POST_VARS ou $HTTP_GET_VARS - suivant la méthode utlisée. - </simpara> + + <para> + En PHP 3, la syntaxe de tableau HTML est limite aux tableaux + uni-dimensionnels. En PHP 4, ces limitations ont t leves. + </para> + <sect3 id="language.variables.external.form.submit"> - <title>Bouton "submit" sous forme d'image</title> + <title>Nom de variables IMAGE SUBMIT</title> + <simpara> - Lorsque vous envoyez le résultat d'un formulaire, vous - pouvez utiliser une image au lieu du bouton "submit" standard - en utilisant un tag : + Lors de la soumission d'un formulaire, il est possible d'utiliser + une image au lieu d'un bouton standard, comme ceci : </simpara> + <informalexample> <programlisting role="html"> <![CDATA[ - <input type=image src="image.gif" name="sub"> +<input type="image" src="image.gif" name="sub"> ]]> </programlisting> </informalexample> + <simpara> - Lorsqu'un utilisateur clique sur l'image, le formulaire sera - transmis au serveur avec deux variables de plus, sub_x et - sub_y. Ces deux variables contiennent les coordonnées - de l'endroit où l'utilisateur à cliqué. Les - utilisateurs expérimentés remarqueront que les noms - de variables sont transmis avec une virgule à la place du - caractère "_", mais &php; fait la conversion - automatiquement. + Lorque l'utilisateur clique sur cette image, le formulaire + associ est envoy au serveur, avec deux donnes supplmentaires, + <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. </simpara> </sect3> </sect2>
Index: phpdoc-fr/language/control-structures.xml diff -u phpdoc-fr/language/control-structures.xml:1.19 phpdoc-fr/language/control-structures.xml:1.20 --- phpdoc-fr/language/control-structures.xml:1.19 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/control-structures.xml Tue Feb 4 12:47:00 2003 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="control-structures"> <title>Les structures de contrôle</title> <simpara> - Tous les scripts PHP sont une suite d'instructions. Une instruction + Tous les scripts &php; sont une suite d'instructions. Une instruction peut être une assignation, un appel de fonction, une instruction conditionnelle ou bien une instruction qui ne fait rien (une instruction vide). Une instruction se termine habituellement par un point virgule @@ -17,10 +17,10 @@ <title><literal>if</literal></title> <para> L'instruction <literal>if</literal> est une des plus importantes - instructions de tous les langages, PHP inclus. Elle permet + instructions de tous les langages, &php; inclus. Elle permet l'exécution conditionnelle d'une partie de code. Les fonctionnalités de l'instruction <literal>if</literal> - sont les mêmes en PHP qu'en C : + sont les mêmes en &php; qu'en C : <informalexample> <programlisting role="php"> <![CDATA[ @@ -37,7 +37,7 @@ <link linkend="language.expressions">expressions</link>, <replaceable>expr</replaceable> est convertie en sa valeur booléenne. Si l'expression <replaceable>expr</replaceable> vaut - &true;, PHP exécutera l'instruction et si elle + &true;, &php; exécutera l'instruction et si elle vaut &false;, l'instruction sera ignorée. Plus de détails sur les vlaeurs qui valent &false; est disponbile dans la section @@ -156,7 +156,7 @@ Vous pouvez avoir plusieurs <literal>elseif</literal> qui se suivent les uns après les autres, après un <literal>if</literal> initial. Le premier <literal>elseif</literal> qui sera évalué - à &true; sera exécuté. En PHP, vous + à &true; sera exécuté. En &php;, vous pouvez aussi écrire "else if" en deux mots et son comportement sera identique à la version en un seul mot. La sémantique des deux expression est légèrement différente, mais au bout du compte, @@ -174,7 +174,7 @@ <sect1 id="control-structures.alternative-syntax"> <title>Syntaxe alternative</title> <para> - Le PHP propose une autre manière de rassembler des + &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>, @@ -233,7 +233,7 @@ <title><literal>while</literal></title> <para> La boucle <literal>while</literal> est le moyen le plus - simple d'implémenter une boucle en PHP. Cette boucle + simple d'implémenter une boucle en &php;. Cette boucle se comporte de la même manière qu'en C. L'exemple le plus simple d'une boucle <literal>while</literal> est le suivant : @@ -249,14 +249,14 @@ </para> <simpara> La signification d'une boucle <literal>while</literal> est - très simple. Le PHP exécute l'instruction tant + très simple. PHP exécute l'instruction tant que l'expression de la boucle <literal>while</literal> est évaluée comme &true;. La valeur de l'expression est vérifiée à chaque début de boucle, et, si la valeur change durant l'exécution de l'instruction, l'exécution ne s'arrêtera qu'à la fin de l'itération - (chaque fois que le PHP exécute l'instruction, on appelle + (chaque fois que &php; exécute l'instruction, on appelle cela une itération). De temps en temps, si l'expression du <literal>while</literal> est &false; avant la première itération, l'instruction ne sera jamais @@ -378,7 +378,7 @@ <sect1 id="control-structures.for"> <title><literal>for</literal></title> <para> - Les boucles <literal>for</literal> sont les boucles les plus complexes en PHP. + Les boucles <literal>for</literal> sont les boucles les plus complexes en &php;. Elles fonctionnent comme les boucles <literal>for</literal> du langage C. La syntaxe des boucles for est la suivante: <informalexample> @@ -413,7 +413,7 @@ 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 &true;, + (&php; considère implicitement qu'elle vaut &true;, 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>. @@ -459,7 +459,7 @@ boucle <literal>for</literal> peut être utile parfois. </simpara> <para> - PHP supporte aussi la syntaxe alternative suivante pour les boucles + &php; supporte aussi la syntaxe alternative suivante pour les boucles <literal>for</literal> : <informalexample> <programlisting role="php"> @@ -473,9 +473,9 @@ </para> <para> Les autres langages ont l'instruction <literal>foreach</literal> - pour accéder aux éléments d'un tableau. PHP 3 - ne dispose pas d'une telle fonction; PHP 4 en dispose (voir - <link linkend="control-structures.foreach">foreach</link>). En PHP 3, + pour accéder aux éléments d'un tableau. &php; 3 + ne dispose pas d'une telle fonction; &php; 4 en dispose (voir + <link linkend="control-structures.foreach">foreach</link>). En &php; 3, vous pouvez combiner <link linkend="control-structures.while">while</link> avec <function>list</function> et <function>each</function> pour obtenir le même résultat. Reportez-vous aux exemples @@ -485,7 +485,7 @@ <sect1 id="control-structures.foreach"> <title><literal>foreach</literal></title> <para> - PHP 4 (mais pas PHP 3) inclut une commande <literal>foreach</literal>, + &php; 4 (mais pas &php; 3) inclut une commande <literal>foreach</literal>, comme en Perl ou d'autres langages. C'est un moyen simple de passer en revue un tableau. Il y a deux syntaxes possibles : la seconde est une extension mineure mais pratique de la première: @@ -653,27 +653,30 @@ <programlisting role="php"> <![CDATA[ <?php -$i = 0; -while ($i < 10) { - if ($arr[$i] == "stop") { - break; /* Vous pouvez aussi écrire 'break 1;' ici. */ +$arr = array ('un', 'deux', 'trois', 'quatre', 'stop', 'cinq'); +while (list (, $val) = each ($arr)) { + if ($val == 'stop') { + break; /* Vous pourriez aussi utiliser 'break 1;' ici. */ } - $i++; + echo "$val<br>\n"; } + /* Utilisation de l'argument optionnel. */ + $i = 0; -while ( ++$i ) { - switch ( $i ) { +while (++$i) { + switch ($i) { case 5: - echo "à 5<br>\n"; - break 1; /* Ne sort que du switch. */ + echo "A 5<br>\n"; + break 1; /* Termine uniquement le switch. */ case 10: - echo "à 10; quitting<br>\n"; - break 2; /* Sort du switch et du while. */ + echo "At 10; quitting<br>\n"; + break 2; /* Termine le switch et la buocle while. */ default: break; } } + ?> ]]> </programlisting> @@ -777,13 +780,13 @@ est exécutée ligne par ligne. Au début, aucun code n'est exécuté. Seulement lorsqu'un <literal>case</literal> est vérifié, - PHP exécute alors les instructions correspondantes. - PHP continue d'exécuter les instructions jusqu'à + &php; exécute alors les instructions correspondantes. + &php; continue d'exécuter les instructions jusqu'à la fin du bloc d'instructions du <literal>switch</literal>, ou bien dès qu'il trouve l'instruction <literal>break</literal>. Si vous ne pouvez pas utiliser l'instruction <literal>break</literal> à la fin de l'instruction - <literal>case</literal>, PHP continuera à exécuter + <literal>case</literal>, &php; continuera à exécuter toutes les instructions qui suivent. Par exemple : <informalexample> <programlisting role="php"> @@ -803,9 +806,9 @@ </informalexample> </para> <simpara> - Dans cet exemple, si $i est égal à 0, PHP va + Dans cet exemple, si $i est égal à 0, &php; va exécuter quand même toutes les instructions qui - suivent. Si $i est égal à 1, PHP exécutera + suivent. Si $i est égal à 1, &php; exécutera les deux dernières instructions. Et seulement si $i est égal à 2, vous obtiendrez le résultat escompté, c'est-à-dire, l'affiche de @@ -825,7 +828,7 @@ </simpara> <para> La liste de commandes d'un <literal>case</literal> peut - être vide, auquel cas PHP utilisera la liste de + être vide, auquel cas &php; utilisera la liste de commandes du cas suivant. <informalexample> <programlisting role="php"> @@ -953,7 +956,7 @@ </para> <para> <example> - <title>Profile a section of PHP code</title> + <title>Profiler une section de code &php;</title> <programlisting role="php"> <![CDATA[ <?php @@ -988,7 +991,7 @@ ]]> </programlisting> </example> - Cet exemple profile le code PHP dans le bloc de déclaration, + Cet exemple profile le code &php; dans le bloc de déclaration, et enregistre l'heure de chaque commande bas niveau. Cette information peut être réutilisée pour débusquer les segments de code lents. Vous pouvez implémenter d'autres méthodes, mais @@ -997,7 +1000,7 @@ <simpara> Les ticks sont bien pratiques pour débugger, implémenter un multi-tâches simple, des entrées sorties en tâche de - fond, ou bien d'autres choses, avec PHP. + fond, ou bien d'autres choses, avec &php;. </simpara> <simpara> Voir aussi @@ -1044,7 +1047,7 @@ <title><function>require</function></title> <simpara> <function>require</function> inclut et exécute un - fichier PHP. + fichier &php;. </simpara> <simpara> La commande <function>require</function> se remplace elle-même @@ -1072,12 +1075,11 @@ <programlisting role="php"> <![CDATA[ <?php - require ("file.inc?varone=1&vartwo=2"); -/* Ne fonctionne pas. */ - $varone = 1; - $vartwo = 2; - require ("file.inc"); -/* $varone et $vartwo seront accessibles à file.inc */ + require 'prepend.php'; + + require $somefile; + + require ('unfichier.txt'); ?> ]]> </programlisting> @@ -1089,7 +1091,7 @@ </simpara> <note> <simpara> - Avant PHP 4.0.2, ceci s'appliquait : <function>require</function> tentait + Avant &php; 4.0.2, ceci s'appliquait : <function>require</function> tentait de lire le fichier cible, même si les lignes n'étaient pas utilisées. Une condition if n'avait aucun effet sur <function>require</function>. Cependant, si la ligne du <function>require</function> n'est jamais utilisée, @@ -1210,7 +1212,7 @@ parent ne sera pas interrompue. Pour cette raison, le code qui est dans le fichier doit être placé entre <link linkend="language.basic-syntax.phpmode">les balises - habituelles de PHP</link>. + habituelles de &php;</link>. </simpara> <simpara> Si les "<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>" @@ -1219,7 +1221,7 @@ bien avec un gestionnaire adapté : voir <xref linkend="wrappers"/> pour une liste des protocoles), au lieu d'un simple chemin local. Si le serveur distant interprête le fichier comme du code - PHP, des variables peuvent être transmises au serveur distant + &php;, des variables peuvent être transmises au serveur distant via l'URL et la méthode GET. Ce n'est pas, à strictement parler, la même chose que d'hériter du contexte de variable. Le fichier inclus est en fait un script exécuté à distance, @@ -1304,7 +1306,7 @@ </simpara> <note> <simpara> - En PHP 3, le retourn n'est pas utilisable à moins que ce + En &php; 3, le retourn n'est pas utilisable à moins que ce ne soit dans un bloc de fonction, auquel cas le <function>return</function> s'applique à une fonction et non pas au fichier. @@ -1394,11 +1396,11 @@ Pour des exemples avec <function>require_once</function> et <function>include_once</function>, reportez-vous au code <ulink url="&url.php.pear;">PEAR</ulink> inclut dans les - dernières distributions PHP. + dernières distributions &php;. </para> <note> <para> - <function>require_once</function> a été ajouté en PHP 4.0.1pl2 + <function>require_once</function> a été ajouté en &php; 4.0.1pl2 </para> </note> <note> @@ -1440,9 +1442,7 @@ sera pas une seconde fois. </para> <para> - Comme précisé dans la section - <function>require_once</function>, la fonction - <function>include_once</function> est utilisée de + La fonction <function>include_once</function> est utilisée de préférence lorsque le fichier doit être inclus ou évalué plusieurs fois dans un script, ou bien lorsque vous voulez être sûr qu'il ne sera inclus @@ -1450,16 +1450,41 @@ de fonction. </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> + <note> + <para> + <function>include_once</function> a été ajouté en &php; 4.0.1pl2 + </para> + </note> + <note> + <para> + Attention, <function>include_once</function> et + <function>include_once</function> sont sensibles à la casse + sous Windows. + <example> + <title><function>include_once</function> est sensible à la casse</title> + <programlisting role="php"> +<![CDATA[ +include_once("a.php"); // ceci inclut le fichier a.php +include_once("A.php"); // ceci inclut encore le fichier a.php sous Windows! +]]> + </programlisting> + </example> + </para> + </note> + &warn.no-win32-fopen-wrapper; <para> - Voir aussi: <function>require</function>, - <function>include</function>, <function>require_once</function>, + Voir aussi + <function>require</function>, + <function>include</function>, + <function>require_once</function>, <function>get_required_files</function>, - <function>get_included_files</function>, <function>readfile</function>, - et <function>virtual</function>. + <function>get_included_files</function>, + <function>readfile</function> et + <function>virtual</function>. </para> </sect1> </chapter> Index: phpdoc-fr/language/functions.xml diff -u phpdoc-fr/language/functions.xml:1.12 phpdoc-fr/language/functions.xml:1.13 --- phpdoc-fr/language/functions.xml:1.12 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/functions.xml Tue Feb 4 12:47:00 2003 @@ -1,12 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <chapter id="functions"> <title>Les fonctions</title> <sect1 id="functions.user-defined"> - <title>Les fonctions utilisateur</title> + <title>Les fonctions</title> <para> Une fonction peut être définie en utilisant la syntaxe suivante : - <informalexample> + <example> + <title>Dfinition d'une fonction</title> <programlisting role="php"> <![CDATA[ <?php @@ -17,7 +18,7 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> Tout code PHP, correct syntaxiquement, peut apparaître @@ -28,6 +29,74 @@ 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> + <para> + Lorsqu'une fonction est dfinie de manire conditionnelle, comme dans + les exemples ci-dessous, leur dfinition doit <emphasis>prcder</emphasis> + leur utilisation. + <example> + <title>Fonctions conditionnelles</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$makefoo = true; + +/* Impossible d'appeler foo() ici, + car cette fonction n'existe pas. + Mais nous pouvons utiliser bar() */ + +bar(); + +if ($makefoo) { + function foo () + { + echo "Je n'existe pas tant que le programme n'est pas pass ici.\n"; + } +} + +/* Maitenant, nous pouvons appeler foo() + car $makefoo est maintenant vrai */ + +if ($makefoo) foo(); + +function bar() { +{ + echo "J'existe ds de dbut du programme.\n"; +} + +?> +]]> + </programlisting> + </example> + <example> + <title>Fonctions dans une autre fonctions</title> + <programlisting role="php"> +<![CDATA[ +<?php +function foo() +{ + function bar() + { + echo "Je n'existe pas tant que foo() n'est pas appel.\n"; + } +} + +/* Impossible d'appeler bar() ici + car il n'existe pas. */ + +foo(); + +/* Maintenant, nous pouvons appeler bar(), + car l'utilisation de foo() l'a rendu + accessible. */ + +bar(); + +?> +]]> + </programlisting> + </example> + </para> <simpara> PHP ne supporte pas le surchargement de fonction, ni la destruction ou la redéfinition de fonctions déjà déclarées. @@ -93,7 +162,7 @@ <programlisting role="php"> <![CDATA[ <?php -function add_some_extra(&$string) { +function add_some_extra(&$string) { $string .= ', et un peu plus.'; } $str = 'Ceci est une chaîne'; @@ -119,7 +188,7 @@ $str = Ceci est une chaîne'; foo ($str); echo $str; // affiche 'Ceci est une chaîne' -foo (&$str); +foo (&$str); echo $str; // affiche 'Ceci est une chaîne, et un peu plus.' ?> ]]> @@ -268,10 +337,10 @@ <programlisting role="php"> <![CDATA[ <?php -function &retourne_reference() { +function &retourne_reference() { return $uneref; } -$newref =&retourne_reference(); +$newref =& retourne_reference(); ?> ]]> </programlisting> @@ -326,10 +395,10 @@ <![CDATA[ <?php function foo() { - echo "dans foo()<br>\n"; + echo "dans foo()<br>\n"; } function bar( $arg = '' ) { - echo "Dans bar(); l'argument était '$arg'.<br>\n"; + echo "Dans bar(); l'argument était '$arg'.<br>\n"; } $func = 'foo'; $func(); Index: phpdoc-fr/language/oop.xml diff -u phpdoc-fr/language/oop.xml:1.19 phpdoc-fr/language/oop.xml:1.20 --- phpdoc-fr/language/oop.xml:1.19 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/oop.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="language.oop"> <title>Les classes et les objets</title> <sect1 id="keyword.class"> @@ -668,7 +668,7 @@ crée dans le constructeur crée dans le constructeur crée dans le constructeur */ - $bar2 =&new foo('crée dans le constructeur'); + $bar2 =&new foo('crée dans le constructeur'); $bar2->echoName(); $globalref[1]->echoName(); /* affiche : @@ -747,8 +747,8 @@ } } class b { - function b(&$a) { - $this->a = &$a; + function b(&$a) { + $this->a = &$a; } function echoValue() { echo "<br>","class ",get_class($this),': ',$this->a->value; @@ -757,7 +757,7 @@ // Essayez de comprendre pourquoi une copie simple va // conduire à un résultat indésirable à // la ligne marquée d'une étoile -$a =&new a(10); +$a =&new a(10); $a->createRef(); $a->echoValue(); $a->b->echoValue(); Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.19 phpdoc-fr/language/operators.xml:1.20 --- phpdoc-fr/language/operators.xml:1.19 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/operators.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="language.operators"> <title>Les opérateurs</title> <simpara> @@ -190,7 +190,8 @@ assignée. Par exemple, la valeur de l'expression '$a = 3' est la valeur 3. Cela permet d'utiliser des astuces telles que : - <informalexample> + <example> + <title>Astuce d'assignation</title> <programlisting role="php"> <![CDATA[ <?php @@ -199,7 +200,7 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <para> En plus du simple opérateur d'assignation, il existe des @@ -208,9 +209,10 @@ chaînes de caractères. Cela permet d'utiliser la valeur d'une variable dans une expression et d'affecter le résultat de cette expression à cette variable. - Par exemple: - <informalexample> - <programlisting role="php"> + Par exemple : + <example> + <title>Exemples avec les opérateurs d'assignation</title> + <programlisting role="php"> <![CDATA[ <?php $a = 3; @@ -225,7 +227,7 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <para> On peut noter que l'assignation copie le contenu de la variable originale @@ -247,6 +249,27 @@ Les opérateurs sur les bits vous permettent de manipuler les bits dans un entier. </simpara> + <para> + <example> + <title>Exemples avec les ppérateurs sur les bits</title> + <programlisting role="php"> +<![CDATA[ +<?php + echo 12 ^ 9; +// Affiche '5' + + echo "12" ^ "9"; +// Affiche le caractre d'effacement (ascii 8) +// ('1' (ascii 49)) ^ ('9' (ascii 57)) = #8 + +echo "hallo" ^ "hello"; +// Affiche la valeur asciie : s #0 #4 #0 #0 #0 +// 'a' ^ 'e' = #4 +?> +]]> + </programlisting> + </example> + </para> <table> <title>Les opérateurs sur les bits</title> <tgroup cols="3"> Index: phpdoc-fr/language/types.xml diff -u phpdoc-fr/language/types.xml:1.20 phpdoc-fr/language/types.xml:1.21 --- phpdoc-fr/language/types.xml:1.20 Mon Feb 3 07:27:11 2003 +++ phpdoc-fr/language/types.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <chapter id="language.types"> <title>Les types</title> <sect1 id="language.types.intro"> @@ -70,15 +70,7 @@ C'est un pseudo-type, qui indique que le paramètre peut indifféremment prendre plusieurs types. </simpara> - <!-- - Just an idea, maybe useful for some func-defs? - (at least it is for the operator-defs) - <simpara> - In parameter definitions you can also encouter the 'number' pseudo-type, - that indicates a parameter that is either <type>integer</type> or - <type>float</type>. - </simpara> - --> + </note> <simpara> Habituellement, le type d'une variable n'est pas déclaré @@ -86,6 +78,46 @@ l'exécution par le PHP, en fonction du contexte dans lequel la variable est utilisée. </simpara> + <note> + <simpara> + Si vous voulez vrifier 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 + de certains types, <emphasis>n'utilisez pas</emphasis> <function>gettype</function>, + mais plutt les fonctions <literal>is_<replaceable>type</replaceable></literal>. + Par exemple : + <example> + <title>Exemples de vrification de type de variable</title> + <programlisting role="php"> +<![CDATA[ +<?php +$bool = TRUE; // un boolen +$str = "foo"; // une chane de caractres +$int = 12; // un entier + +echo gettype($bool); // affiche "boolean" +echo gettype($str); // affiche "string" + +// Ceci est un engier, on l'incrmente de 4 +if (is_int($int)) { + $int += 4; +} + +// Si $bool est une chane, l'afficher +// (Ne pas imprimer n'importe quoi). +if (is_string($bool)) { + echo "Chaine : $bool"; +} +?> +]]> + </programlisting> + </example> + </para> + </note> <simpara> Si vous voulez forcer une variable à être convertie en un certain type, vous devez transtyper @@ -116,7 +148,10 @@ <informalexample> <programlisting role="php"> <![CDATA[ -$foo = True; // assign the value TRUE to $foo +<?php + $foo = True; + // assigne la valeur TRUE la variable $foo +?> ]]> </programlisting> </informalexample> @@ -163,7 +198,8 @@ <itemizedlist> <listitem> <simpara> - Le <link linkend="language.types.boolean">booléen</link> FALSE </simpara> + Le <link linkend="language.types.boolean">booléen</link>FALSE + </simpara> </listitem> <listitem> <simpara> @@ -207,8 +243,22 @@ <literal>-1</literal> est considéré comme vrai! </simpara> </warning> - <!-- and/or a few examples, for the people only looking at - the examples... </XXX> --> + <example> + <title>Conversion en boolen</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo gettype((bool) ""); // bool(false) +echo gettype((bool) 1); // bool(true) +echo gettype((bool) -2); // bool(true) +echo gettype((bool) "foo"); // bool(true) +echo gettype((bool) 2.3e5); // bool(true) +echo gettype((bool) array(12)); // bool(true) +echo gettype((bool) array()); // bool(false) +?> +]]> + </programlisting> + </example> </para> </sect2> </sect1> @@ -276,38 +326,34 @@ <para> Si un nombre est hors de l'intervalle de validité des entiers, il sera interprété comme un <type>float</type>. - <informalexample> + <example> + <title>Dépassement de capacité des entiers</title> <programlisting role="php"> <![CDATA[ <?php - $large_number = 2147483647; - var_dump($large_number); +$large_number = 2147483647; +var_dump($large_number); // affiche : int(2147483647) - var_dump( 0x80000000 ); - // affiche : float(2147483648) +$large_number = 2147483648; +var_dump($large_number); +// affiche : float(2147483648) + +// this goes also for hexadecimal specified integers: +var_dump( 0x80000000 ); +// affiche : float(2147483648) -var_dump( 25/7 ); -// affiche : float(3.5714285714286) +$million = 1000000; +$large_number = 50000 * $million; +var_dump($large_number); +// affiche : float(50000000000) ?> ]]> </programlisting> - </informalexample> + </example> De même, si une fonction ou un opérateur retourne un entier qui est hors des limites de validité des entiers, il sera aussi automatiquement converti en <type>float</type>. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $million = 1000000; - $large_number = 50000 * $million; - var_dump($large_number); -// affiche : float(50000000000) -?> -]]> - </programlisting> - </informalexample> </para> <para> En PHP, il n'y a pas de division entière. <literal>1/2</literal> @@ -326,6 +372,29 @@ <literal>-429496728</literal>. </simpara> </warning> + <para> + Il n'existe pas de division entire en PHP. + <literal>1/2</literal> gnrera 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> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(25/7); + // float(3.5714285714286) +var_dump((int) (25/7)); + // int(3) +var_dump(round(25/7)); + // float(4) +?> +]]> + </programlisting> + </example> + </para> </sect2> <sect2 id="language.types.integer.casting"> <title>Conversion en entiers</title> @@ -798,17 +867,39 @@ <example> <title>Utilisation des accolades {} dans les chaînes pour les tableaux</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php - $fruits = array( 'fraise' => 'rouge' , 'banane' => 'jaune' ); - echo "Une banane est $fruits[banane]."; - // OK. Notez toutefois que pour cet exemple, cela fonctionne - // différemment. Voyez <literal>$foo[bar]</literal> hors des chaînes - echo "Ce carré est large de $carre->largeur mètres."; - // OK - echo "Ce carré est large de $carre->largeur00 mètres.."; - // pas OK - // pour résoudre ce problème, voyez la syntaxe complexe. +// Ces exemples sont spcifiques l'utilisation de tableaux dans une chane. +// Lorsque vous tes hors d'une chane, utilisez toujours des guillemets +// autour des index de tableau, et n'utilisez pas d'{accolades}. + +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$fruits = array('fraise' => 'rouge', 'banane' => 'jaune'); + +// Fonctionne mais notez que cela fonctionne pas comme +// si cela tait hors d'une chane +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 +echo "Une banane est {$fruits[banane]}."; + +// Ne fonctionne pas, il manque les accolades. Cela donne une erreur d'analyse +echo "Une banane est $fruits['banane']."; + +// Fonctionne +echo "Une banane est " . $fruits['banane'] . "."; + +// Fonctionne +echo "Ce carr a un cot de $square->width mtres de large."; + +// Ne fonctionne pas. Pour une solution, voyez la syntaxe complexe. +echo "Ce carr a un cot de $square->width00 centimtres."; ?> ]]> </programlisting> @@ -835,35 +926,49 @@ pour obtenir un <literal>"{$"</literal> littéral. Voici quelques exemples : </simpara> - <informalexample> + <example> + <title>Syntaxe complexe de chane</title> <programlisting role="php"> <![CDATA[ <?php - $super = 'fantastique'; - echo "C'est { $super}"; -// ne fonctionne pas, -// affiche "C'est { fantastique}" - echo "C'est {$super}"; -// fonctionne, -// affiche "C'est fantastique" - echo "Ce carré a {$square->width}00 centimètres de large."; - echo "Ceci fonctionne : {$tableau[4][3]}"; - echo "Ceci échoue : {$tableau[foo][3]}"; -// pour la même raison que $tableau[bar] ne fonctionne pas hors d'une chaîne - <!-- XXX see the still-to-write explaination in the arrays-section. --> - echo "Essayez plutôt comme ceci : {$tableau['foo'][3]}"; - echo "Vous pouvez même écrire {$objet->valeurs[3]->nom}"; - echo "Voici la valeur de la variable nommée $name: {${$name}}"; - <!-- <xxx> maybe it's better to leave this out?? --> -// cela fonctionne, mais c'est vivement déconseillé. -// Et pour finir, on peut combiner avec des fonctions - $inv = 'Bordeaux'; - echo "Je reprendrai bien un verre de cet excellent {${ strrev('niv') }}, hips"; - <!-- </xxx> --> +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$super = 'fantastique'; + +// Ne fonctionne pas. Affiche : Ceci est { fantastique} +echo "Ceci est { $super}"; + +// Fonctionne. Affiche Ceci est fantastique +echo "This is {$super}"; +echo "This is ${super}"; + +// Fonctionne +echo "Ce carr a un cot de {$square->width}00 centimtres."; + +// 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). +echo "Ceci est faux : {$arr[foo][3]}"; + +// Fonctionne. Lorsuqe vous utilisez un tableau multidimensionnel dans +// une chane, 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 "Ceci est une valeur de variable variable : {${$name}}"; ?> ]]> </programlisting> - </informalexample> + </example> </sect4> </sect3> <sect3 id="language.types.string.substr"> @@ -884,29 +989,18 @@ <example> <title>Exemples de chaînes</title> <programlisting role="php"> -<!-- TODO: either move these examples to a example section, -as with arrays, or distribute them under the applicable -sections. --> -<![CDATA[ -<?php -/* Affectation d'une chaîne. */ - $str = "Ceci est une chaîne"; -/* Concaténation. */ - $str = $str . " avec un peu plus de texte"; -/* Une autre méthode de concaténation. */ - $str .= " et une nouvelle ligne à la fin.\n"; -/* Cette chaîne finira comme : '<p>Nombre: 9</p>' */ - $num = 9; - $str = "<p>Nombre: $num</p>"; -/* Celle-ci sera '<p>Nombre: $num</p>' */ - $num = 9; - $str = '<p>Nombre: $num</p>'; -/* Premier caractère d'une chaîne */ - $str = 'Ceci est un test.'; - $first = $str{0}; -/* Dernier caractère d'une chaîne. */ - $str = 'This is still a test.'; - $last = $str{strlen($str)-1}; +<![CDATA[ +<?php +// Lit le premier caractre de la chane +$str = 'Ceci est un test.'; +$first = $str{0}; + +// Lit le troisime caractre de la chane +$third = $str{2}; + +// Lit le dernier caractre de la chane +$str = 'Ceci est un test.'; +$last = $str{strlen($str)-1}; ?> ]]> </programlisting> @@ -1095,20 +1189,31 @@ <replaceable>value</replaceable></literal>, séparées par des virgules. </para> <para> - Une clé <varname>key</varname> est soit un entier positif + <synopsis> +array( <optional> <replaceable>key</replaceable> => </optional> +<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 + </synopsis> + </para> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$arr = array("foo" => "bar", 12 => true); + +echo $arr["foo"]; // bar +echo $arr[12]; // 1 +?> +]]> + </programlisting> + </informalexample> + </para> + <para> + Une clé <varname>key</varname> est soit un entier ou bien une chaîne. - <!-- - Negative integers are also allowed, however, IMO it's best to not - document that, or even disencourage it. - Why? - First, because it is very tricky. But the real reason is that the key - '-1' will be interpreted as a string, and not as a integer. Therefore, - the usage - "the -1'st value of \$arr is $arr[-1]" is ambigious. By the way, - it results in a parse-error anyway, which is another argument for - not documenting it. - -Jeroen - --> Si une clé est la représentation standard d'un entier positif, elle sera interprété comme tel. (i.e. <literal>'8'</literal> sera interprété comme <literal>8</literal>, tandis que <literal>'08'</literal> @@ -1121,7 +1226,12 @@ <programlisting role="php"> <![CDATA[ <?php - array("somearray" => array(6 => 5, 13 => 9, "a" => 43)); + array("untableau" => array(6 => 5, 13 => 9, "a" => 43)); + +echo $arr["untableau"][6]; // 5 +echo $arr["untableau"][13]; // 9 +echo $arr["untableau"]["a"]; // 42 + ?> ]]> </programlisting> @@ -1133,18 +1243,35 @@ indice numérique n'a été généré, ce sera 0. Si vous spécifiez une qui a déjà été assigné, la nouvelle valeur écrasera la précédente. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +// Ce tableau est identique +array(5 => 43, 32, 56, "b" => 12); + +// Celui ci +array(5 => 43, 6 => 32, 7 => 56, "b" => 12); +?> +]]> + </programlisting> + </informalexample> </para> - <para> - <synopsis> -array( <optional><replaceable>key</replaceable> => </optional> -<replaceable>value</replaceable> - , ... - ) -// <replaceable>key</replaceable> is either <type>string</type> -ou entier <type>integer</type> positif -// <replaceable>value</replaceable> peut être n'importe quoi - </synopsis> - </para> + <para> + Utiliser &true; comme cl revient utiliser le type + <type>integer</type> de valeur <literal>1</literal>. + Utiliser &false; comme cl revient utiliser le type + <type>integer</type> de valeur <literal>0</literal>. + 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 + 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>. + </para> </sect3> <sect3 id="language.types.array.syntax.modifying"> <title>La syntaxe à crochets</title> @@ -1166,6 +1293,26 @@ en fait une alternative pour créer un tableau. Pour modifier une valeur, assignez lui une nouvelle valeur. Pour supprimer une valeur, utilisez la fonction <function>unset</function>. + <example> + <title>Manipuler des lments 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["x"] = 42; // Ceci ajoute un nouvel lment + // avec l'index "x" + +unset($arr[5]); // Ceci efface un lment du tableau + +unset($arr); // Ceci efface tout le tableau +?> +]]> + </programlisting> + </example> </para> </sect3> </sect2><!-- end syntax --> @@ -1175,6 +1322,34 @@ Il y a toute une panoplie de fonctions pratiques pour travailler avec les tableau : <link linkend="ref.array">array-functions</link>. </para> + <note> + <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>. + <example> + <title>Manipuler des lments 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 + $a = array(1 => 'un', 3 => 'trois'); + et non pas + $a = array(1 => 'un', 2 =>'trois'); +*/ + +$b = array_values($a); +// Maintenant b est le tableau array(1 => 'un', 2 =>'trois') +?> +]]> + </programlisting> + </example> + </para> + </note> <para> L'élément de langage <link linkend="control-structures.foreach">foreach</link> est spécifiquement dédiée aux tableau : elle permet de passer en @@ -1198,91 +1373,144 @@ </programlisting> </informalexample> Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison - est que PHP réclame une expression entre les crochets (comme - indiqué dans la section sur la - <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). - Cela signifie que vous pouvez écrire quelque chose comme : + 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 + constantes qui, malheureusement pour votre code, auront ce nom. Actuellement, + cela fonctionne car la constante indfinie est transforme en chane ayant la + mme valeur. + </para> + <para> + D'autres exemples : + <example> + <title>Exemples de conflits de constantes indfinies</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$arr = array('fruit' => 'pomme', 'lgume' => 'carotte'); + +// Correct +print $arr['fruit']; // pomme +print $arr['lgume']; // carotte + +// Incorrect. Cela fonctionne mais PHP affiche une alerte car +// il y a utilisation d'une constante indfinie appele 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'); + +// Notez la diffrence +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 +print "Bonjour $arr[fruit]"; // Bonjour pomme + +// A une exception, les accolades entourant un tableau dans une chane +// 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 +print "Bonjour $arr['fruit']"; +print "Bonjour $_GET['foo']"; + +// La concatenation est une alternative +print "Bonjour " . $arr['fruit']; // Bonjour pomme +?> +]]> + </programlisting> + </example> + </para> + <para> + 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> + est trop faible pour les afficher. + </para> + <para> + 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 : <informalexample> <programlisting role="php"> <![CDATA[ <?php - echo $arr[ foo(true) ]; +echo $arr[somefunc($bar)]; ?> ]]> </programlisting> </informalexample> - Ceci est un exemple d'utilisation de retour de fonction dans un - index de tableau. PHP reconnait aussi les constantes, et vous - pouvez avoir déjà rencontré <literal>E_*</literal>. + Ceci est un exemple d'utilisation de retour de fonction comme + index de tableau. &php; reconnait aussi les constantes, comme + par exemple la famille des <literal>E_*</literal>. <informalexample> <programlisting role="php"> <![CDATA[ <?php - $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; - $error_descriptions[E_WARNING] = "PHP a généré une alerte"; - $error_descriptions[E_NOTICE] = "Ceci est juste une note grâcieuse"; +$error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; +$error_descriptions[E_WARNING] = "PHP met une alerte"; +$error_descriptions[E_NOTICE] = "Ceci est juste une alerte informationnelle"; ?> ]]> </programlisting> </informalexample> - Notez que <literal>E_ERROR</literal> est aussi un identifiant - vlaide, tout comme <literal>bar</literal> dans le premier exemple. - Mais le dernier exemple revient à écrire : + 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 : <informalexample> <programlisting role="php"> <![CDATA[ <?php - $error_descriptions[1] = "Une erreur fatale est survenue"; - $error_descriptions[2] = "PHP a généré une alerte"; - $error_descriptions[8] = "Ceci est juste une note grâcieuse"; +$error_descriptions[1] = "Une erreur fatale est survenue"; +$error_descriptions[2] = "PHP met une alerte"; +$error_descriptions[8] = "Ceci est juste une alerte informationnelle"; ?> ]]> </programlisting> </informalexample> - car <literal>E_ERROR</literal> égale <literal>1</literal>, etc. + car <literal>E_ERROR</literal> vaut <literal>1</literal>, etc... </para> <para> - Alors, comment se fait-t-il que <literal>$foo[bar]</literal> fonctionne? - C'est parce que <literal>bar</literal> est considéré comme une - constante. Cependant, dans ce cas, aucune constante n'a pour nom - <literal>bar</literal>. PHP suppose alors que vous voulez dire - <literal>bar</literal> littéralement, c'est-à-dire la - chaîne <literal>"bar"</literal>, mais que vous avez oublié les - guillements. + Comme nous l'avons dj expliqu dans les exemple ci-dessus, + <literal>$foo[bar]</literal> fonctionne mais est dangereux. + 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 + guillemets. </para> + <sect4> + <title>Pourquoi est-ce aussi dangereux?</title> <para> - Dans le futur, l'équipe de développement peut vouloir ajouter une - nouvelle constante et vous vous retrouverez dans la panade. Par - exemple, vous ne pouvez déjà pas utiliser les constantes - <literal>empty</literal> et <literal>default</literal>, car ce - sont des mots reservés. - <!-- <jeroen>hmm... i'm doubting this myself. Finish it if you like</jeroen> - But probably - the most threatening - thing is yourself, or whoever will maintain the script. You'll - maybe get very strange behaviour, and - --> - </para> - <para> - Et, pour en mettre une autre couche, cette syntaxe est tout simplement - obsolète, et risque de ne plus fonctionner du tout un jour ou l'autre. + 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, + 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>. </para> <note> <simpara> - Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> - avec <literal>E_ALL</literal>, PHP générera des notes à chaque fois que cette - syntaxe est utilisée. Essayez donc <literal>error_reporting(E_ALL);</literal> - dans vos scripts, pour voir). + Pour insister, l'intrieur 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>. </simpara> </note> - <note> - <simpara> - Dans une chaîne à guillements doubles, une autre syntaxe est - valide. Voyez la section sur - <link linkend="language.types.string.parsing">Traitement des variables - dans les chaînes</link> pour plus de détails. - </simpara> - </note> + </sect4> </sect3> </sect2> <sect2 id="language.types.array.casting"> @@ -1365,13 +1593,6 @@ , '02' => 77 // clé = '02' , 0 => 12 // la valeur de la clé 10 sera remplacée par 12 ); -<!-- TODO example of -- mixed keys -- overwriting keys -- integer keys as string -- using vars/functions as key/values -- mixed skipping ---> // empty array $empty = array(); ?> @@ -1459,7 +1680,7 @@ <programlisting role="php"> <![CDATA[ <?php -// remplis un tableau avec les noms de fichiers d'un dossier +// remplit un tableau avec les noms de fichiers d'un dossier $handle = opendir('.'); while ( $file = readdir($handle) ){ $files[] = $file; @@ -1495,41 +1716,30 @@ <programlisting role="php"> <![CDATA[ <?php - $fruits = array ( "fruits" => array ( "a" => "orange" - , "b" => "banane" - , "c" => "pomme" - ) - , "nombres" => array ( 1 - , 2 - , 3 - , 4 - , 5 - , 6 - ) - , "trous" => array ( "premier" - , 5 => "second" - , "troisième" - ) - ); -<!-- quite duplicate... -$a = array( - "apple" => array( - "color" => "red", - "taste" => "sweet", - "shape" => "round" - ), - "orange" => array( - "color" => "orange", - "taste" => "tart", - "shape" => "round" - ), - "banana" => array( - "color" => "yellow", - "taste" => "paste-y", - "shape" => "banana-shaped" - ) -); ---> +$fruits = array ( "fruits" => array ( "a" => "orange", + "b" => "banane", + "c" => "pomme" + ), + "nombre" => array ( 1, + 2, + 3, + 4, + 5, + 6, + ), + "trou" => array ( "premier", + 5 => "second", + "troisime" + ) + ); + +// Exemples d'utilisations des tableaux ci-dessus +echo $fruits["trou"][5]; // affiche "second" +echo $fruits["fruits"]["a"]; // affiche "orange" +unset($fruits["trou"][0]); // supprime "premier" + +// Crer un tableau multidimensionnel +$juices["pomme"]["vert"] = "bon"; ?> ]]> </programlisting> @@ -1547,13 +1757,16 @@ <programlisting role="php"> <![CDATA[ <?php - class foo { - function faire_foo () { - echo "Faisant foo."; +class foo +{ + function faire_foo() + { + echo "Faisant foo."; } - } - $bar = new foo; - $bar->faire_foo(); +} + +$bar = new foo; +$bar->faire_foo(); ?> ]]> </programlisting> @@ -1831,27 +2044,14 @@ <para> Le comportement de la conversion automatique est actuellement indéfinie. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $a = 1; // $a est un entier - $a[0] = "f"; // $a devient un tableau, et $a[0] contient "f" -?> -]]> - </programlisting> - </informalexample> </para> <para> - Bien que dans l'exemple ci-dessus, il semble évident que - $a va devenir un tableau, dont le premier élément - est 'f', considérez l'exemple suivant : <informalexample> <programlisting role="php"> <![CDATA[ <?php - $a = "1"; // $a est une chaîne - $a[0] = "f"; // Qu'est ce qu'une position dans une chaîne ? que se passe t il? +$a = "1"; // $a est une chane +$a[0] = "f"; // Mais que sont les index de chane? ?> ]]> </programlisting> @@ -1866,11 +2066,25 @@ caractères $a? </para> <para> - Pour cette raison, aussi bien pour PHP 3.0.12 que PHP 4.0b3-RC4, - le résultat de la conversion automatique est - considéré comme indéfinie. Des solutions - sont en cours de discussion. - </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 + ci-dessous : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$a = "abc"; // $a est une chane +$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. + </para> </note> <sect2 id="language.types.typecasting"> <title>Transtypage</title> @@ -1928,103 +2142,71 @@ </programlisting> </informalexample> </para> + <note> + <para> + Au lieu de transtyper une variable en chane, vous pouvez aussi + l'insrer 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 + +// Ceci affiche : "Identique" +if ($fst === $str) { + echo "Identique"; +} +?> +]]> + </programlisting> + </informalexample> + </para> + </note> <para> Le transtypage n'a pas toujours de résultat prévisible. Pour plus d'informations, voyez : - </para> <itemizedlist> <listitem> - <simpara> - <link linkend="language.types.boolean.casting">Conversion en booléen</link> - </simpara> + <simpara><link linkend="language.types.boolean.casting">Conversion en + boolen</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.integer.casting">Conversion en entier</link> - </simpara> + <simpara><link linkend="language.types.integer.casting">Conversion en + entier</link></simpara> </listitem> - <!-- don't exist yet <listitem> - <simpara> - <link linkend="language.types.float.casting">Conversion en nombre à - virgule flottante</link> - </simpara> + <simpara><link linkend="language.types.float.casting">Conversion en + nombre virgule flottante</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.string.casting">Conversion en - chaîne de caractères</link> - </simpara> + <simpara><link linkend="language.types.string.casting">Conversion en + chane de caractres</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.array.casting">Conversion en tableau</link> - </simpara> + <simpara><link linkend="language.types.array.casting">Conversion en + tableau</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.object.casting">Conversion en objet</link> - </simpara> + <simpara><link linkend="language.types.object.casting">Conversion en + objet</link></simpara> </listitem> <listitem> - <simpara> - <link linkend="language.types.resource.casting">Conversion en ressource</link> - </simpara> + <simpara><link linkend="language.types.resource.casting">Conversion en + ressource</link></simpara> </listitem> + <!-- don't exist yet <listitem> - <simpara> - <link linkend="language.types.null.casting">Conversion en NULL</link> - </simpara> + <simpara><link linkend="language.types.null.casting">Conversion en + &null;</link></simpara> </listitem> --> </itemizedlist> - <warning> - <simpara> - Pour transformer facilement une variable en chaîne, - entourez la simplement de guillements doubles. - </simpara> - </warning> - <para> - Lors de la conversion d'un tableau en chaîne, le résultat sera - le mot <literal>Array</literal> (tableau, en anglais). Lors de la - conversion d'un objet en chaîne, le résultat sera le mot - <literal>Object</literal> (objet, en anglais). Dans les deux cas, - une alerte sera affichée. - </para> - <para> - Lorsque vous transtypez un scalaire ou une chaîne en tableau, - la variable verra son contenu affecté au premier - élément du tableau. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $var = 'ciao'; - $arr = (array) $var; - echo $arr[0]; // affiche 'ciao' -?> -]]> - </programlisting> - </informalexample> - </para> - <para> - Lorsque vous transtypez un scalaire ou une chaîne en objet, - la valeur de la variable sera transformée en attribut de - l'objet. L'attribut s'appellera 'scalar': - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - $var = 'ciao'; - $obj = (object) $var; - echo $obj->scalar; // affiche 'ciao' -?> -]]> - </programlisting> - </informalexample> </para> </sect2> </sect1> + </chapter> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.35 phpdoc-fr/language/variables.xml:1.36 --- phpdoc-fr/language/variables.xml:1.35 Mon Feb 3 07:49:41 2003 +++ phpdoc-fr/language/variables.xml Tue Feb 4 12:47:00 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.35 $ --> +<!-- $Revision: 1.36 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -103,6 +103,37 @@ </programlisting> </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 + <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> + <programlisting role="php"> +<![CDATA[ +<?php +$i = 'W'; +for($n=0; $n<6; $n++) + echo ++$i . "\n"; + +/* + Affiche ceci : + +X +Y +Z +AA +AB +AC + +*/ +?> +]]> + </programlisting> + </example> + </para> </sect1> <sect1 id="language.variables.predefined"> <title>Variables prédéfinies</title> @@ -117,22 +148,29 @@ </simpara> <warning> <simpara> - En &php; 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont - disponibles dans l'environnement global a changé. Les variables - d'entrées et de serveurs ne sont plus <emphasis>par défaut</emphasis> - placées dans le contexte d'exécution global. Elles sont placées dans - les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. + Depuis la version &php; 4.2.0, la valeur par dfaut 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 + <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> + dans l'URL <literal>http://www.example.com/test.php?id=3</literal> au lieu + de <varname>$id</varname>, ou encore <varname>$_ENV['HOME']</varname> au lieu de + <varname>$HOME</varname>. </simpara> <simpara> - Vous pouvez toujours forcer l'ancien comportement de &php; en le configurant - avec <link linkend="ini.register-globals">register_globals</link> à - <literal>On</literal> votre fichier &php.ini;. + Pour des informations lies 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>, + 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> - Pour plus d'informations et d'explications sur ce changement, voyez - <ulink url="&url.php.release4.1.0;">l'annonce de &php; 4.1.0</ulink> - et and <ulink url="&url.php.release4.2.0;">l'annonce de &php; 4.2.0</ulink> - (en anglais). + L'utilisation des variables prdfinies de &php;, comme les + <link linkend="language.variables.superglobals">tableaux superglobaux</link>, + est recommand. </simpara> </warning> <simpara> @@ -148,7 +186,22 @@ 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 + (<varname>$HTTP_*_VARS</varname>) existent toujours. </simpara> + + <note> + <title>Variables variables</title> + <para> + Les superglobales ne peuvent pas tre utilises 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. + </para> <variablelist id="language.variables.superglobals"> <title>Tableaux superglobaux de &php;</title> @@ -362,8 +415,35 @@ <simpara> Le tableau $GLOBALS est un tableau associatif avec le nom des variables globales comme clef et les valeurs des éléments - du tableau comme valeur des variables. + du tableau comme valeur des variables. Notez que <varname>$GLOBALS</varname> + existe dans tous les contextes, car <varname>$GLOBALS</varname> est un + <link linkend="language.variables.superglobals">superglobal</link>. + Voici un exemple des super globaux : </simpara> + <para> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?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. + 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 + // depuis PHP 4.1.0 + print $_POST['name']; +} +?> +]]> + </programlisting> + </informalexample> + </para> <simpara> Une autre caractéristique importante de la portée des variables est la notion de variable <emphasis>static</emphasis>. Une variable statique a @@ -441,6 +521,113 @@ </programlisting> </informalexample> + <simpara> + Le Zend Engine 1, sur qui repose <literal>PHP4</literal>, implmente 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 : + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function test_global_ref() { + global $obj; + $obj = &new stdclass; +} + +function test_global_noref() { + global $obj; + $obj = new stdclass; +} + +test_global_ref(); +var_dump($obj); +test_global_noref(); +var_dump($obj); +?> +]]> + </programlisting> + </informalexample> + + <simpara> + Excuter cet exemple vous donnera : + </simpara> + + <screen> +NULL +object(stdClass)(0) { +} + </screen> + + <simpara> + Un comportement similaire s'applique la commande <literal>static</literal>. + Les rfrences ne sont pas stockes dynamiquement : + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function &get_instance_ref() { + static $obj; + + echo "Objet statique : "; + var_dump($obj); + if (!isset($obj)) { + // Assigne une rfrence une variable statique + $obj = &new stdclass; + } + $obj->property++; + return $obj; +} + +function &get_instance_noref() { + static $obj; + + echo "Objet statique : "; + var_dump($obj); + if (!isset($obj)) { + // Assigne une objet une variable statique + $obj = new stdclass; + } + $obj->property++; + return $obj; +} + +$obj1 = get_instance_ref(); +$still_obj1 = get_instance_ref(); +echo "\n"; +$obj2 = get_instance_noref(); +$still_obj2 = get_instance_noref(); +?> +]]> + </programlisting> + </informalexample> + + <simpara> + Excuter cet exemple vous donnera : + </simpara> + + <screen> +Objet statique : NULL +Objet statique : NULL + +Objet statique : NULL +Objet statique : object(stdClass)(1) { + ["property"]=> + int(1) +} + </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 + <literal>&get_instance_ref()</literal> une seconde fois. + </simpara> </sect1> <sect1 id="language.variables.variable"> <title>Les variables dynamiques</title> @@ -533,97 +720,161 @@ <programlisting role="html"> <![CDATA[ <form action="foo.php" method="post"> - Nom: <input type="text" name="nom"><BR> - <input type="submit"> + Name: <input type="text" name="username"><br> + Email: <input type="text" name="email"><br> + <input type="submit" name="submit" value="Submit me!"> </form> ]]> </programlisting> </example> </para> - <simpara> - Lorsque ce formulaire est envoyé, le &php; va créer la variable - <computeroutput>$nom</computeroutput>, qui contiendra la valeur - que vous avez entrée dans le champs <emphasis>Nom:</emphasis> - du formulaire. - </simpara> + + <para> + Suivant votre configuration particulier et vos prfrences, + vous avez plusieurs mthodes pour accder aux variables du formulaires. + Voici quelques exemples : + </para> + + <para> + <example> + <title>Accder simplement des variables de formulaires POST</title> + <programlisting role="html"> +<![CDATA[ +<?php +// Disponibles depuis &php; 4.1.0 + + print $_POST['username']; + print $_REQUEST['username']; + + import_request_variables('p', 'p_'); + print $p_username; + +// Disponibles depuis PHP 3. + + 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. + + print $username; +?> +]]> + </programlisting> + </example> + </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 + 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>. + Voyez aussi <link linkend="reserved.variables.request">$_REQUEST</link> et + <function>import_request_variables</function>. + </para> + + <note> + <para> + <link linkend="language.variables.superglobals">Les tableaux superglobaux</link>, + comme <varname>$_POST</varname> et <varname>$_GET</varname>, sont disponibles + depuis PHP 4.1.0 + </para> + </note> + + <para> + As shown, before PHP 4.2.0 the default value for <link + linkend="ini.register-globals">register_globals</link> + was <emphasis>on</emphasis>. And, in PHP 3 it was always on. The PHP + community is encouraging all to not rely on this directive + as it's preferred to assume it's <emphasis>off</emphasis> and code + accordingly. + </para> + <note> <para> - La directive de configuration <link - linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> affecte les valeurs - issues des méthodes GET et POST ainsi aue des Cookies. Si cette - directive est active, une valeur telle que <literal>It's "PHP!"</literal> - sera automagiquement transformée en <literal>It\'s - \"PHP!\"</literal>. - L'échappement est nécessaire pour les insertions en base de - données. Voyez <function>addslashes</function>, - <function>stripslashes</function> et + 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. + Voyez aussi les fonctions <function>addslashes</function>, + <function>stripslashes</function> et <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>. </para> </note> + <simpara> - Le &php; permet aussi l'utilisation des tableaux dans le contexte de - formulaire, mais seulement des tableaux à une seule dimension. Comme - cela, vous pouvez rassembler des variables ou utiliser cette - fonctionnalité pour récupérer les valeurs d'un choix - multiple : + &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, + et les affiche : </simpara> + <para> <example> - <title>Variables complexes de formulaire</title> - <programlisting role="html"> + <title>Variables de formulaires complexes</title> + <programlisting role="php"> <![CDATA[ -<form action="array.php" method="post"> - Name: <input type="text" name="personal[name]"><br> +<?php +if ($HTTP_POST_VARS['action'] == 'submitted') { + print '<pre>'; + + print_r($HTTP_POST_VARS); + print '<a href="'. $HTTP_SERVER_VARS['PHP_SELF'] .'">Essayez nouveau</a>'; + + print '</pre>'; +} else { +?> +<form action="<?php echo $HTTP_SERVER_VARS['PHP_SELF']; ?>" method="post"> + Name: <input type="text" name="personal[name]"><br> Email: <input type="text" name="personal[email]"><br> Beer: <br> <select multiple name="vin[]"> - <option value="medoc">Médoc - <option value="chablis">Chablis - <option value="riesling">Riesling - </select> - <input type="submit"> + <option value="bordeaux">bordeaux</option> + <option value="beaujolais">beaujolais</option> + <option value="loire">loire</option> + </select><br> + <input type="hidden" name="action" value="submitted"> + <input type="submit" name="submit" value="submit me!"> </form> +<?php +} +?> ]]> </programlisting> </example> </para> - <simpara> - Si l'option "track_vars" est activée, soit par l'option de - compilation - <link linkend="ini.track-vars">track_vars</link>, soit par la directive de - configuration <computeroutput> -<![CDATA[ - <? php_track_vars ?> -]]> -</computeroutput>, - les variables transmises par les méthodes POST et GET - pourront aussi être trouvées dans le tableau - associatif global $HTTP_POST_VARS ou $HTTP_GET_VARS - suivant la méthode utlisée. - </simpara> + + <para> + En PHP 3, la syntaxe de tableau HTML est limite aux tableaux + uni-dimensionnels. En PHP 4, ces limitations ont t leves. + </para> + <sect3 id="language.variables.external.form.submit"> - <title>Bouton "submit" sous forme d'image</title> + <title>Nom de variables IMAGE SUBMIT</title> + <simpara> - Lorsque vous envoyez le résultat d'un formulaire, vous - pouvez utiliser une image au lieu du bouton "submit" standard - en utilisant un tag : + Lors de la soumission d'un formulaire, il est possible d'utiliser + une image au lieu d'un bouton standard, comme ceci : </simpara> + <informalexample> <programlisting role="html"> <![CDATA[ - <input type=image src="image.gif" name="sub"> +<input type="image" src="image.gif" name="sub"> ]]> </programlisting> </informalexample> + <simpara> - Lorsqu'un utilisateur clique sur l'image, le formulaire sera - transmis au serveur avec deux variables de plus, sub_x et - sub_y. Ces deux variables contiennent les coordonnées - de l'endroit où l'utilisateur à cliqué. Les - utilisateurs expérimentés remarqueront que les noms - de variables sont transmis avec une virgule à la place du - caractère "_", mais &php; fait la conversion - automatiquement. + Lorque l'utilisateur clique sur cette image, le formulaire + associ est envoy au serveur, avec deux donnes supplmentaires, + <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. </simpara> </sect3> </sect2>