cvs: phpdoc /fr/language control-structures.xml
| From: | Damien Seguy | Date: | Tue, 24 Jul 2001 08:33:02 +0000 |
| Subject: | cvs: phpdoc /fr/language control-structures.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336472@lists.php.net to get a copy of this message | ||
dams Tue Jul 24 04:33:02 2001 EDT
Modified files:
/phpdoc/fr/language control-structures.xml
Log:
Adding "declare" entry
Index: phpdoc/fr/language/control-structures.xml diff -u phpdoc/fr/language/control-structures.xml:1.13 phpdoc/fr/language/control-structures.xml:1.14 --- phpdoc/fr/language/control-structures.xml:1.13 Sat Jul 7 18:22:33 2001 +++ phpdoc/fr/language/control-structures.xml Tue Jul 24 04:33:01 2001 @@ -22,7 +22,7 @@ <informalexample> <programlisting role="php"> <?php -if (expression) + if (expression) commandes ?> </programlisting> @@ -42,7 +42,7 @@ <informalexample> <programlisting role="php"> <?php -if ($a > $b) + if ($a > $b) print "a est plus grand que b"; ?> </programlisting> @@ -52,7 +52,7 @@ Souvent, vous voulez que plusieurs instructions soient exécutées après un branchement conditionnel. Bien évidemment, il n'est pas obligatoire de répéter - l'instruction conditonnelle autant de fois que vous avez d'instructions + l'instruction conditionnelle autant de fois que vous avez d'instructions à exécuter. A la place, vous pouvez rassembler toutes les instructions dans un bloc. L'exemple suivant affiche <computeroutput>a est plus grand que b</computeroutput>, et assigne la valeur de la @@ -82,7 +82,7 @@ Souvent, vous voulez exécuter une instruction si une condition est remplie, et une autre instruction si cette condition n'est pas remplie. C'est à cela que sert <literal>else</literal>. - <literal>else</literal> fonctionne avec après un + <literal>else</literal> fonctionne après un <literal>if</literal> et exécute les instructions correspondantes au cas oú l'expression du <literal>if</literal> est &false;. Dans l'exemple suivant, ce bout de code @@ -111,7 +111,7 @@ <title><literal>elseif</literal></title> <para> <literal>elseif</literal>, comme son nom l'indique, est une combinaison - de <literal>if</literal> et <literal>else</literal>. Comme l'expression + de <literal>if</literal> et de <literal>else</literal>. Comme l'expression <literal>else</literal>, il permet d'exécuter une instruction aprè un <literal>if</literal> dans le cas oú le "premier" if est évalué comme &false;. Mais, @@ -156,11 +156,23 @@ <sect1 id="control-structures.alternative-syntax"> <title>Syntaxe alternative</title> <para> + <warning> + <simpara> + Cette syntaxe alternative est obsolète depuis PHP 4. Elle génère + un code qui est tout simplement illisible, et il est très difficile + de la combiner avec la syntaxe normale. Bien que cela ne soit pas + à l'ordre du jour aujourd'hui, cette syntaxe risque de disrparaitre + à terme. Soyez prévenus. + </simpara> + </warning> + </para> + <para> Le PHP propose une autre manière de rassembler des instructions à l'intérieur d'un bloc, pour les fonctions de contrôle <literal>if</literal>, - <literal>while</literal>, <literal>for</literal>, et - <literal>switch</literal>. Dans chaque cas, le principe + <literal>while</literal>, <literal>for</literal>, + <literal>foreach</literal> et <literal>switch</literal>. + Dans chaque cas, le principe est de remplacer l'accolade d'ouverture par deux points (:) et l'accolade de fermeture par, respectivement, <literal>endif;</literal>, <literal>endwhile;</literal>, @@ -289,7 +301,7 @@ est vérifiée au début de chaque itération). </simpara> <para> - Il n'y a qu'un syntaxe possible pour les boucles <literal>do..while</literal>: + Il n'y a qu'une syntaxe possible pour les boucles <literal>do..while</literal>: <informalexample> <programlisting role="php"> <?php @@ -439,22 +451,22 @@ <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 + obtenir le même résultat. Reportez-vous aux exemples de la documentation. </para> </sect1> <sect1 id="control-structures.foreach"> <title><literal>foreach</literal></title> <para> - PHP 4 (mais pas PHP 3) inclus 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: <informalexample> <programlisting role="php"> <?php -foreach(array_expression as $value) commandes -foreach(array_expression as $key => $value) commandes + foreach(array_expression as $value) commandes + foreach(array_expression as $key => $value) commandes ?> </programlisting> </informalexample> @@ -462,10 +474,10 @@ <simpara> La première forme passe en revue le tableau <literal>array_expression</literal>. A chaque itération, - la valeur de l'élément courant est assigné à + la valeur de l'élément courant est assignée à <literal>$value</literal> et le pointeur interne de tableau est avancé d'un élément (ce qui fait qu'à - la prochaîne itération, on accédera à + la prochaine itération, on accédera à l'élément suivant). </simpara> <simpara> @@ -474,25 +486,42 @@ assigné à la variable <literal>$key</literal>. </simpara> <simpara> - Lorsque <literal>foreach</literal> démare, le pointeur interne + Lorsque <literal>foreach</literal> démarre, le pointeur interne de fichier est automatiquement ramené au premier élément du tableau. Cela signifie que vous n'aurez pas à faire appel à <function>reset</function> avant <literal>foreach</literal>. </simpara> + <note> + <para> + De plus, notez que <literal>foreach</literal> travaille sur une copie + du tableau spécifié, et pas sur le tableau lui-même. + Par conséquent, + le pointeur de tableau n'est pas modifié, comme il le serait + avec le fonction <function>each</function>, et les modifications + faites dans le tableau ne seront pas prises en compte dans le + tableau original. + </para> + </note> + <note> + <para> + <literal>foreach</literal> n'accepte pas l'opérateur de supppression + des erreurs <link linkend="language.operators.errorcontrol">@</link>. + </para> + </note> <para> Vous pouvez remarquer que les exemples suivants fonctionnent de manière identique : <informalexample> <programlisting role="php"> <?php -reset($arr); -while (list(, $value) = each ($arr)) { + reset($arr); + while (list(, $value) = each ($arr)) { echo "Valeur: $value<br>\n"; -} -foreach ($arr as $value) { + } + foreach ($arr as $value) { echo "Valeur: $value<br>\n"; -} + } ?> </programlisting> </informalexample> @@ -500,13 +529,13 @@ <informalexample> <programlisting role="php"> <?php -reset($arr); -while (list($key, $value) = each ($arr)) { + reset($arr); + while (list($key, $value) = each ($arr)) { echo "Clé: $key; Valeur: $value<br>\n"; -} -foreach ($arr as $key => $value) { + } + foreach ($arr as $key => $value) { echo "Clé: $key; Valeur: $value<br>\n"; -} + } ?> </programlisting> </informalexample> @@ -516,18 +545,18 @@ <informalexample> <programlisting role="php"> <?php -/* exemple 1: valeur seule */ +/* exemple 1: valeurs seules */ $a = array (1, 2, 3, 17); foreach ($a as $v) { print "Valeur courante de \$a: $v.\n"; } -/* exemple 1: valeur (avec clé associée) */ +/* exemple 2: valeurs (avec la clé correspondante) */ $a = array (1, 2, 3, 17); -$i = 0; /* pour affichage seulement*/ +$i = 0; /* pour l'illustration uniquement */ foreach($a as $v) { print "\$a[$i] => $v.\n"; } -/* exemple 1: valeur et clé */ +/* exemple 3: clé et valeur */ $a = array ( "un" => 1, "deux" => 2, @@ -537,6 +566,20 @@ foreach($a as $k => $v) { print "\$a[$k] => $v.\n"; } +/* exemple 4: tableaux multi-dimensionnels */ +$a[0][0] = "a"; +$a[0][1] = "b"; +$a[1][0] = "y"; +$a[1][1] = "z"; +foreach($a as $v1) { + foreach ($v1 as $v2) { + print "$v2\n"; + } +} +/* exemple 5: tableaux dynamique */ +foreach(array(1, 2, 3, 4, 5) as $v) { + print "$v\n"; +} ?> </programlisting> </informalexample> @@ -546,11 +589,12 @@ <title><literal>break</literal></title> <simpara> L'instruction <literal>break</literal> permet de sortir d'une structure - <literal>for</literal>, <literal>while</literal>, ou <literal>switch</literal>. + <literal>for</literal>, <literal>while</literal>, + <literal>foreach</literal> ou <literal>switch</literal>. </simpara> <simpara> <literal>break</literal> accepte un argument numérique optionnel - qui vous indiquera combien de structures emboîtées ont + qui vous indiquera combien de structures emboitées ont été interrompues. </simpara> <para> @@ -594,7 +638,7 @@ <simpara> <literal>continue</literal> accepte un argument numérique optionnel qui vous indiquera combien de structures - emboîtées ont été ignorées. + emboitées ont été ignorées. </simpara> <para> <informalexample> @@ -703,15 +747,15 @@ exécuter quand même toutes les instructions qui suivent. Si $i est égal à 1, PHP exécutera les deux dernières instructions. Et seulement si $i est - égal à, vous obtiendrez le résultat + égal à 2, vous obtiendrez le résultat escompté, c'est-à-dire, l'affiche de - "i égal 2. Donc, l'important est de ne pas oublier - l'instruction <literal>break</literal> (même si il est + "i égal 2". Donc, l'important est de ne pas oublier + l'instruction <literal>break</literal> (même s'il est possible que vous l'omettiez dans certaines circonstances). </simpara> <simpara> Dans une commande <literal>switch</literal>, une condition n'est - évaluée qu'une fois, est le résultat est + évaluée qu'une fois, et le résultat est comparé à chaque <literal>case</literal>. Dans une structure <literal>elseif</literal>, les conditions sont évaluées à chaque comparaison. Si votre @@ -720,7 +764,7 @@ <literal>switch</literal> sera plus rapide. </simpara> <para> - La liste de commande d'un <literal>case</literal> peut + La liste de commandes d'un <literal>case</literal> peut être vide, auquel cas PHP utilisera la liste de commandes du cas suivant. <informalexample> @@ -768,8 +812,8 @@ Une autre chose à mentionner est que l'instruction <literal>case</literal> peut être une expression à de type scalaire, c'est-à-dire nombre entier, nombre - à virgule flottante et chaîne de caractère. - Les tableaux sont sans interêt dans ce contexte-là. + à virgule flottante et chaîne de caractères. + Les tableaux sont sans intérêt dans ce contexte-là. </para> <para> La syntaxe alternative pour cette structure de contrôle est @@ -778,7 +822,7 @@ <informalexample> <programlisting role="php"> <?php -switch ($i): + switch ($i): case 0: print "i égale 0"; break; @@ -790,16 +834,116 @@ break; default: print "i n'est ni égal à 2, ni à 1, ni à 0"; -endswitch; + endswitch; ?> </programlisting> </informalexample> </para> </sect1> + <sect1 id="control-structures.declare"> + <title><literal>declare</literal></title> + <para> + L'élément de langage <literal>declare</literal> sert à ajouter des + directives d'éxécutions dans un bloc de code. La syntaxe de + <literal>declare</literal> est similaire à la syntaxe des autres + fonctions de contrôle : + <informalexample> + <programlisting> +<?php + declare (directive) statement +?> + </programlisting> + </informalexample> + </para> + <para> + L'expression <literal>directive</literal> permet de contrôler l'intervention + du bloc <literal>declare</literal>. Actuellement, une seule directive + est reconnue : la directive <literal>ticks</literal> (Voir plus bas pour plus + de détails) sur les <link linkend="control-structures.declare.ticks">ticks</link>). + </para> + <para> + L'expression <literal>statement</literal> du bloc de + <literal>declare</literal> sera exécutée. Comment elle sera exécutée, + et quels effets cela aura dépend de la directive utilisée dans le bloc + <literal>directive</literal>. + </para> + <sect2 id="control-structures.declare.ticks"> + <title>Ticks</title> + <para> + Un tick est un événement qui intervient toutes les + <replaceable>N</replaceable> commandes bas niveau, exécutées par l'analyseur + dans le bloc de <literal>declare</literal>. + La valeur de <replaceable>N</replaceable> est spécifiée avec la syntaxe + <literal>ticks=<replaceable>N</replaceable></literal> + dans le bloc de directive <literal>declare</literal>. + </para> + <para> + Un événement qui intervient à chaque tick est spécifié avec la fonction + <function>register_tick_function</function>. Reportez vous à l'exemple + ci-dessous pour plus de détails. Notez que plus d'un événement peut + intervenir par tick. + </para> + <para> + <informalexample> + <programlisting role="php"> +<PRE> +<?php +// Un fonction qui enregistre l'heure à laquelle elle est appelée + function profile($dump = FALSE){ + static $profile; + // Retourne les horaires stockés dans le profile, et l'efface + if ($dump) { + $temp = $profile; + unset ($profile); + return ($temp); + } + $profile[] = microtime (); + } +// Enregistre un gestionnaire de tick + register_tick_function("profile"); +// Initialise la fonction avant le bloc de déclaration + profile(); +// Exécute un bloc de code, et appele un tick toutes les deux secondes + declare (ticks=2) { + for ($x = 1; $x < 50; ++$x) { + echo similar_text(md5($x), md5($x*$x)), "<br>"; + } + } +?> + </programlisting> + </informalexample> + Pour voir le résultat : + <informalexample> + <programlisting role="php"> +<?php +// Affiche les données de la variable $profile + print_r(profile(TRUE)); +?> +</pre> + </programlisting> + </informalexample> + 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 + les ticks sont plus rapides et plus efficaces. + </para> + <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. + </simpara> + <simpara> + Voir aussi + <function>register_tick_function</function> et + <function>unregister_tick_function</function>. + </simpara> + </sect2> + </sect1> <sect1 id="function.require"> <title><function>require</function></title> <simpara> - La commande <function>require</function> se remplace elle même + La commande <function>require</function> se remplace elle-même par le contenu du fichier spécifié, comme les préprocesseurs C le font avec la commande <literal>#include</literal>. </simpara> @@ -814,12 +958,12 @@ </simpara> <simpara> <function>require</function> n'est pas vraiment une fonction PHP : - c'est plus un instruction du langage. Elle ne fonctionne pas comme + c'est plus une instruction du langage. Elle ne fonctionne pas comme les fonctions standards. Par exemple, <function>require</function> - ne peut pas contenir d'autres structures de contrôle. De plus, - il ne retourne aucune valeur. Lire une valeur retournée par un - <function>require</function> retourne une erreur - d'analyse. + est indépendante des structures de contrôle (cela ne sert à rien + de la placer dans une condition, elle sera toujours exécutée). De plus, + elle ne retourne aucune valeur. Lire une valeur retournée par un + <function>require</function> retourne une erreur d'analyse. </simpara> <simpara> Contrairement à <function>include</function>, @@ -847,25 +991,27 @@ <informalexample> <programlisting role="php"> <?php -require ('header.inc'); + require('header.inc'); ?> </programlisting> </informalexample> </para> <para> Attention : <function>include</function> et - <function>require</function> ajoute le contenu du fichier cible - dans le script lui-même. Elle n'utilise pas le protocole + <function>require</function> ajoutent le contenu du fichier cible + dans le script lui-même. Elles n'utilisent pas le protocole HTTP ou tout autre protocole. Toute variable qui est dans le champs du script sera accessible dans le fichier d'inclusion, - et vice versa. + et vice-versa. <informalexample> <programlisting role="php"> <?php -require ("file.inc?varone=1&vartwo=2"); /* Ne fonctionne pas. */ -$varone = 1; -$vartwo = 2; -require ("file.inc"); /* $varone et $vartwo seront accessible à file.inc */ + require ("file.inc?varone=1&vartwo=2"); +/* Ne fonctionne pas. */ + $varone = 1; + $vartwo = 2; + require ("file.inc"); +/* $varone et $vartwo seront accessibles à file.inc */ ?> </programlisting> </informalexample> @@ -879,7 +1025,7 @@ </simpara> <simpara> En PHP 3, il est possible d'exécuter une commande - <literal>return</literal> depuis un fichier inclus, tant + <literal>return</literal> depuis un fichier inclut, tant que cette commande intervient au niveau global du fichier inclus. Elle ne doit intervenir dans aucun bloc (entre accolade {}). En PHP 4, cette possibilité a été @@ -904,9 +1050,9 @@ habituelles de PHP</link>. </simpara> <para> - Cela a lieu à chaque fois que la fonction - <function>include</function> est rencontrée. Donc vous - vous pouvez utiliser la fonction <function>include</function> + Cela se produit à chaque fois que la fonction + <function>include</function> est rencontrée. Donc, vous + pouvez utiliser la fonction <function>include</function> dans une boucle pour inclure un nombre infini de fois un fichier, ou même des fichiers différents. <informalexample> @@ -928,18 +1074,18 @@ <function>require</function> est remplacée par le fichier cible lors de la première exécution, que son contenu soit utilisé - ou non. De plus, cela se fait même si il + ou non. De plus, cela se fait même s'il est placé dans une structure conditionnelle, comme dans un <link linkend="control-structures.if">if</link>). </para> <para> - Parce que la fonction <function>include</function> nécessite + Parceque la fonction <function>include</function> nécessite une construction particulière, vous devez l'inclure dans un - bloc si elle est inclue dans une structure conditionnelle. + bloc si elle est incluse dans une structure conditionnelle. <informalexample> <programlisting role="php"> <?php -/* Ceci est faux, et ne fonctionnera pas ce qu'on attends. */ +/* Ceci est faux, et ne fonctionnera pas comme on l'attend. */ if ($condition) include($file); else @@ -973,7 +1119,7 @@ et est placé dans le même dossier que le fichier principal : <programlisting role="php"> -<?;php +<?php echo "Avant le retour<br>\n"; if (1) { return 27; @@ -985,7 +1131,7 @@ <para> On suppose que le fichier <filename>main.html</filename> contient ceci : <programlisting role="php"> -<?;php +<?php $retval = include ('test.inc'); echo "Fichier inclus: '$retval'<br>\n"; ?> @@ -1007,7 +1153,7 @@ été modifié et contient maintenant le code suivant : <programlisting role="php"> -<?;php +<?php include ('test.inc'); echo "Retour dans le main.html<br>\n"; ?> @@ -1029,7 +1175,7 @@ <para> L'erreur d'analyse ci-dessus est le résultat du fait que la commande <literal>return</literal> est dans un bloc qui n'est pas une fonction, dans - <filename>test.inc</filename>. Lors que le return est sorti du bloc, + <filename>test.inc</filename>. Lorsque le return est sorti du bloc, l'affichage devient : <screen> Avant le retour @@ -1046,8 +1192,8 @@ ou <function>require</function>, les erreurs d'analyse apparaîtront en HTML tout au début du fichier, et l'analyse du fichier 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 habituelle de PHP</link>. + être placé entre + <link linkend="language.basic-syntax.phpmode">les balises habituelles de PHP</link>. <informalexample> <programlisting role="php"> <?php @@ -1066,20 +1212,22 @@ </link> ce qui est au dessus reste vrai. </simpara> <simpara> - Voir aussi <function>readfile</function>, <function>require</function> - et <function>virtual</function>. + Voir aussi + <function>readfile</function>, + <function>require</function> et + <function>virtual</function>. </simpara> </sect1> <sect1 id="function.require-once"> <title><function>require_once</function></title> <para> - La commande <function>require_once</function> se remplace elle même + La commande <function>require_once</function> se remplace elle-même par le fichier spécifié, un peu comme les commandes de préprocesseur C <literal>#include</literal>, et ressemble sur ce point à <function>require</function>. La principale différence est qu'avec <function>require_once</function>, vous êtes assurés que ce code ne sera ajouté - qu'une seule fois, évitant de ce fait les redéfintions de + qu'une seule fois, évitant de ce fait les redéfinitions de variables ou de fonctions, génératrices d'alertes. </para> <para> @@ -1130,7 +1278,7 @@ ?> </programlisting> </example> - Lorsque vous exécutez le script ci dessus, le + Lorsque vous exécutez le script ci-dessus, le résultat sera (sous PHP 4.01pl2): <informalexample> <programlisting> @@ -1142,8 +1290,8 @@ En modifiant <literal>foolib.inc</literal> et <literal>cause_errror_require.php</literal> pour qu'elles utilisent <function>require_once</function> - au lieu de <function>require</function> et ne renommant le fichier - en <literal>avoid_error_require_once.php</literal>, on obtiend : + au lieu de <function>require</function> et ne renommant pas le fichier + en <literal>avoid_error_require_once.php</literal>, on obtient : <example> <title>foolib.inc (corrigé)</title> <programlisting role="php"> @@ -1185,9 +1333,9 @@ </para> <para> Notez aussi que, de la même manière que les - préprocesseur traitent les <literal>#include</literal>, + préprocesseurs traitent les <literal>#include</literal>, cette commande est exécutée au moment de la - compilation, c'est à dire lorsque le script est + compilation, c'est-à-dire lorsque le script est analysée, et avant qu'il soit exécuté, et ne doit pas être utilisée pour insérer des données dynamiques liées à @@ -1210,7 +1358,7 @@ <sect1 id="function.include-once"> <title><function>include_once</function></title> <para> - La commande <function>include_once</function> inclus et + La commande <function>include_once</function> inclut et évalue le fichier spécifié durant l'exécution du script. Le comportement est similaire à <function>include</function>, mais la différence est que si @@ -1223,7 +1371,7 @@ <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 sur qu'il ne sera inclus + ou bien lorsque vous voulez être sûr qu'il ne sera inclus qu'une seule fois, pour éviter des redéfinitions de fonction. </para>
Index: phpdoc/fr/language/control-structures.xml diff -u phpdoc/fr/language/control-structures.xml:1.13 phpdoc/fr/language/control-structures.xml:1.14 --- phpdoc/fr/language/control-structures.xml:1.13 Sat Jul 7 18:22:33 2001 +++ phpdoc/fr/language/control-structures.xml Tue Jul 24 04:33:01 2001 @@ -22,7 +22,7 @@ <informalexample> <programlisting role="php"> <?php -if (expression) + if (expression) commandes ?> </programlisting> @@ -42,7 +42,7 @@ <informalexample> <programlisting role="php"> <?php -if ($a > $b) + if ($a > $b) print "a est plus grand que b"; ?> </programlisting> @@ -52,7 +52,7 @@ Souvent, vous voulez que plusieurs instructions soient exécutées après un branchement conditionnel. Bien évidemment, il n'est pas obligatoire de répéter - l'instruction conditonnelle autant de fois que vous avez d'instructions + l'instruction conditionnelle autant de fois que vous avez d'instructions à exécuter. A la place, vous pouvez rassembler toutes les instructions dans un bloc. L'exemple suivant affiche <computeroutput>a est plus grand que b</computeroutput>, et assigne la valeur de la @@ -82,7 +82,7 @@ Souvent, vous voulez exécuter une instruction si une condition est remplie, et une autre instruction si cette condition n'est pas remplie. C'est à cela que sert <literal>else</literal>. - <literal>else</literal> fonctionne avec après un + <literal>else</literal> fonctionne après un <literal>if</literal> et exécute les instructions correspondantes au cas oú l'expression du <literal>if</literal> est &false;. Dans l'exemple suivant, ce bout de code @@ -111,7 +111,7 @@ <title><literal>elseif</literal></title> <para> <literal>elseif</literal>, comme son nom l'indique, est une combinaison - de <literal>if</literal> et <literal>else</literal>. Comme l'expression + de <literal>if</literal> et de <literal>else</literal>. Comme l'expression <literal>else</literal>, il permet d'exécuter une instruction aprè un <literal>if</literal> dans le cas oú le "premier" if est évalué comme &false;. Mais, @@ -156,11 +156,23 @@ <sect1 id="control-structures.alternative-syntax"> <title>Syntaxe alternative</title> <para> + <warning> + <simpara> + Cette syntaxe alternative est obsolète depuis PHP 4. Elle génère + un code qui est tout simplement illisible, et il est très difficile + de la combiner avec la syntaxe normale. Bien que cela ne soit pas + à l'ordre du jour aujourd'hui, cette syntaxe risque de disrparaitre + à terme. Soyez prévenus. + </simpara> + </warning> + </para> + <para> Le PHP propose une autre manière de rassembler des instructions à l'intérieur d'un bloc, pour les fonctions de contrôle <literal>if</literal>, - <literal>while</literal>, <literal>for</literal>, et - <literal>switch</literal>. Dans chaque cas, le principe + <literal>while</literal>, <literal>for</literal>, + <literal>foreach</literal> et <literal>switch</literal>. + Dans chaque cas, le principe est de remplacer l'accolade d'ouverture par deux points (:) et l'accolade de fermeture par, respectivement, <literal>endif;</literal>, <literal>endwhile;</literal>, @@ -289,7 +301,7 @@ est vérifiée au début de chaque itération). </simpara> <para> - Il n'y a qu'un syntaxe possible pour les boucles <literal>do..while</literal>: + Il n'y a qu'une syntaxe possible pour les boucles <literal>do..while</literal>: <informalexample> <programlisting role="php"> <?php @@ -439,22 +451,22 @@ <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 + obtenir le même résultat. Reportez-vous aux exemples de la documentation. </para> </sect1> <sect1 id="control-structures.foreach"> <title><literal>foreach</literal></title> <para> - PHP 4 (mais pas PHP 3) inclus 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: <informalexample> <programlisting role="php"> <?php -foreach(array_expression as $value) commandes -foreach(array_expression as $key => $value) commandes + foreach(array_expression as $value) commandes + foreach(array_expression as $key => $value) commandes ?> </programlisting> </informalexample> @@ -462,10 +474,10 @@ <simpara> La première forme passe en revue le tableau <literal>array_expression</literal>. A chaque itération, - la valeur de l'élément courant est assigné à + la valeur de l'élément courant est assignée à <literal>$value</literal> et le pointeur interne de tableau est avancé d'un élément (ce qui fait qu'à - la prochaîne itération, on accédera à + la prochaine itération, on accédera à l'élément suivant). </simpara> <simpara> @@ -474,25 +486,42 @@ assigné à la variable <literal>$key</literal>. </simpara> <simpara> - Lorsque <literal>foreach</literal> démare, le pointeur interne + Lorsque <literal>foreach</literal> démarre, le pointeur interne de fichier est automatiquement ramené au premier élément du tableau. Cela signifie que vous n'aurez pas à faire appel à <function>reset</function> avant <literal>foreach</literal>. </simpara> + <note> + <para> + De plus, notez que <literal>foreach</literal> travaille sur une copie + du tableau spécifié, et pas sur le tableau lui-même. + Par conséquent, + le pointeur de tableau n'est pas modifié, comme il le serait + avec le fonction <function>each</function>, et les modifications + faites dans le tableau ne seront pas prises en compte dans le + tableau original. + </para> + </note> + <note> + <para> + <literal>foreach</literal> n'accepte pas l'opérateur de supppression + des erreurs <link linkend="language.operators.errorcontrol">@</link>. + </para> + </note> <para> Vous pouvez remarquer que les exemples suivants fonctionnent de manière identique : <informalexample> <programlisting role="php"> <?php -reset($arr); -while (list(, $value) = each ($arr)) { + reset($arr); + while (list(, $value) = each ($arr)) { echo "Valeur: $value<br>\n"; -} -foreach ($arr as $value) { + } + foreach ($arr as $value) { echo "Valeur: $value<br>\n"; -} + } ?> </programlisting> </informalexample> @@ -500,13 +529,13 @@ <informalexample> <programlisting role="php"> <?php -reset($arr); -while (list($key, $value) = each ($arr)) { + reset($arr); + while (list($key, $value) = each ($arr)) { echo "Clé: $key; Valeur: $value<br>\n"; -} -foreach ($arr as $key => $value) { + } + foreach ($arr as $key => $value) { echo "Clé: $key; Valeur: $value<br>\n"; -} + } ?> </programlisting> </informalexample> @@ -516,18 +545,18 @@ <informalexample> <programlisting role="php"> <?php -/* exemple 1: valeur seule */ +/* exemple 1: valeurs seules */ $a = array (1, 2, 3, 17); foreach ($a as $v) { print "Valeur courante de \$a: $v.\n"; } -/* exemple 1: valeur (avec clé associée) */ +/* exemple 2: valeurs (avec la clé correspondante) */ $a = array (1, 2, 3, 17); -$i = 0; /* pour affichage seulement*/ +$i = 0; /* pour l'illustration uniquement */ foreach($a as $v) { print "\$a[$i] => $v.\n"; } -/* exemple 1: valeur et clé */ +/* exemple 3: clé et valeur */ $a = array ( "un" => 1, "deux" => 2, @@ -537,6 +566,20 @@ foreach($a as $k => $v) { print "\$a[$k] => $v.\n"; } +/* exemple 4: tableaux multi-dimensionnels */ +$a[0][0] = "a"; +$a[0][1] = "b"; +$a[1][0] = "y"; +$a[1][1] = "z"; +foreach($a as $v1) { + foreach ($v1 as $v2) { + print "$v2\n"; + } +} +/* exemple 5: tableaux dynamique */ +foreach(array(1, 2, 3, 4, 5) as $v) { + print "$v\n"; +} ?> </programlisting> </informalexample> @@ -546,11 +589,12 @@ <title><literal>break</literal></title> <simpara> L'instruction <literal>break</literal> permet de sortir d'une structure - <literal>for</literal>, <literal>while</literal>, ou <literal>switch</literal>. + <literal>for</literal>, <literal>while</literal>, + <literal>foreach</literal> ou <literal>switch</literal>. </simpara> <simpara> <literal>break</literal> accepte un argument numérique optionnel - qui vous indiquera combien de structures emboîtées ont + qui vous indiquera combien de structures emboitées ont été interrompues. </simpara> <para> @@ -594,7 +638,7 @@ <simpara> <literal>continue</literal> accepte un argument numérique optionnel qui vous indiquera combien de structures - emboîtées ont été ignorées. + emboitées ont été ignorées. </simpara> <para> <informalexample> @@ -703,15 +747,15 @@ exécuter quand même toutes les instructions qui suivent. Si $i est égal à 1, PHP exécutera les deux dernières instructions. Et seulement si $i est - égal à, vous obtiendrez le résultat + égal à 2, vous obtiendrez le résultat escompté, c'est-à-dire, l'affiche de - "i égal 2. Donc, l'important est de ne pas oublier - l'instruction <literal>break</literal> (même si il est + "i égal 2". Donc, l'important est de ne pas oublier + l'instruction <literal>break</literal> (même s'il est possible que vous l'omettiez dans certaines circonstances). </simpara> <simpara> Dans une commande <literal>switch</literal>, une condition n'est - évaluée qu'une fois, est le résultat est + évaluée qu'une fois, et le résultat est comparé à chaque <literal>case</literal>. Dans une structure <literal>elseif</literal>, les conditions sont évaluées à chaque comparaison. Si votre @@ -720,7 +764,7 @@ <literal>switch</literal> sera plus rapide. </simpara> <para> - La liste de commande d'un <literal>case</literal> peut + La liste de commandes d'un <literal>case</literal> peut être vide, auquel cas PHP utilisera la liste de commandes du cas suivant. <informalexample> @@ -768,8 +812,8 @@ Une autre chose à mentionner est que l'instruction <literal>case</literal> peut être une expression à de type scalaire, c'est-à-dire nombre entier, nombre - à virgule flottante et chaîne de caractère. - Les tableaux sont sans interêt dans ce contexte-là. + à virgule flottante et chaîne de caractères. + Les tableaux sont sans intérêt dans ce contexte-là. </para> <para> La syntaxe alternative pour cette structure de contrôle est @@ -778,7 +822,7 @@ <informalexample> <programlisting role="php"> <?php -switch ($i): + switch ($i): case 0: print "i égale 0"; break; @@ -790,16 +834,116 @@ break; default: print "i n'est ni égal à 2, ni à 1, ni à 0"; -endswitch; + endswitch; ?> </programlisting> </informalexample> </para> </sect1> + <sect1 id="control-structures.declare"> + <title><literal>declare</literal></title> + <para> + L'élément de langage <literal>declare</literal> sert à ajouter des + directives d'éxécutions dans un bloc de code. La syntaxe de + <literal>declare</literal> est similaire à la syntaxe des autres + fonctions de contrôle : + <informalexample> + <programlisting> +<?php + declare (directive) statement +?> + </programlisting> + </informalexample> + </para> + <para> + L'expression <literal>directive</literal> permet de contrôler l'intervention + du bloc <literal>declare</literal>. Actuellement, une seule directive + est reconnue : la directive <literal>ticks</literal> (Voir plus bas pour plus + de détails) sur les <link linkend="control-structures.declare.ticks">ticks</link>). + </para> + <para> + L'expression <literal>statement</literal> du bloc de + <literal>declare</literal> sera exécutée. Comment elle sera exécutée, + et quels effets cela aura dépend de la directive utilisée dans le bloc + <literal>directive</literal>. + </para> + <sect2 id="control-structures.declare.ticks"> + <title>Ticks</title> + <para> + Un tick est un événement qui intervient toutes les + <replaceable>N</replaceable> commandes bas niveau, exécutées par l'analyseur + dans le bloc de <literal>declare</literal>. + La valeur de <replaceable>N</replaceable> est spécifiée avec la syntaxe + <literal>ticks=<replaceable>N</replaceable></literal> + dans le bloc de directive <literal>declare</literal>. + </para> + <para> + Un événement qui intervient à chaque tick est spécifié avec la fonction + <function>register_tick_function</function>. Reportez vous à l'exemple + ci-dessous pour plus de détails. Notez que plus d'un événement peut + intervenir par tick. + </para> + <para> + <informalexample> + <programlisting role="php"> +<PRE> +<?php +// Un fonction qui enregistre l'heure à laquelle elle est appelée + function profile($dump = FALSE){ + static $profile; + // Retourne les horaires stockés dans le profile, et l'efface + if ($dump) { + $temp = $profile; + unset ($profile); + return ($temp); + } + $profile[] = microtime (); + } +// Enregistre un gestionnaire de tick + register_tick_function("profile"); +// Initialise la fonction avant le bloc de déclaration + profile(); +// Exécute un bloc de code, et appele un tick toutes les deux secondes + declare (ticks=2) { + for ($x = 1; $x < 50; ++$x) { + echo similar_text(md5($x), md5($x*$x)), "<br>"; + } + } +?> + </programlisting> + </informalexample> + Pour voir le résultat : + <informalexample> + <programlisting role="php"> +<?php +// Affiche les données de la variable $profile + print_r(profile(TRUE)); +?> +</pre> + </programlisting> + </informalexample> + 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 + les ticks sont plus rapides et plus efficaces. + </para> + <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. + </simpara> + <simpara> + Voir aussi + <function>register_tick_function</function> et + <function>unregister_tick_function</function>. + </simpara> + </sect2> + </sect1> <sect1 id="function.require"> <title><function>require</function></title> <simpara> - La commande <function>require</function> se remplace elle même + La commande <function>require</function> se remplace elle-même par le contenu du fichier spécifié, comme les préprocesseurs C le font avec la commande <literal>#include</literal>. </simpara> @@ -814,12 +958,12 @@ </simpara> <simpara> <function>require</function> n'est pas vraiment une fonction PHP : - c'est plus un instruction du langage. Elle ne fonctionne pas comme + c'est plus une instruction du langage. Elle ne fonctionne pas comme les fonctions standards. Par exemple, <function>require</function> - ne peut pas contenir d'autres structures de contrôle. De plus, - il ne retourne aucune valeur. Lire une valeur retournée par un - <function>require</function> retourne une erreur - d'analyse. + est indépendante des structures de contrôle (cela ne sert à rien + de la placer dans une condition, elle sera toujours exécutée). De plus, + elle ne retourne aucune valeur. Lire une valeur retournée par un + <function>require</function> retourne une erreur d'analyse. </simpara> <simpara> Contrairement à <function>include</function>, @@ -847,25 +991,27 @@ <informalexample> <programlisting role="php"> <?php -require ('header.inc'); + require('header.inc'); ?> </programlisting> </informalexample> </para> <para> Attention : <function>include</function> et - <function>require</function> ajoute le contenu du fichier cible - dans le script lui-même. Elle n'utilise pas le protocole + <function>require</function> ajoutent le contenu du fichier cible + dans le script lui-même. Elles n'utilisent pas le protocole HTTP ou tout autre protocole. Toute variable qui est dans le champs du script sera accessible dans le fichier d'inclusion, - et vice versa. + et vice-versa. <informalexample> <programlisting role="php"> <?php -require ("file.inc?varone=1&vartwo=2"); /* Ne fonctionne pas. */ -$varone = 1; -$vartwo = 2; -require ("file.inc"); /* $varone et $vartwo seront accessible à file.inc */ + require ("file.inc?varone=1&vartwo=2"); +/* Ne fonctionne pas. */ + $varone = 1; + $vartwo = 2; + require ("file.inc"); +/* $varone et $vartwo seront accessibles à file.inc */ ?> </programlisting> </informalexample> @@ -879,7 +1025,7 @@ </simpara> <simpara> En PHP 3, il est possible d'exécuter une commande - <literal>return</literal> depuis un fichier inclus, tant + <literal>return</literal> depuis un fichier inclut, tant que cette commande intervient au niveau global du fichier inclus. Elle ne doit intervenir dans aucun bloc (entre accolade {}). En PHP 4, cette possibilité a été @@ -904,9 +1050,9 @@ habituelles de PHP</link>. </simpara> <para> - Cela a lieu à chaque fois que la fonction - <function>include</function> est rencontrée. Donc vous - vous pouvez utiliser la fonction <function>include</function> + Cela se produit à chaque fois que la fonction + <function>include</function> est rencontrée. Donc, vous + pouvez utiliser la fonction <function>include</function> dans une boucle pour inclure un nombre infini de fois un fichier, ou même des fichiers différents. <informalexample> @@ -928,18 +1074,18 @@ <function>require</function> est remplacée par le fichier cible lors de la première exécution, que son contenu soit utilisé - ou non. De plus, cela se fait même si il + ou non. De plus, cela se fait même s'il est placé dans une structure conditionnelle, comme dans un <link linkend="control-structures.if">if</link>). </para> <para> - Parce que la fonction <function>include</function> nécessite + Parceque la fonction <function>include</function> nécessite une construction particulière, vous devez l'inclure dans un - bloc si elle est inclue dans une structure conditionnelle. + bloc si elle est incluse dans une structure conditionnelle. <informalexample> <programlisting role="php"> <?php -/* Ceci est faux, et ne fonctionnera pas ce qu'on attends. */ +/* Ceci est faux, et ne fonctionnera pas comme on l'attend. */ if ($condition) include($file); else @@ -973,7 +1119,7 @@ et est placé dans le même dossier que le fichier principal : <programlisting role="php"> -<?;php +<?php echo "Avant le retour<br>\n"; if (1) { return 27; @@ -985,7 +1131,7 @@ <para> On suppose que le fichier <filename>main.html</filename> contient ceci : <programlisting role="php"> -<?;php +<?php $retval = include ('test.inc'); echo "Fichier inclus: '$retval'<br>\n"; ?> @@ -1007,7 +1153,7 @@ été modifié et contient maintenant le code suivant : <programlisting role="php"> -<?;php +<?php include ('test.inc'); echo "Retour dans le main.html<br>\n"; ?> @@ -1029,7 +1175,7 @@ <para> L'erreur d'analyse ci-dessus est le résultat du fait que la commande <literal>return</literal> est dans un bloc qui n'est pas une fonction, dans - <filename>test.inc</filename>. Lors que le return est sorti du bloc, + <filename>test.inc</filename>. Lorsque le return est sorti du bloc, l'affichage devient : <screen> Avant le retour @@ -1046,8 +1192,8 @@ ou <function>require</function>, les erreurs d'analyse apparaîtront en HTML tout au début du fichier, et l'analyse du fichier 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 habituelle de PHP</link>. + être placé entre + <link linkend="language.basic-syntax.phpmode">les balises habituelles de PHP</link>. <informalexample> <programlisting role="php"> <?php @@ -1066,20 +1212,22 @@ </link> ce qui est au dessus reste vrai. </simpara> <simpara> - Voir aussi <function>readfile</function>, <function>require</function> - et <function>virtual</function>. + Voir aussi + <function>readfile</function>, + <function>require</function> et + <function>virtual</function>. </simpara> </sect1> <sect1 id="function.require-once"> <title><function>require_once</function></title> <para> - La commande <function>require_once</function> se remplace elle même + La commande <function>require_once</function> se remplace elle-même par le fichier spécifié, un peu comme les commandes de préprocesseur C <literal>#include</literal>, et ressemble sur ce point à <function>require</function>. La principale différence est qu'avec <function>require_once</function>, vous êtes assurés que ce code ne sera ajouté - qu'une seule fois, évitant de ce fait les redéfintions de + qu'une seule fois, évitant de ce fait les redéfinitions de variables ou de fonctions, génératrices d'alertes. </para> <para> @@ -1130,7 +1278,7 @@ ?> </programlisting> </example> - Lorsque vous exécutez le script ci dessus, le + Lorsque vous exécutez le script ci-dessus, le résultat sera (sous PHP 4.01pl2): <informalexample> <programlisting> @@ -1142,8 +1290,8 @@ En modifiant <literal>foolib.inc</literal> et <literal>cause_errror_require.php</literal> pour qu'elles utilisent <function>require_once</function> - au lieu de <function>require</function> et ne renommant le fichier - en <literal>avoid_error_require_once.php</literal>, on obtiend : + au lieu de <function>require</function> et ne renommant pas le fichier + en <literal>avoid_error_require_once.php</literal>, on obtient : <example> <title>foolib.inc (corrigé)</title> <programlisting role="php"> @@ -1185,9 +1333,9 @@ </para> <para> Notez aussi que, de la même manière que les - préprocesseur traitent les <literal>#include</literal>, + préprocesseurs traitent les <literal>#include</literal>, cette commande est exécutée au moment de la - compilation, c'est à dire lorsque le script est + compilation, c'est-à-dire lorsque le script est analysée, et avant qu'il soit exécuté, et ne doit pas être utilisée pour insérer des données dynamiques liées à @@ -1210,7 +1358,7 @@ <sect1 id="function.include-once"> <title><function>include_once</function></title> <para> - La commande <function>include_once</function> inclus et + La commande <function>include_once</function> inclut et évalue le fichier spécifié durant l'exécution du script. Le comportement est similaire à <function>include</function>, mais la différence est que si @@ -1223,7 +1371,7 @@ <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 sur qu'il ne sera inclus + ou bien lorsque vous voulez être sûr qu'il ne sera inclus qu'une seule fois, pour éviter des redéfinitions de fonction. </para>