cvs: phpdoc-fr /language control-structures.xml functions.xml oop.xml operators.xml types.xml variables.xml

From: 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&ocirc;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 &ecirc;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&eacute;cution conditionnelle d'une partie de code. Les fonctionnalit&eacute;s de l'instruction <literal>if</literal> - sont les m&ecirc;mes en PHP qu'en C : + sont les m&ecirc;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&eacute;enne. Si l'expression <replaceable>expr</replaceable> vaut - &true;, PHP ex&eacute;cutera l'instruction et si elle + &true;, &php; ex&eacute;cutera l'instruction et si elle vaut &false;, l'instruction sera ignor&eacute;e. Plus de d&eacute;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&egrave;s les autres, apr&egrave;s un <literal>if</literal> initial. Le premier <literal>elseif</literal> qui sera &eacute;valu&eacute; - &agrave; &true; sera ex&eacute;cut&eacute;. En PHP, vous + &agrave; &true; sera ex&eacute;cut&eacute;. En &php;, vous pouvez aussi &eacute;crire "else if" en deux mots et son comportement sera identique &agrave; la version en un seul mot. La s&eacute;mantique des deux expression est l&eacute;g&egrave;rement diff&eacute;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&egrave;re de rassembler des + &php; propose une autre mani&egrave;re de rassembler des instructions &agrave; l'int&eacute;rieur d'un bloc, pour les fonctions de contr&ocirc;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&eacute;menter une boucle en PHP. Cette boucle + simple d'impl&eacute;menter une boucle en &php;. Cette boucle se comporte de la m&ecirc;me mani&egrave;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&egrave;s simple. Le PHP ex&eacute;cute l'instruction tant + tr&egrave;s simple. PHP ex&eacute;cute l'instruction tant que l'expression de la boucle <literal>while</literal> est &eacute;valu&eacute;e comme &true;. La valeur de l'expression est v&eacute;rifi&eacute;e &agrave; chaque d&eacute;but de boucle, et, si la valeur change durant l'ex&eacute;cution de l'instruction, l'ex&eacute;cution ne s'arr&ecirc;tera qu'&agrave; la fin de l'it&eacute;ration - (chaque fois que le PHP ex&eacute;cute l'instruction, on appelle + (chaque fois que &php; ex&eacute;cute l'instruction, on appelle cela une it&eacute;ration). De temps en temps, si l'expression du <literal>while</literal> est &false; avant la premi&egrave;re it&eacute;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 &eacute;ventuellement &ecirc;tre laiss&eacute;es vides. Si l'expression <replaceable>expr2</replaceable> est laiss&eacute;e vide, cela signifie que c'est une boucle infinie - (PHP consid&egrave;re implicitement qu'elle vaut &true;, + (&php; consid&egrave;re implicitement qu'elle vaut &true;, comme en C). Cela n'est pas vraiment tr&egrave;s utile, &agrave; 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 &ecirc;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&eacute;der aux &eacute;l&eacute;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&eacute;der aux &eacute;l&eacute;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&ecirc;me r&eacute;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&egrave;re: @@ -653,27 +653,30 @@ <programlisting role="php"> <![CDATA[ <?php -$i = 0; -while ($i < 10) { - if ($arr[$i] == "stop") { - break; /* Vous pouvez aussi &eacute;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 "&agrave; 5<br>\n"; - break 1; /* Ne sort que du switch. */ + echo "A 5<br>\n"; + break 1; /* Termine uniquement le switch. */ case 10: - echo "&agrave; 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&eacute;cut&eacute;e ligne par ligne. Au d&eacute;but, aucun code n'est ex&eacute;cut&eacute;. Seulement lorsqu'un <literal>case</literal> est v&eacute;rifi&eacute;, - PHP ex&eacute;cute alors les instructions correspondantes. - PHP continue d'ex&eacute;cuter les instructions jusqu'&agrave; + &php; ex&eacute;cute alors les instructions correspondantes. + &php; continue d'ex&eacute;cuter les instructions jusqu'&agrave; la fin du bloc d'instructions du <literal>switch</literal>, ou bien d&egrave;s qu'il trouve l'instruction <literal>break</literal>. Si vous ne pouvez pas utiliser l'instruction <literal>break</literal> &agrave; la fin de l'instruction - <literal>case</literal>, PHP continuera &agrave; ex&eacute;cuter + <literal>case</literal>, &php; continuera &agrave; ex&eacute;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 &eacute;gal &agrave; 0, PHP va + Dans cet exemple, si $i est &eacute;gal &agrave; 0, &php; va ex&eacute;cuter quand m&ecirc;me toutes les instructions qui - suivent. Si $i est &eacute;gal &agrave; 1, PHP ex&eacute;cutera + suivent. Si $i est &eacute;gal &agrave; 1, &php; ex&eacute;cutera les deux derni&egrave;res instructions. Et seulement si $i est &eacute;gal &agrave; 2, vous obtiendrez le r&eacute;sultat escompt&eacute;, c'est-&agrave;-dire, l'affiche de @@ -825,7 +828,7 @@ </simpara> <para> La liste de commandes d'un <literal>case</literal> peut - &ecirc;tre vide, auquel cas PHP utilisera la liste de + &ecirc;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&eacute;claration, + Cet exemple profile le code &php; dans le bloc de d&eacute;claration, et enregistre l'heure de chaque commande bas niveau. Cette information peut &ecirc;tre r&eacute;utilis&eacute;e pour d&eacute;busquer les segments de code lents. Vous pouvez impl&eacute;menter d'autres m&eacute;thodes, mais @@ -997,7 +1000,7 @@ <simpara> Les ticks sont bien pratiques pour d&eacute;bugger, impl&eacute;menter un multi-t&acirc;ches simple, des entr&eacute;es sorties en t&acirc;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&eacute;cute un - fichier PHP. + fichier &php;. </simpara> <simpara> La commande <function>require</function> se remplace elle-m&ecirc;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 &agrave; 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&ecirc;me si les lignes n'&eacute;taient pas utilis&eacute;es. Une condition if n'avait aucun effet sur <function>require</function>. Cependant, si la ligne du <function>require</function> n'est jamais utilis&eacute;e, @@ -1210,7 +1212,7 @@ parent ne sera pas interrompue. Pour cette raison, le code qui est dans le fichier doit &ecirc;tre plac&eacute; 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&eacute; : voir <xref linkend="wrappers"/> pour une liste des protocoles), au lieu d'un simple chemin local. Si le serveur distant interpr&ecirc;te le fichier comme du code - PHP, des variables peuvent &ecirc;tre transmises au serveur distant + &php;, des variables peuvent &ecirc;tre transmises au serveur distant via l'URL et la m&eacute;thode GET. Ce n'est pas, &agrave; strictement parler, la m&ecirc;me chose que d'h&eacute;riter du contexte de variable. Le fichier inclus est en fait un script ex&eacute;cut&eacute; &agrave; distance, @@ -1304,7 +1306,7 @@ </simpara> <note> <simpara> - En PHP 3, le retourn n'est pas utilisable &agrave; moins que ce + En &php; 3, le retourn n'est pas utilisable &agrave; moins que ce ne soit dans un bloc de fonction, auquel cas le <function>return</function> s'applique &agrave; 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&egrave;res distributions PHP. + derni&egrave;res distributions &php;. </para> <note> <para> - <function>require_once</function> a &eacute;t&eacute; ajout&eacute; en PHP 4.0.1pl2 + <function>require_once</function> a &eacute;t&eacute; ajout&eacute; en &php; 4.0.1pl2 </para> </note> <note> @@ -1440,9 +1442,7 @@ sera pas une seconde fois. </para> <para> - Comme pr&eacute;cis&eacute; dans la section - <function>require_once</function>, la fonction - <function>include_once</function> est utilis&eacute;e de + La fonction <function>include_once</function> est utilis&eacute;e de pr&eacute;f&eacute;rence lorsque le fichier doit &ecirc;tre inclus ou &eacute;valu&eacute; plusieurs fois dans un script, ou bien lorsque vous voulez &ecirc;tre s&ucirc;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&egrave;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&egrave;re distribution de &php;. </para> + <note> + <para> + <function>include_once</function> a &eacute;t&eacute; ajout&eacute; en &php; 4.0.1pl2 + </para> + </note> + <note> + <para> + Attention, <function>include_once</function> et + <function>include_once</function> sont sensibles &agrave; la casse + sous Windows. + <example> + <title><function>include_once</function> est sensible &agrave; 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 &ecirc;tre d&eacute;finie en utilisant la syntaxe suivante : - <informalexample> + <example> + <title>DŽfinition 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&icirc;tre @@ -28,6 +29,74 @@ En PHP 3, les fonctions doivent &ecirc;tre d&eacute;finies avant qu'elles ne soient utilis&eacute;es. Ce n'est plus le cas en PHP 4. </simpara> + <para> + Lorsqu'une fonction est dŽfinie de manire conditionnelle, comme dans + les exemples ci-dessous, leur dŽfinition doit <emphasis>prŽcŽder</emphasis> + leur utilisation. + <example> + <title>Fonctions conditionnelles</title> + <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 ds de dŽbut 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&eacute;finition de fonctions d&eacute;j&agrave; d&eacute;clar&eacute;es. @@ -93,7 +162,7 @@ <programlisting role="php"> <![CDATA[ <?php -function add_some_extra(&amp;$string) { +function add_some_extra(&$string) { $string .= ', et un peu plus.'; } $str = 'Ceci est une cha&icirc;ne'; @@ -119,7 +188,7 @@ $str = Ceci est une cha&icirc;ne'; foo ($str); echo $str; // affiche 'Ceci est une cha&icirc;ne' -foo (&amp;$str); +foo (&$str); echo $str; // affiche 'Ceci est une cha&icirc;ne, et un peu plus.' ?> ]]> @@ -268,10 +337,10 @@ <programlisting role="php"> <![CDATA[ <?php -function &amp;retourne_reference() { +function &retourne_reference() { return $uneref; } -$newref =&amp;retourne_reference(); +$newref =& retourne_reference(); ?> ]]> </programlisting> @@ -326,10 +395,10 @@ <![CDATA[ <?php function foo() { - echo "dans foo()&lt;br&gt;\n"; + echo "dans foo()<br>\n"; } function bar( $arg = '' ) { - echo "Dans bar(); l'argument &eacute;tait '$arg'.&lt;br&gt;\n"; + echo "Dans bar(); l'argument &eacute;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&eacute;e dans le constructeur cr&eacute;e dans le constructeur cr&eacute;e dans le constructeur */ - $bar2 =&amp;new foo('cr&eacute;e dans le constructeur'); + $bar2 =&new foo('cr&eacute;e dans le constructeur'); $bar2->echoName(); $globalref[1]->echoName(); /* affiche : @@ -747,8 +747,8 @@ } } class b { - function b(&amp;$a) { - $this->a = &amp;$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 &agrave; un r&eacute;sultat ind&eacute;sirable &agrave; // la ligne marqu&eacute;e d'une &eacute;toile -$a =&amp;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&eacute;rateurs</title> <simpara> @@ -190,7 +190,8 @@ assign&eacute;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&eacute;rateur d'assignation, il existe des @@ -208,9 +209,10 @@ cha&icirc;nes de caract&egrave;res. Cela permet d'utiliser la valeur d'une variable dans une expression et d'affecter le r&eacute;sultat de cette expression &agrave; cette variable. - Par exemple: - <informalexample> - <programlisting role="php"> + Par exemple : + <example> + <title>Exemples avec les op&eacute;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&eacute;rateurs sur les bits vous permettent de manipuler les bits dans un entier. </simpara> + <para> + <example> + <title>Exemples avec les pp&eacute;rateurs sur les bits</title> + <programlisting role="php"> +<![CDATA[ +<?php + echo 12 ^ 9; +// Affiche '5' + + echo "12" ^ "9"; +// Affiche le caractre 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&eacute;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&egrave;tre peut indiff&eacute;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&eacute;clar&eacute; @@ -86,6 +78,46 @@ l'ex&eacute;cution par le PHP, en fonction du contexte dans lequel la variable est utilis&eacute;e. </simpara> + <note> + <simpara> + Si vous voulez vŽrifier le type et la valeur d'une variable + ou d'une <link linkend="language.expressions">expression</link>, utilisez + la fonction <function>var_dump</function>. + </simpara> + <para> + Si vous souhaitez simplement une reprŽsentation lisible pour du dŽbogage, + utilisez la fonction <function>gettype</function>. Pour vŽrifier la prŽsence + de certains types, <emphasis>n'utilisez pas</emphasis> <function>gettype</function>, + mais plut™t les fonctions <literal>is_<replaceable>type</replaceable></literal>. + Par exemple : + <example> + <title>Exemples de vŽrification de type de variable</title> + <programlisting role="php"> +<![CDATA[ +<?php +$bool = TRUE; // un boolŽen +$str = "foo"; // une cha”ne de caractres +$int = 12; // un entier + +echo gettype($bool); // affiche "boolean" +echo gettype($str); // affiche "string" + +// Ceci est un engier, on l'incrŽmente de 4 +if (is_int($int)) { + $int += 4; +} + +// Si $bool est une cha”ne, 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 &agrave; &ecirc;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&eacute;en</link> FALSE </simpara> + Le <link linkend="language.types.boolean">bool&eacute;en</link>FALSE + </simpara> </listitem> <listitem> <simpara> @@ -207,8 +243,22 @@ <literal>-1</literal> est consid&eacute;r&eacute; comme vrai! </simpara> </warning> - <!-- and/or a few examples, for the people only looking at - the examples... </XXX> --> + <example> + <title>Conversion en boolŽen</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&eacute; des entiers, il sera interpr&eacute;t&eacute; comme un <type>float</type>. - <informalexample> + <example> + <title>D&eacute;passement de capacit&eacute; 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&ecirc;me, si une fonction ou un op&eacute;rateur retourne un entier qui est hors des limites de validit&eacute; 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&egrave;re. <literal>1/2</literal> @@ -326,6 +372,29 @@ <literal>-429496728</literal>. </simpara> </warning> + <para> + Il n'existe pas de division entire en PHP. + <literal>1/2</literal> gŽnrera le <type>float</type> + <literal>0.5</literal>. Vous pouvez forcer la valeur + au format entier pour faire l'arrondi, ou bien utiliser + les fonctions <function>round</function>, + <function>floor</function> ou <function>ceil</function>. + <example> + <title>Divisions entires</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&icirc;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&eacute;remment. Voyez <literal>$foo[bar]</literal> hors des cha&icirc;nes - echo "Ce carr&eacute; est large de $carre->largeur m&egrave;tres."; - // OK - echo "Ce carr&eacute; est large de $carre->largeur00 m&egrave;tres.."; - // pas OK - // pour r&eacute;soudre ce probl&egrave;me, voyez la syntaxe complexe. +// Ces exemples sont spŽcifiques ˆ l'utilisation de tableaux dans une cha”ne. +// Lorsque vous tes hors d'une cha”ne, utilisez toujours des guillemets +// autour des index de tableau, et n'utilisez pas d'{accolades}. + +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$fruits = array('fraise' => 'rouge', 'banane' => 'jaune'); + +// Fonctionne mais notez que cela fonctionne pas comme +// si cela Žtait hors d'une cha”ne +echo "Une banane est $fruits[banane]."; + +// Fonctionne +echo "Une banane est {$fruits['banane']}."; + +// Fonctionne mais PHP cherche une constante appelŽe banane +// tel que dŽcrit ci-dessous +echo "Une banane est {$fruits[banane]}."; + +// Ne fonctionne pas, il manque les accolades. Cela donne une erreur d'analyse +echo "Une banane est $fruits['banane']."; + +// Fonctionne +echo "Une banane est " . $fruits['banane'] . "."; + +// Fonctionne +echo "Ce carrŽ a un cotŽ de $square->width mtres de large."; + +// Ne fonctionne pas. Pour une solution, voyez la syntaxe complexe. +echo "Ce carrŽ a un cotŽ de $square->width00 centimtres."; ?> ]]> </programlisting> @@ -835,35 +926,49 @@ pour obtenir un <literal>"{$"</literal> litt&eacute;ral. Voici quelques exemples : </simpara> - <informalexample> + <example> + <title>Syntaxe complexe de cha”ne</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&eacute; a {$square->width}00 centim&egrave;tres de large."; - echo "Ceci fonctionne : {$tableau[4][3]}"; - echo "Ceci &eacute;choue : {$tableau[foo][3]}"; -// pour la m&ecirc;me raison que $tableau[bar] ne fonctionne pas hors d'une cha&icirc;ne - <!-- XXX see the still-to-write explaination in the arrays-section. --> - echo "Essayez plut&ocirc;t comme ceci : {$tableau['foo'][3]}"; - echo "Vous pouvez m&ecirc;me &eacute;crire {$objet->valeurs[3]->nom}"; - echo "Voici la valeur de la variable nomm&eacute;e $name: {${$name}}"; - <!-- <xxx> maybe it's better to leave this out?? --> -// cela fonctionne, mais c'est vivement d&eacute;conseill&eacute;. -// 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 centimtres."; + +// Fonctionne +echo "Ceci fonctionne : {$arr[4][3]}"; + +// Ceci est faut pour la mme raison que $foo[bar] est faux +// hors d'une cha”ne. En d'autres terme, cela va fonctionne +// car PHP recherche d'abord une constante appelŽe foo, mais +// il gŽnŽrera une note E_NOTICE (undefined constant). +echo "Ceci est faux : {$arr[foo][3]}"; + +// Fonctionne. Lorsuqe vous utilisez un tableau multidimensionnel dans +// une cha”ne, n'oubliez jamais les accolades. +echo "Ceci fonctionne : {$arr['foo'][3]}"; + +// Fonctionne +echo "Ceci fonctionne : " . $arr['foo'][3]; + +echo "Vous pouvez mme Ž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&icirc;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&icirc;ne. */ - $str = "Ceci est une cha&icirc;ne"; -/* Concat&eacute;nation. */ - $str = $str . " avec un peu plus de texte"; -/* Une autre m&eacute;thode de concat&eacute;nation. */ - $str .= " et une nouvelle ligne &agrave; la fin.\n"; -/* Cette cha&icirc;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&egrave;re d'une cha&icirc;ne */ - $str = 'Ceci est un test.'; - $first = $str{0}; -/* Dernier caract&egrave;re d'une cha&icirc;ne. */ - $str = 'This is still a test.'; - $last = $str{strlen($str)-1}; +<![CDATA[ +<?php +// Lit le premier caractre de la cha”ne +$str = 'Ceci est un test.'; +$first = $str{0}; + +// Lit le troisime caractre de la cha”ne +$third = $str{2}; + +// Lit le dernier caractre de la cha”ne +$str = 'Ceci est un test.'; +$last = $str{strlen($str)-1}; ?> ]]> </programlisting> @@ -1095,20 +1189,31 @@ <replaceable>value</replaceable></literal>, s&eacute;par&eacute;es par des virgules. </para> <para> - Une cl&eacute; <varname>key</varname> est soit un entier positif + <synopsis> +array( <optional> <replaceable>key</replaceable> =&gt; </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&eacute; <varname>key</varname> est soit un entier ou bien une cha&icirc;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&eacute; est la repr&eacute;sentation standard d'un entier positif, elle sera interpr&eacute;t&eacute; comme tel. (i.e. <literal>'8'</literal> sera interpr&eacute;t&eacute; 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&eacute;rique n'a &eacute;t&eacute; g&eacute;n&eacute;r&eacute;, ce sera 0. Si vous sp&eacute;cifiez une qui a d&eacute;j&agrave; &eacute;t&eacute; assign&eacute;, la nouvelle valeur &eacute;crasera la pr&eacute;c&eacute;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 &ecirc;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 cha”ne vide comme index va crŽer cet index, + et ce n'est pas la mme chose que d'utiliser des + crochets vides. + </para> + <para> + Il n'est pas possible d'utiliser des tableaux ou des objets comme + clŽs. Ce faisant, vous gŽnŽrerez une alerte : <literal>Illegal offset type</literal>. + </para> </sect3> <sect3 id="language.types.array.syntax.modifying"> <title>La syntaxe &agrave; crochets</title> @@ -1166,6 +1293,26 @@ en fait une alternative pour cr&eacute;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 ŽlŽments de tableau</title> + <programlisting role="php"> +<![CDATA[ +<?php +$arr = array(5 => 1, 12 => 2); + +$arr[] = 56; // Ceci revient ˆ $arr[13] = 56; + // ˆ ce moment du script + +$arr["x"] = 42; // Ceci ajoute un nouvel ŽlŽment + // avec l'index "x" + +unset($arr[5]); // Ceci efface un ŽlŽment 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 + rŽindexŽ. Si vous utilisez uniquement des index numŽriques + (commenant ˆ zŽro, et incrŽmentŽs de un), vous pouvez effectuer + la rŽindexation en utilisant <function>array_values</function>. + <example> + <title>Manipuler des ŽlŽments de tableau</title> + <programlisting role="php"> +<![CDATA[ +<?php +$a = array(1 => 'un', 2 => 'deux', 3 => 'trois'); +unset($a[2]); +/* Cela va produire un tableau qui aurait ŽtŽ + $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'&eacute;l&eacute;ment de langage <link linkend="control-structures.foreach">foreach</link> est sp&eacute;cifiquement d&eacute;di&eacute;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&eacute;clame une expression entre les crochets (comme - indiqu&eacute; dans la section sur la - <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). - Cela signifie que vous pouvez &eacute;crire quelque chose comme : + est que PHP attend une constante entre crochets (bar) plut™t qu'une cha”ne + ('bar', notez les guillemets). Or, PHP pourrait dŽfinir dans le futur des + constantes qui, malheureusement pour votre code, auront ce nom. Actuellement, + cela fonctionne car la constante indŽfinie est transformŽe en cha”ne ayant la + mme valeur. + </para> + <para> + D'autres exemples : + <example> + <title>Exemples de conflits de constantes indŽfinies</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Affichons toutes les erreurs +error_reporting(E_ALL); + +$arr = array('fruit' => 'pomme', 'lŽgume' => 'carotte'); + +// Correct +print $arr['fruit']; // pomme +print $arr['lŽgume']; // carotte + +// Incorrect. Cela fonctionne mais PHP affiche une alerte car +// il y a utilisation d'une constante indŽfinie appelŽe fruit +// +// Notice: Use of undefined constant fruit - assumed 'fruit' in... +print $arr[fruit]; // pomme + +// DŽfinissons une constante pour illustrer le problme. +// Nous crŽons une constante appelŽe fruit, qui vaut 'lŽgume'. +define('fruit','lŽgume'); + +// Notez la diffŽrence +print $arr['fruit']; // pomme +print $arr[fruit]; // carotte + +// La suite est correcte si cela se passe dans une cha”ne. +// Les constantes ne sont pas remplacŽes par leur valeur dans une cha”ne +print "Bonjour $arr[fruit]"; // Bonjour pomme + +// A une exception, les accolades entourant un tableau dans une cha”ne +// permettent d'utiliser les constantes +print "Bonjour {$arr[fruit]}"; // Bonjour carotte +print "Bonjour {$arr['fruit']}"; // Bonjour pomme + +// Ceci ne fonctionnera pas, et donnera une erreur d'analyse +// Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING' +// Cela s'applique aussi aux autoglobales dans les cha”nes +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 dŽfaut, <link linkend="ini.error-reporting">error_reporting</link> + est trop faible pour les afficher. + </para> + <para> + Comme indiquŽ dans la section <link linkend="language.types.array.syntax">syntaxe</link>, + 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&eacute;j&agrave; rencontr&eacute; <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&eacute;n&eacute;r&eacute; une alerte"; - $error_descriptions[E_NOTICE] = "Ceci est juste une note gr&acirc;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 &agrave; &eacute;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&eacute;n&eacute;r&eacute; une alerte"; - $error_descriptions[8] = "Ceci est juste une note gr&acirc;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> &eacute;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&eacute;r&eacute; 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&eacute;ralement, c'est-&agrave;-dire la - cha&icirc;ne <literal>"bar"</literal>, mais que vous avez oubli&eacute; les - guillements. + Comme nous l'avons dŽjˆ expliquŽ dans les exemple ci-dessus, + <literal>$foo[bar]</literal> fonctionne mais est dangereux. + Cela fonctionne car <literal>bar</literal> est identifiŽ comme une + 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'&eacute;quipe de d&eacute;veloppement peut vouloir ajouter une - nouvelle constante et vous vous retrouverez dans la panade. Par - exemple, vous ne pouvez d&eacute;j&agrave; pas utiliser les constantes - <literal>empty</literal> et <literal>default</literal>, car ce - sont des mots reserv&eacute;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&egrave;te, et risque de ne plus fonctionner du tout un jour ou l'autre. + A l'avenir, la PHP team peut dŽcider d'ajouter une constante ou + un autre mot clŽ, ou bien vous souhaiterez aussi ajouter une + constante dans votre application, et vous serez bloquŽ. Par exemple, + vous ne pouvez pas utiliser mots comme <literal>empty</literal> et + <literal>default</literal> de cette manire, car il sont dŽjˆ + <link linkend="reserved">rŽservŽs</link>. </para> <note> <simpara> - Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> - avec <literal>E_ALL</literal>, PHP g&eacute;n&eacute;rera des notes &agrave; chaque fois que cette - syntaxe est utilis&eacute;e. Essayez donc <literal>error_reporting(E_ALL);</literal> - dans vos scripts, pour voir). + Pour insister, ˆ l'intŽrieur d'une <type>string</type> ˆ guillemets doubles, + il est correct de ne pas utiliser les guillemets simples dans les index, + et <literal>"$foo[bar]"</literal> est valide. Voyez les exemples + ci-dessus pour plus de dŽtails sur la syntaxe des + <link linkend="language.types.string.parsing">variable dans les cha”nes</link>. </simpara> </note> - <note> - <simpara> - Dans une cha&icirc;ne &agrave; guillements doubles, une autre syntaxe est - valide. Voyez la section sur - <link linkend="language.types.string.parsing">Traitement des variables - dans les cha&icirc;nes</link> pour plus de d&eacute;tails. - </simpara> - </note> + </sect4> </sect3> </sect2> <sect2 id="language.types.array.casting"> @@ -1365,13 +1593,6 @@ , '02' => 77 // cl&eacute; = '02' , 0 => 12 // la valeur de la cl&eacute; 10 sera remplac&eacute;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&egrave;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", + "troisime" + ) + ); + +// 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" + +// CrŽer 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&eacute;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 &eacute;vident que - $a va devenir un tableau, dont le premier &eacute;l&eacute;ment - est 'f', consid&eacute;rez l'exemple suivant : <informalexample> <programlisting role="php"> <![CDATA[ <?php - $a = "1"; // $a est une cha&icirc;ne - $a[0] = "f"; // Qu'est ce qu'une position dans une cha&icirc;ne ? que se passe t il? +$a = "1"; // $a est une cha”ne +$a[0] = "f"; // Mais que sont les index de cha”ne? ?> ]]> </programlisting> @@ -1866,11 +2066,25 @@ caract&egrave;res $a? </para> <para> - Pour cette raison, aussi bien pour PHP 3.0.12 que PHP 4.0b3-RC4, - le r&eacute;sultat de la conversion automatique est - consid&eacute;r&eacute; comme ind&eacute;finie. Des solutions - sont en cours de discussion. - </para> + Les versions courantes de &php; interprte le second assignement + comme un index de cha”ne, et donc $a devient "f", et le + rŽsultat de cette conversion automatique doit tre considŽrŽ comme + indŽfini. &php; 4 a introduit la syntaxe avec les accolabes pour + accŽder aux caractres d'une cha”ne. Utilisez plut™t le code + ci-dessous : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$a = "abc"; // $a est une cha”ne +$a{1} = "f"; // $a vaut maintenant "afc" +?> +]]> + </programlisting> + </informalexample> + Voyez la section <link linkend="language.types.string.substr">Accs aux caractres d'une cha”ne</link> + pour plus de dŽtails. + </para> </note> <sect2 id="language.types.typecasting"> <title>Transtypage</title> @@ -1928,103 +2142,71 @@ </programlisting> </informalexample> </para> + <note> + <para> + Au lieu de transtyper une variable en cha”ne, vous pouvez aussi + l'insŽrer entre deux guillemets doubles : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$foo = 10; // $foo est un entier +$str = "$foo"; // $str est une cha”ne +$fst = (string) $foo; // $fst est aussi une cha”ne + +// Ceci affiche : "Identique" +if ($fst === $str) { + echo "Identique"; +} +?> +]]> + </programlisting> + </informalexample> + </para> + </note> <para> Le transtypage n'a pas toujours de r&eacute;sultat pr&eacute;visible. Pour plus d'informations, voyez : - </para> <itemizedlist> <listitem> - <simpara> - <link linkend="language.types.boolean.casting">Conversion en bool&eacute;en</link> - </simpara> + <simpara><link linkend="language.types.boolean.casting">Conversion en + boolŽen</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 &agrave; - 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&icirc;ne de caract&egrave;res</link> - </simpara> + <simpara><link linkend="language.types.string.casting">Conversion en + cha”ne de caractres</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&icirc;ne, - entourez la simplement de guillements doubles. - </simpara> - </warning> - <para> - Lors de la conversion d'un tableau en cha&icirc;ne, le r&eacute;sultat sera - le mot <literal>Array</literal> (tableau, en anglais). Lors de la - conversion d'un objet en cha&icirc;ne, le r&eacute;sultat sera le mot - <literal>Object</literal> (objet, en anglais). Dans les deux cas, - une alerte sera affich&eacute;e. - </para> - <para> - Lorsque vous transtypez un scalaire ou une cha&icirc;ne en tableau, - la variable verra son contenu affect&eacute; au premier - &eacute;l&eacute;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&icirc;ne en objet, - la valeur de la variable sera transform&eacute;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 opŽrateurs + arithmŽiques, et non pas celles du lanage C. Par exemple, en Perl + <literal>'Z'+1</literal> devient <literal>'AA'</literal>, tandis que + en langage C <literal>'Z'+1</literal> devient <literal>'['</literal> + ({ ord('Z') == 90, ord('[') == 91 ). + <example> + <title>OpŽrations arithmŽtiques et caractres</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&eacute;d&eacute;finies</title> @@ -117,22 +148,29 @@ </simpara> <warning> <simpara> - En &php; 4.2.0 et plus r&eacute;cent, le jeu de variables pr&eacute;d&eacute;finies qui sont - disponibles dans l'environnement global a chang&eacute;. Les variables - d'entr&eacute;es et de serveurs ne sont plus <emphasis>par d&eacute;faut</emphasis> - plac&eacute;es dans le contexte d'ex&eacute;cution global. Elles sont plac&eacute;es dans - les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. + Depuis la version &php; 4.2.0, la valeur par dŽfaut de la directive &php; + <link linkend="ini.register-globals">register_globals</link> est + <emphasis>off</emphasis>. Ceci est une Žvolution majeure de &php;. + Avoir la directive register_globals ˆ <emphasis>off</emphasis> affecte les + variables prŽdŽfinies du contexte globale. Par exemple, pour lire + <varname>DOCUMENT_ROOT</varname> vous devez utiliser + <varname>$_SERVER['DOCUMENT_ROOT']</varname> au lieu de + <varname>$DOCUMENT_ROOT</varname>, ou bien il faut lire <varname>$_GET['id']</varname> + 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> &agrave; - <literal>On</literal> votre fichier &php.ini;. + Pour des informations liŽes ˆ cette Žvolution, lisez la documentation de la + directive <link linkend="ini.register-globals">register_globals</link>, le chapitre + sur la sŽcritŽ, ˆ propos de l'<link linkend="security.registerglobals">Utilisation des variables super-globales</link>, + ainsi que les annonces de &php; <ulink url="&url.php.release4.1.0;">4.1.0</ulink> + et <ulink url="&url.php.release4.2.0;">4.2.0</ulink>. </simpara> <simpara> - 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 prŽdŽfinies de &php;, comme les + <link linkend="language.variables.superglobals">tableaux superglobaux</link>, + est recommandŽ. </simpara> </warning> <simpara> @@ -148,7 +186,22 @@ conna&icirc;tre le d&eacute;tails de leur contenu, et une pr&eacute;sentation approfondie sur les variables pr&eacute;d&eacute;finies &php;, et leur nature, reportez vous &agrave; la section <link linkend="reserved.variables">variables pr&eacute;definies</link>. + De plus, vous noterez que les anciennes variables prŽdŽfinies + (<varname>$HTTP_*_VARS</varname>) existent toujours. </simpara> + + <note> + <title>Variables variables</title> + <para> + Les superglobales ne peuvent pas tre utilisŽes comme + <link linkend="language.variables.variable">variable variables</link>. + </para> + </note> + + <para> + Si certaines variables de <link linkend="ini.variables-order">variables_order</link> + ne sont pas dŽfinies, leur tableau prŽdŽfini &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 &eacute;l&eacute;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 prŽdŽfinies ne sont pas des "superglobales" et + // requiert le mot clŽ 'global' pour tre disponible dans une fonction. + global $HTTP_POST_VARS; + + print $HTTP_POST_VARS['name']; + + // Les superglobales sont accessibles dans tous les contextes + // et ne requirent pas 'global'. Les superglobales sont disponibles + // depuis PHP 4.1.0 + print $_POST['name']; +} +?> +]]> + </programlisting> + </informalexample> + </para> <simpara> Une autre caract&eacute;ristique importante de la port&eacute;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>, implŽmente les + options <literal>static</literal> et <literal>global</literal> pour les variables, + en terme de rŽfŽrences. Par exemple, une vrai variable globale + est importŽe dans un contexte de fonction avec <literal>global</literal>. + Cette commande crŽe en fait une rŽfŽrence sur la variable globale. Ce + peut vous mener ˆ des comportement inattendus, comme par exemple : + </simpara> + <informalexample> + <programlisting role="php"> +<![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> + ExŽcuter cet exemple vous donnera : + </simpara> + + <screen> +NULL +object(stdClass)(0) { +} + </screen> + + <simpara> + Un comportement similaire s'applique ˆ la commande <literal>static</literal>. + Les rŽfŽrences ne sont pas stockŽes 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 rŽfŽrence ˆ 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> + ExŽcuter 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 problmes rencontrŽs lors de l'assignation + de rŽfŽrence ˆ des variables statiuqes, qui sont + <emphasis>oubliŽes</emphasis> lorsque vous appelez + <literal>&amp;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&eacute;, le &php; va cr&eacute;er la variable - <computeroutput>$nom</computeroutput>, qui contiendra la valeur - que vous avez entr&eacute;e dans le champs <emphasis>Nom:</emphasis> - du formulaire. - </simpara> + + <para> + Suivant votre configuration particulier et vos prŽfŽrences, + vous avez plusieurs mŽthodes pour accŽder aux variables du formulaires. + Voici quelques exemples : + </para> + + <para> + <example> + <title>AccŽder 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 dŽfaut de cette directive est register_globals = off. +// Utiliser ou prŽsumer cette mŽthode est dŽcouragŽ. + + print $username; +?> +]]> + </programlisting> + </example> + </para> + <para> + Utiliser un formulaire de type GET est similaire, hormis le fait que + vpis devez utiliser les variables prŽdŽfinies du GET ˆ la place. + GET s'applique aussi ˆ la QUERY_STRING (les informations disponibles aprs + le '?' dans une URL). De ce fait, par exemple, + <literal>http://www.exemple.com/test.php?id=3</literal> + contient les donnŽes de GET, qui sont accessibles via <varname>$_GET['id']</varname>. + Voyez aussi <link linkend="reserved.variables.request">$_REQUEST</link> et + <function>import_request_variables</function>. + </para> + + <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&eacute;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&eacute;e en <literal>It&#92;'s - &#92;"PHP!&#92;"</literal>. - L'&eacute;chappement est n&eacute;cessaire pour les insertions en base de - donn&eacute;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 activŽe, + une valeur comme celle de (C'est "PHP!") sera magiquement transformŽe en (C\'est \"PHP!\"). + La protection des caractres est nŽcessaire pour l'insertion dans les bases de donnŽes. + Voyez aussi les fonctions <function>addslashes</function>, + <function>stripslashes</function> et <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>. </para> </note> + <simpara> - Le &php; permet aussi l'utilisation des tableaux dans le contexte de - formulaire, mais seulement des tableaux &agrave; une seule dimension. Comme - cela, vous pouvez rassembler des variables ou utiliser cette - fonctionnalit&eacute; pour r&eacute;cup&eacute;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 dŽroulant. + Par exemple, voici un formulaire qui se poste lui mme des donnŽes, + 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&eacute;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&eacute;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&eacute;thodes POST et GET - pourront aussi &ecirc;tre trouv&eacute;es dans le tableau - associatif global $HTTP_POST_VARS ou $HTTP_GET_VARS - suivant la m&eacute;thode utlis&eacute;e. - </simpara> + + <para> + En PHP 3, la syntaxe de tableau HTML est limitŽe aux tableaux + uni-dimensionnels. En PHP 4, ces limitations ont ŽtŽ levŽes. + </para> + <sect3 id="language.variables.external.form.submit"> - <title>Bouton "submit" sous forme d'image</title> + <title>Nom de variables IMAGE SUBMIT</title> + <simpara> - Lorsque vous envoyez le r&eacute;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&eacute;es - de l'endroit o&ugrave; l'utilisateur &agrave; cliqu&eacute;. Les - utilisateurs exp&eacute;riment&eacute;s remarqueront que les noms - de variables sont transmis avec une virgule &agrave; la place du - caract&egrave;re "_", mais &php; fait la conversion - automatiquement. + Lorque l'utilisateur clique sur cette image, le formulaire + associŽ est envoyŽ au serveur, avec deux donnŽes supplŽmentaires, + <varname>sub_x</varname> et <varname>sub_y</varname>. Elles contiennent + les coordonnŽes du clic de l'utilisateur dans l'image. Vous noterez + que ces variables sont envoyŽes par le navigateur avec un point dans leur + nom, mais &php; convertit ces points en soulignŽs. </simpara> </sect3> </sect2>
« previous php.doc.fr (#204) next »