@@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?>  - +  <sect1 xml:id="control-structures.do.while" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -74,10 +74,12 @@ do { </informalexample> </para> <simpara> - Ne vous inquiétez pas si vous ne comprenez - pas tout correctement. Vous pouvez écrire des scripts - très très puissants sans utiliser + Ne vous inquiétez pas si vous ne comprenez pas tout correctement. + Vous pouvez écrire des scripts très très puissants sans utiliser cette fonctionnalité. + Depuis PHP 5.3.0, il est possible d'utiliser l'opérateur + <link linkend="control-structures.goto"><literal>goto</literal></link> + à l'intérieur de cette fonctionnalité. </simpara> </sect1> language/control-structures/do-while.xml @@ -1,21 +1,21 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="utf-8"?>  - +  <sect1 xml:id="function.require" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title><function>require</function></title> <para> - <function>require</function> est identique à <function>include</function> - mise à part le fait que lorsqu'une erreur survient, il produit + <function>require</function> est identique Ã <function>include</function> + mise Ã part le fait que lorsqu'une erreur survient, il produit Ã©galement une erreur fatale de type <constant>E_ERROR</constant>. En d'autres termes, - il stoppera le script alors que <function>include</function> n'émettra qu'une + il stoppera le script alors que <function>include</function> n'Ã©mettra qu'une alerte de type <constant>E_WARNING</constant>, ce qui permet au script de continuer. </para> <para> - Voir la documentation de <function>include</function> pour en connaître son + Voir la documentation de <function>include</function> pour en connaÃ®tre son fonctionnement. </para> language/control-structures/require.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - +  <sect1 xml:id="function.return" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -39,6 +39,14 @@ </note> <note> <simpara> + Si aucun paramètre n'est fourni, alors les parenthèses peuvent être + omises et &null; sera retourné. L'appel à la fonction + <function>return</function> avec des parenthèses mais sans argument + résultera en une alerte d'analyse. + </simpara> + </note> + <note> + <simpara> Vous ne devriez <emphasis>jamais</emphasis> utiliser les parenthèses autour de la variable retournée lorsque vous la retournez pas référence, car cela ne fonctionnera pas. Vous ne pouvez retourner que les variables par @@ -62,7 +70,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil language/control-structures/return.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - +  <refentry xml:id="function.apc-fetch" xmlns="http://docbook.org/ns/docbook"> @@ -14,7 +14,7 @@ &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>apc_fetch</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>mixed</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter role="reference">success</parameter></methodparam> </methodsynopsis> <para> @@ -30,7 +30,8 @@ <listitem> <para> La clé <parameter>key</parameter> utilisée pour stocker la valeur (avec - <function>apc_store</function>). + <function>apc_store</function>). Si un tableau est passé, chaque élément + sera récupéré et retourné. </para> </listitem> </varlistentry> @@ -48,7 +49,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - La variable stockée en cas de succès, &false; si une erreur survient. + La variable stockée ou les variables du tableau en cas de succès, &false; + si une erreur survient. </para> </refsect1> @@ -99,7 +101,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/apc/functions/apc-fetch.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - - + + <refentry xml:id="function.array-merge" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -177,28 +177,39 @@ Array ]]> </screen> <para> - Si vous voulez préserver complètement les tableaux, et que - vous souhaitez simplement les fusionner les uns aux autres, - utilisez l'opérateur <literal>+</literal> : + Si vous voulez ajouter des éléments du second tableau au premier + sans pour autant écraser ou ré-indexer les éléments du premier, + utilisez l'opérateur d'union <literal>+</literal> : </para> <programlisting role="php"> <![CDATA[ <?php -$array1 = array(); -$array2 = array(1 => "data"); +$array1 = array(0 => 'zero_a', 2 => 'two_a', 3 => 'three_a'); +$array2 = array(1 => 'one_b', 3 => 'three_b', 4 => 'four_b'); $result = $array1 + $array2; +var_dump($result); ?> ]]> </programlisting> <para> - Les index numériques seront préservés. D'où le résultat : + Les clés du premier tableau sont préservées. Si une clé existe + dans les 2 tableaux, alors l'élément du premier sera utilisé + et la clé correspondante du second sera ignorée. </para> <screen role="php"> <![CDATA[ -Array -( - [1] => data -) +array(5) { + [0]=> + string(6) "zero_a" + [2]=> + string(5) "two_a" + [3]=> + string(7) "three_a" + [1]=> + string(5) "one_b" + [4]=> + string(6) "four_b" +} ]]> </screen> </example> @@ -228,7 +239,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/array/functions/array-merge.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?>  - +  <refentry xml:id="function.array-multisort" xmlns="http://docbook.org/ns/docbook"> @@ -12,7 +12,7 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>array_multisort</methodname> - <methodparam><type>array</type><parameter>arr</parameter></methodparam> + <methodparam><type>array</type><parameter role="reference">arr</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter><initializer>SORT_ASC</initializer></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>arg</parameter><initializer>SORT_REGULAR</initializer></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> @@ -305,7 +305,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/array/functions/array-multisort.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - +  <refentry xml:id="function.end" xmlns="http://docbook.org/ns/docbook"> @@ -28,7 +28,11 @@ <term><parameter>array</parameter></term> <listitem> <para> - Le tableau. + Le tableau. Ce tableau est passé par référence car il sera + modifié par la fonction. Cela signifie que vous devez passer + une vraie variable et non une fonction retournant un tableau, + car actuellement, seules les variables peuvent être passées + par référence. </para> </listitem> </varlistentry> @@ -84,7 +88,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/array/functions/end.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?>  - +  <refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook"> @@ -254,7 +254,8 @@ blue, large, sphere, medium <warning> <para> N'utilisez pas <function>extract</function> sur des données inconnues, comme - les données utilisateurs (<varname>$_GET</varname>, etc). + les données utilisateurs (i.e. <varname>$_GET</varname>, + <varname>$_FILES</varname>, etc.). Si vous le faites, par exemple, pour rendre compatible un vieux code avec <link linkend="security.globals">register_globals</link> à Off de façon temporaire, assurez-vous d'utiliser l'une des constantes @@ -265,6 +266,90 @@ blue, large, sphere, medium linkend="ini">&php.ini;</link>. </para> </warning> + <note> + <para> + Si vous avez la directive + <link linkend="security.globals">register_globals</link> d'activée + et que vous utilisez la fonction <function>extract</function> + sur les variables <varname>$_FILES</varname> et que vous spécifiez + la constante <constant>EXTR_SKIP</constant>, vous pourriez être surpris + du résultat. + </para> + <warning> + <para> + Cette façon de faire n'est pas recommandée et est uniquement documentée + ici pour bien comprendre le comportement. + L'utilisation de la directive + <link linkend="security.globals">register_globals</link> est obsolète + et appeler la fonction <function>extract</function> sur des données + partagées comme les variables <varname>$_FILES</varname> est, comme mentionné + ci-dessus, un risque potentiel pour la sécurité. Si vous rencontrez + ce problème, cela signifie que vous avez écrit votre code de la mauvaise + manière pour au moins 2 raisons. + </para> + </warning> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Supposez que $testfile est le nom d'un champ de téléchargement de fichier + et que register_globals est actif. */ + +var_dump($testfile); +extract($_FILES, EXTR_SKIP); +var_dump($testfile); +var_dump($testfile['tmp_name']); + +?> +]]> + </programlisting> + <simpara> + Vous vous attendez à voir quelque chose comme : + </simpara> + <screen> +<![CDATA[ +string(14) "/tmp/phpgCCPX8" +array(5) { + ["name"]=> + string(10) "somefile.txt" + ["type"]=> + string(24) "application/octet-stream" + ["tmp_name"]=> + string(14) "/tmp/phpgCCPX8" + ["error"]=> + int(0) + ["size"]=> + int(4208) +} +string(14) "/tmp/phpgCCPX8" +]]> + </screen> + <simpara> + Cependant, vous devriez plutôt voir quelque comme : + </simpara> + <screen> +<![CDATA[ +string(14) "/tmp/phpgCCPX8" +string(14) "/tmp/phpgCCPX8" +string(1) "/" +]]> + </screen> + <para> + Ceci est dû au fait que, depuis que la directive + <link linkend="security.globals">register_globals</link> est ative, + la variable <varname>$testfile</varname> existe déjà dans le scope global + lorsque la fonction <function>extract</function> est appelée. + Et vû que la constante <constant>EXTR_SKIP</constant> est spécifiée, + la variable <varname>$testfile</varname> n'est pas écrasée avec le contenu + du tableau <constant>$_FILES</constant>, aussi, la variable + <varname>$testfile</varname> reste une &string;. + Parceque les <link linkend="language.types.string.substr">chaînes de caractères + peuvent être accédées en utilisant la synthaxe des tableaux</link> + et que la &string; non-numérique <literal>tmp_name</literal> est interprétée + comme <literal>0</literal>, PHP voit <varname>$testfile['tmp_name']</varname> + comme <varname>$testfile[0]</varname>. + </para> + </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; @@ -287,7 +372,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/array/functions/extract.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - +  <refentry xml:id="function.key" xmlns="http://docbook.org/ns/docbook"> @@ -37,7 +37,12 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne l'index. + La fonction <function>key</function> retourne simplement la clé + de l'élément du tableau qui est actuellement pointée par le pointeur + interne. Cette fonction ne modifie en aucun cas la position de ce pointeur. + Si le pointeur interne pointe un élément se situant après la fin de la liste + des éléments, ou bien si le tableau est vide, la fonction + <function>key</function> retournera &null;. </para> </refsect1> <refsect1 role="examples"> @@ -99,7 +104,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/array/functions/key.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - +  <refentry xml:id="function.bzopen" xmlns="http://docbook.org/ns/docbook"> @@ -36,8 +36,10 @@ <term><parameter>mode</parameter></term> <listitem> <para> - Similaire à la fonction <function>fopen</function> ('r' pour lecture, 'w' pour - écriture, etc.). + Similaire à la fonction <function>fopen</function>, + seules les options 'r' (pour lecture), et 'w' (pour écriture) + sont supportées. Tout autre option fera que la fonction + retournera &false;. </para> </listitem> </varlistentry> @@ -92,7 +94,7 @@ sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil reference/bzip2/functions/bzopen.xml 9ba77de9bdb1146558618e54ed6e00ff6b73f822 yannick yannick@c90b9560-bf6c-de11-be94-00142212c4b1 http://github.com/php/phpdoc-fr/commit/00ac07aded63470c3b65fb8f372ca32e5e80e79c 00ac07aded63470c3b65fb8f372ca32e5e80e79c

2009-11-08T11:09:11-08:00

sync with EN git-svn-id: file:///export/home/dsp/dev/test/php-svn/phpdoc/fr/trunk@290402 c90b9560-bf6c-de11-be94-00142212c4b1 315093f739acab310a95254de29dde1ad0955605 yannick yannick@c90b9560-bf6c-de11-be94-00142212c4b1