cvs: phpdoc /fr/appendices debugger.xml escaping.xml history.xml http-stuff.xml migration.xml phpdevel.xml regexp.xml

From: Date: Thu, 11 Jan 2001 08:53:17 +0000
Subject: cvs: phpdoc /fr/appendices debugger.xml escaping.xml history.xml http-stuff.xml migration.xml phpdevel.xml regexp.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333559@lists.php.net to get a copy of this message
dams Thu Jan 11 00:53:17 2001 EDT Modified files: /phpdoc/fr/appendices escaping.xml history.xml http-stuff.xml migration.xml phpdevel.xml regexp.xml debugger.xml Log: Good number of Typos. TRUE/FALSE -> <literal>

Index: phpdoc/fr/appendices/escaping.xml diff -u phpdoc/fr/appendices/escaping.xml:1.1 phpdoc/fr/appendices/escaping.xml:1.2 --- phpdoc/fr/appendices/escaping.xml:1.1 Sat Jul 22 03:09:23 2000 +++ phpdoc/fr/appendices/escaping.xml Thu Jan 11 00:53:17 2001 @@ -3,4 +3,3 @@ <sect>URL encoding (GET) <sect>POST method <sect>Escaping for databases - Index: phpdoc/fr/appendices/history.xml diff -u phpdoc/fr/appendices/history.xml:1.1 phpdoc/fr/appendices/history.xml:1.2 --- phpdoc/fr/appendices/history.xml:1.1 Sat Jul 22 03:17:10 2000 +++ phpdoc/fr/appendices/history.xml Thu Jan 11 00:53:17 2001 @@ -1,3 +1,2 @@ <chapt>PHP's history <sect>Overview of PHP's development - Index: phpdoc/fr/appendices/http-stuff.xml diff -u phpdoc/fr/appendices/http-stuff.xml:1.1 phpdoc/fr/appendices/http-stuff.xml:1.2 --- phpdoc/fr/appendices/http-stuff.xml:1.1 Sat Jul 22 03:17:10 2000 +++ phpdoc/fr/appendices/http-stuff.xml Thu Jan 11 00:53:17 2001 @@ -2,4 +2,3 @@ <sect>Setting an expiry date on generated pages <sect>Using phpLastModified <sect>CGI version: why does images break (w/solution) - Index: phpdoc/fr/appendices/migration.xml diff -u phpdoc/fr/appendices/migration.xml:1.3 phpdoc/fr/appendices/migration.xml:1.4 --- phpdoc/fr/appendices/migration.xml:1.3 Fri Dec 8 02:02:38 2000 +++ phpdoc/fr/appendices/migration.xml Thu Jan 11 00:53:17 2001 @@ -5,7 +5,7 @@ <simpara> PHP 3.0 a &eacute;t&eacute; enti&egrave;rement r&eacute;&eacute;crit. Le nouvel analyseur syntaxique est beaucoup plus robuste et coh&eacute;rent qu'en version - 2.0. Il est aussi nettement plus rapide, et utilise encore moins de + 2.0. Il est aussi nettement plus rapide et utilise encore moins de m&eacute;moire. Cependant, ces am&eacute;liorations n'ont pu &ecirc;tre possible qu'au prix de modifications parfois importantes, tant au niveau des syntaxes, qu'au niveau des fonctionnalit&eacute;s. @@ -26,7 +26,7 @@ <simpara> Un programme de conversion automatique de vos vieux script PHP/FI 2.0 existe. Il est disponible dans le dossier de convertisseur de la distribution PHP 3.0. - Ce programme ne fait que rep&eacute;rer les modifications de syntaxe, et ne + Ce programme ne fait que rep&eacute;rer les modifications de syntaxe et ne vous &eacute;pargnera pas une relecture attentive du script. </simpara> </sect1> @@ -35,19 +35,23 @@ <para> La premi&egrave;re chose que vous remarquerez probablement est que les balises de PHP start et end ont chang&eacute;. L'ancienne forme - <literal>&lt;? &gt;</literal> a &eacute;t&eacute; remplac&eacute;e par trois + <literal>&lt;? ?&gt;</literal> a &eacute;t&eacute; remplac&eacute;e par trois nouvelles balises possibles : <example> <title>Migration: Migration: balises start/end </title> - <programlisting> -&lt;? echo "Ceci est du code PHP/FI 2.0.\n"; &gt; + <programlisting role="php"> +&lt;?php +echo "Ceci est du code PHP/FI 2.0.\n";? +?&gt; </programlisting> </example> Comme en version 2.0, PHP/FI accepte aussi cette variante : <example> <title>Migration: premi&egrave;res nouvelles balises PHP</title> - <programlisting> -&lt;? echo "Ceci est du code PHP 3.0!\n"; ?&gt; + <programlisting role="php"> +&lt;?php +echo "Ceci est du code PHP 3.0!\n"; +?&gt; </programlisting> </example> Notez bien que la balise de fin contient d&eacute;sormais un point @@ -58,27 +62,36 @@ suivante a &eacute;t&eacute; ajout&eacute;e : <example> <title>Migration: Nouvelles balises PHP</title> - <programlisting> -&lt;?php echo "Ceci est du code PHP 3.0!\n"; ?&gt; + <programlisting role="php"> +&lt;?php +echo "Ceci est du code PHP 3.0!\n"; +?&gt; </programlisting> </example> - Some people have had problems with editors that don't understand - the processing instruction tags at all. Microsoft FrontPage is one - such editor, and as a workaround for these, the following variation - was introduced as well: - <example><title>Deuxi&egrave;mes nouvelles balises start/end</title> - <programlisting> + Certains d'entre vous rencontrent des probl&egrave;mes avec les &eacute;diteurs qui + ne comprennent pas ce type de balises d'instruction : Microsoft FrontPage + est l'un de ces &eacute;diteurs, et, pour contourner le probl&egrave;me, la + variation suivante a &eacute;t&eacute; introduite : + <example><title>Nouvelles balises PHP</title> + <programlisting role="php"> &lt;script language="php"&gt; echo "Ceci est du code PHP 3.0!\n"; &lt;/script&gt; -</programlisting></example></para></sect1> + </programlisting> + </example> + </para> + </sect1> <sect1 id="migration-if-endif"> <title>if..endif syntax</title> <para> -La syntaxe alternative pour &eacute;crire des instructions if/elseif/else, avec if(); elseif(); else; endif; ne pouvait pas &ecirc;tre conserv&eacute;e sans ajouter beaucoup de complexit&eacute; &agrave; l'analyseur syntaxique. De ce fait, cette syntaxe &agrave; chang&eacute;e : + La syntaxe alternative pour &eacute;crire des instructions if/elseif/else, avec if(); + elseif(); else; endif; ne pouvait pas &ecirc;tre conserv&eacute;e sans ajouter beaucoup + de complexit&eacute; &agrave; l'analyseur syntaxique. De ce fait, cette syntaxe + &agrave; chang&eacute;e : <example> <title>Migration: ancienne syntaxe if..endif </title> - <programlisting> + <programlisting role="php"> +&lt;?php if ($foo); echo "oui\n"; elseif ($bar); @@ -86,11 +99,13 @@ else; echo "non\n"; endif; +?&gt; </programlisting> </example> <example> <title>Migration: nouvelle syntaxe if..endif</title> - <programlisting> + <programlisting role="php"> +&lt;?php if ($foo): echo "oui\n"; elseif ($bar): @@ -98,46 +113,56 @@ else: echo "non\n"; endif; +?&gt; </programlisting> </example> -Notez que les points virgules ont &eacute;t&eacute; remplac&eacute;e par des point dans toutes les commandes, sauf pour la derni&egrave;re expression (endif).</para></sect1> + Notez que les points virgules ont &eacute;t&eacute; remplac&eacute;e par des points dans + toutes les commandes, sauf pour la derni&egrave;re expression (endif). + </para> + </sect1> <sect1 id="migration-while"> <title>while syntax</title> <para> - Tout comme pour if..endif, la syntaxe des boucles while..endwhile a chang&eacute;e - as well: - <example><title>Migration: ancienne syntaxe while..endwhile </title> - <programlisting> + Tout comme pour if..endif, la syntaxe des boucles while..endwhile a chang&eacute;e : + <example> + <title>Migration: ancienne syntaxe while..endwhile </title> + <programlisting role="php"> +&lt;?php while ($more_to_come); ... endwhile; +?&gt; </programlisting> </example> <example><title>Migration: nouvelle syntaxe while..endwhile</title> - <programlisting> + <programlisting role="php"> +&lt;?php while ($more_to_come): ... endwhile; +?&gt; </programlisting> </example> </para> <warning> <simpara> - Attention - Si vous utilisez la vieille syntaxe while..endwhile en PHP 3.0, vous obtiendrez une boucle sans fin ! + Attention : si vous utilisez la vieille syntaxe while..endwhile en PHP 3.0, vous + obtiendrez une boucle sans fin ! </simpara> - </warning></sect1> + </warning> + </sect1> <sect1 id="migration-expr"> <title>Types d'expression</title> <simpara> -PHP/FI 2.0 utilisait le membre &agrave; gauche dans les expressions, pour d&eacute;terminer -le type de r&eacute;sultat attendu. PHP 3.0 prend en compte les deux cot&eacute;s de -l'expression, et cela peut produire des r&eacute;sultats inattendus avec les scripts 2.0. -</simpara> - <simpara></simpara> + PHP/FI 2.0 utilisait le membre &agrave; gauche dans les expressions, pour d&eacute;terminer + le type de r&eacute;sultat attendu. PHP 3.0 prend en compte les deux cot&eacute;s de + l'expression et cela peut produire des r&eacute;sultats inattendus avec les scripts 2.0. + </simpara> <para> -Consid&eacute;rez les lignes suivantes: - <informalexample><programlisting> + Consid&eacute;rez les lignes suivantes: + <informalexample> + <programlisting role="php"> +&lt;?php $a[0]=5; $a[1]=7; $key = key($a); @@ -145,109 +170,171 @@ echo "$keyn"; next($a); } -</programlisting></informalexample> -En PHP/FI 2.0, cet exemple va afficher les indices des $a. -En PHP 3.0, l'exemple ne va rien afficher du tout. La raison est -qu'en PHP 2.0, puisque l'argument de gauche est de type cha&icirc;ne, -une comparaison de cha&icirc;ne &eacute;tait effectu&eacute;, et, effectivement, <literal>""</literal> -n'est pas <literal>""</literal>, ce qui conduit la boucle &agrave; continuer. -En PHP 3, lorsqu'une cha&icirc;ne est compar&eacute;e avec un entier, la comparaison est de -type cha&icirc;ne (la cha&icirc;ne est convertie en entier). -Ce qui revient &agrave; faire la comparaison entre (<literal>atoi("")</literal>) qui vaut <literal>0</literal>, et -la variablelist qui vaut aussi 0, et comme 0==0, -la boucle ne commence m&ecirc;me pas. +?&gt; + </programlisting> + </informalexample> + En PHP/FI 2.0, cet exemple va afficher les indices des $a. + En PHP 3.0, l'exemple ne va rien afficher du tout. La raison est qu'en PHP 2.0, puisque + l'argument de gauche est de type cha&icirc;ne, une comparaison de cha&icirc;ne &eacute;tait + effectu&eacute; et, effectivement, <literal>""</literal> n'est pas <literal>""</literal>, + ce qui conduit la boucle &agrave; continuer. En PHP 3, lorsqu'une cha&icirc;ne est + compar&eacute;e avec un entier, la comparaison est de type cha&icirc;ne (la cha&icirc;ne + est convertie en entier). Ce qui revient &agrave; faire la comparaison entre + (<literal>atoi("")</literal>) qui vaut <literal>0</literal> et la variable + qui vaut aussi 0 et comme 0==0, la boucle ne commence m&ecirc;me pas. </para> <para> La correction de ceci est simple : il suffit de remplacer les commandes while par: - <informalexample><programlisting> + <informalexample> + <programlisting role="php"> +&lt;?php while ((string)$key != "") { -</programlisting></informalexample></para></sect1> +?&gt; + </programlisting> + </informalexample> + </para> + </sect1> <sect1 id="migration-errors"> <title>Les messages d'erreur ont chang&eacute;</title> <simpara> -Les messages d'erreur en PHP 3.0 sont g&eacute;n&eacute;ralement plus pr&eacute;cis que ceux de la version 2.0., mais vous ne verrez plus la portion de code qui a caus&eacute; l'erreur. A la place, un num&eacute;ro de ligne et un nom de fichier sera retourn&eacute;. - </simpara></sect1> + Les messages d'erreur en PHP 3.0 sont g&eacute;n&eacute;ralement plus pr&eacute;cis que + ceux de la version 2.0., mais vous ne verrez plus la portion de code qui a caus&eacute; + l'erreur. A la place, un num&eacute;ro de ligne et un nom de fichier sera retourn&eacute;. + </simpara> + </sect1> <sect1 id="migration-booleval"> <title>Evaluation rapide des bool&eacute;ens </title> + <simpara> + En PHP 3., l' &eacute;valuation des est court-circuit&eacute;. Cela signifie dans une + expression telle que (<literal>(1 || test_me())</literal>), la fonction test_me() + ne sera pas ex&eacute;cut&eacute;e, car cela ne changera pas le r&eacute;sultat. + </simpara> <simpara> -En PHP 3., l' &eacute;valuation des est court circuit&eacute;. Cela signifie dans une expression telle - que (<literal>(1 || test_me())</literal>), la fonction test_me() - ne sera pas ex&eacute;cut&eacute;e, car cela ne changera pas le r&eacute;sultat. </simpara> - <simpara>C'est une am&eacute;lioration mineure, mais qui peut avoir des effets secondaires importants.</simpara></sect1> + C'est une am&eacute;lioration mineure, mais qui peut avoir des effets secondaires importants. + </simpara> + </sect1> <sect1 id="migration-truefalse"> - <title>La valeur true/false comme retour de fonctions</title> + <title>La valeur <literal>TRUE</literal>/<literal>FALSE</literal> comme retour de fonctions</title> <simpara> - La plupart des fonctions internes de PHP ont &eacute;t&eacute; r&eacute;&eacute;crite pour qu'elle retourne TRUE en cas de succ&egrave;s, et FALSE en cas d'erreur, au contraire des fonctions qui retournaient 0 et -1 en PHP/FI 2.0. Le nouveau comportement est beaucoup plus logique, comme par exemple $fp = fopen("/your/file") or fail("fichier non trouv&eacute;!");.Etant donn&eacute; que PHP/FI 2.0 n'a pas de r&egrave;gle claire &agrave; propos de ce que les fonctions doivent retourner en cas d'echec, la plus part des scripts devront probablement &ecirc;tre v&eacute;rifi&eacute; manuellement, apr&egrave;s avoir utilis&eacute; le convertisseur 2.0 &agrave; 3.0. -</simpara> + La plupart des fonctions internes de PHP ont &eacute;t&eacute; + r&eacute;&eacute;crite pour qu'elle retourne <literal>TRUE</literal> en cas de succ&egrave;s, + et <literal>FALSE</literal> en cas d'erreur, au contraire des fonctions qui retournaient 0 et -1 + en PHP/FI 2.0. Le nouveau comportement est beaucoup plus logique, comme par + exemple $fp = fopen("/your/file") or fail("fichier non trouv&eacute;!");. + Etant donn&eacute; que PHP/FI 2.0 n'a pas de r&egrave;gle claire &agrave; + propos de ce que les fonctions doivent retourner en cas d'&eacute;chec, la + plus part des scripts devront probablement &ecirc;tre v&eacute;rifi&eacute; + manuellement, apr&egrave;s avoir utilis&eacute; le convertisseur 2.0 &agrave; + 3.0. + </simpara> <para> <example> - <title>Migration depuis 2.0: valeur retourn&eacute;es, ancienne fa&ccedil;on</title> - <programlisting> + <title> + Migration depuis 2.0: valeur retourn&eacute;es, ancienne fa&ccedil;on + </title> + <programlisting role="php"> +&lt;?php $fp = fopen($file, "r"); if ($fp == -1); echo("Impossible d'ouvrir le fichier $file en lecture &lt;br&gt;\n"); endif; -</programlisting> +?&gt; + </programlisting> </example> <example> <title>Migration depuis 2.0: valeur retourn&eacute;es, nouvelle fa&ccedil;on</title> - <programlisting> + <programlisting role="php"> +&lt;?php $fp = @fopen($file, "r") or print("Impossible d'ouvrir le fichier $file en lecture&lt;br&gt;\n"); -</programlisting> - </example></para></sect1> +?&gt; + </programlisting> + </example> + </para> + </sect1> <sect1 id="migration-other"> <title>Diverses incompatibilit&eacute;s</title> <itemizedlist> - <listitem><simpara> - Le module PHP 3.0 pour Apache n'accepte plus les versions d'Apache ant&eacute;rieure &agrave; la version 1.2. Apache 1.2 ou plus r&eacute;cent est n&eacute;cessaire. -</simpara></listitem> - <listitem><simpara> <function>echo</function> n'utilise plus de cha&icirc;ne de formattage. Il faut utiliser <function>printf</function> &agrave; la place.</simpara></listitem> - <listitem><simpara> -En PHP/FI 2.0, un effet secondaire de l'impl&eacute;mentation faisait que <literal>$foo[0]</literal> - &eacute;tait la m&ecirc;me chose que <literal>$foo</literal>. Ce n'est plus vrai en PHP 3.0. </simpara></listitem> - <listitem><simpara> -Lire un tableau avec $array[] n'est plus valable.</simpara> - <simpara> - Ainsi, il n'est plus possible de passer en revue un tableau avec des -boucles telles que <literal>$data = $array[]</literal>. Utilisez <function>current</function> -et <function>next</function> &agrave; la place. -</simpara> - <simpara> - Ainsi, <literal>$array1[] = $array2</literal> n'ajoute pas les valeurs -de <literal>$array2</literal> &agrave; <literal>$array1</literal>, mais cr&eacute;e un nouvel &eacute;l&eacute;ment -dans <literal>$array1</literal> et y affecte <literal>$array2</literal> comme dernier -&eacute;l&eacute;ment. Voir aussi les tableaux multidimensionnels. -</simpara></listitem> + <listitem> + <simpara> + Le module PHP 3.0 pour Apache n'accepte plus les versions d'Apache ant&eacute;rieure + &agrave; la version 1.2. Apache 1.2 ou plus r&eacute;cent est n&eacute;cessaire. + </simpara> + </listitem> + <listitem> + <simpara> + <function>echo</function> n'utilise plus de cha&icirc;ne de formattage. Il faut + utiliser <function>printf</function> &agrave; la place. + </simpara> + </listitem> <listitem> - <simpara> <literal>"+"</literal> n'est plus utilisable comme op&eacute;rateur de -concat&eacute;nation de cha&icirc;ne. A la place, il converti les arguments en nombres, -et effectue une addition num&eacute;rique. Utilisez <literal>"."</literal> &agrave; la place. -</simpara></listitem> + <simpara> + En PHP/FI 2.0, un effet secondaire de l'impl&eacute;mentation faisait que + <literal>$foo[0]</literal> &eacute;tait la m&ecirc;me chose que + <literal>$foo</literal>. Ce n'est plus vrai en PHP 3.0. + </simpara> + </listitem> + <listitem> + <simpara> + Lire un tableau avec $array[] n'est plus valable. + </simpara> + <simpara> + Ainsi, il n'est plus possible de passer en revue un tableau avec des + boucles telles que <literal>$data = $array[]</literal>. Utilisez + <function>current</function> et <function>next</function> &agrave; la place. + </simpara> + <simpara> + Ainsi, <literal>$array1[] = $array2</literal> n'ajoute pas les valeurs + de <literal>$array2</literal> &agrave; <literal>$array1</literal>, + mais cr&eacute;e un nouvel &eacute;l&eacute;ment dans <literal>$array1</literal> + et y affecte <literal>$array2</literal> comme dernier &eacute;l&eacute;ment. + Voir aussi les tableaux multidimensionnels. + </simpara> + </listitem> + <listitem> + <simpara> + <literal>"+"</literal> n'est plus utilisable comme op&eacute;rateur de + concat&eacute;nation de cha&icirc;ne. A la place, il convertit les + arguments en nombres et effectue une addition num&eacute;rique. + Utilisez <literal>"."</literal> &agrave; la place. + </simpara> + </listitem> </itemizedlist> - <example> - <title>Migration depuis 2.0: concat&eacute;nation de cha&icirc;nes</title> - <programlisting> + <example> + <title>Migration depuis 2.0: concat&eacute;nation de cha&icirc;nes</title> + <programlisting role="php"> +&lt;?php echo "1" + "1"; -</programlisting> - <para> - En PHP 2.0 cela retournerait 11, en PHP 3.0 cela va retourner 2. A la place, faites : - <programlisting> +?&gt; + </programlisting> + <para> + En PHP 2.0 cela retournerait 11, en PHP 3.0 cela va retourner 2. A la place, + fa&icirc;tes : + <programlisting role="php"> +&lt;?php echo "1"."1"; -</programlisting> - <programlisting> +?&gt; + </programlisting> + <programlisting role="php"> +&lt;?php $a = 1; $b = 1; echo $a + $b; -</programlisting></para> - <para> - Cela va afficher 2, tant en PHP 2.0 qu'en 3.0. - <programlisting> +?&gt; + </programlisting> + </para> + <para> + Cela va afficher 2, tant en PHP 2.0 qu'en 3.0. + <programlisting role="php"> +&lt;?php $a = 1; $b = 1; echo $a.$b; -</programlisting> - Cela va afficher 11 en PHP 3.0.</para> - </example></sect1> +?&gt; + </programlisting> + Cela va afficher 11 en PHP 3.0. + </para> + </example> + </sect1> </appendix> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc/fr/appendices/phpdevel.xml diff -u phpdoc/fr/appendices/phpdevel.xml:1.9 phpdoc/fr/appendices/phpdevel.xml:1.10 --- phpdoc/fr/appendices/phpdevel.xml:1.9 Fri Dec 8 02:03:06 2000 +++ phpdoc/fr/appendices/phpdevel.xml Thu Jan 11 00:53:17 2001 @@ -1,7 +1,7 @@ <appendix id="phpdevel"> <title>D&eacute;veloppement PHP</title> <sect1 id="phpdevel-addfunc"> - <title>Adding functions to PHP3</title> + <title>Cr&eacut;er une fonction PHP 3</title> <sect2 id="phpdevel-addfunc-prototype"> <title>Prototypes de fonctions</title> <para> @@ -123,7 +123,8 @@ </row> </tbody> </tgroup> - </table></para> + </table> + </para> <para> Si vous recevez un argument d'un type, te que vous voulez l'utiliser avec un autre type, ou si vous voulez simplement forcer le type, vous @@ -133,8 +134,9 @@ convert_to_double(arg1); convert_to_string(arg1); convert_to_boolean_long(arg1); /* Si la cha&icirc;ne est "" ou "0" elle devient 0, 1 sinon */ -convert_string_to_number(arg1); /* Converti une cha&icirc;ne en LONG ou DOUBLE suivant la cha&icirc;ne */ - </programlisting></para> +convert_string_to_number(arg1); /* Convertit une cha&icirc;ne en LONG ou DOUBLE suivant la cha&icirc;ne */ + </programlisting> + </para> <simpara> Ces fonctions convertissent sur place : elles ne retourne aucune valeur. </simpara> @@ -144,7 +146,9 @@ <listitem><simpara>IS_STRING: arg1-&gt;value.str.val</simpara></listitem> <listitem><simpara>IS_LONG: arg1-&gt;value.lval</simpara></listitem> <listitem><simpara>IS_DOUBLE: arg1-&gt;value.dval</simpara></listitem> - </itemizedlist></para></sect2> + </itemizedlist> + </para> + </sect2> <sect2 id="phpdevel-addfunc-memmgmt"> <title>Gestion de la m&eacute;moire dans une fonction</title> <simpara> @@ -192,7 +196,8 @@ <listitem><simpara>SET_VAR_STRING(name,value)</simpara></listitem> <listitem><simpara>SET_VAR_DOUBLE(name,value)</simpara></listitem> <listitem><simpara>SET_VAR_LONG(name,value)</simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> <para> <footnote id="symtab-1"> <simpara> @@ -219,11 +224,14 @@ <para> <example> <title> - V&eacute;rification de l'existance de $foo dans la table des sympboles + V&eacute;rification de l'existance de <varname>$foo</varname> dans la table des sympboles </title> - <programlisting> -if (hash_exists(active_symbol_table,"foo",sizeof("foo"))) { existe... } -else { n'existe pas } + <programlisting role="php"> +if (hash_exists(active_symbol_table,"foo",sizeof("foo"))) { + // existe... +} else { + // n'existe pas +} </programlisting> </example> <example> @@ -316,14 +324,15 @@ { introuvable... } else { utilisez arr-&gt;value.ht... } - </programlisting></para> + </programlisting> + </para> <simpara> Notez que hash_find recoit un pointeur sur un pointeur sur pval, et pas un pointeur sur pval. </simpara> <simpara> - Toutes les fonctions d'acc&egrave;s aux hash retourne SUCCES (SUCCES) ou - ECHEC (FAILURE), except&eacute; hash_exists(), qui retourne un bool&eacute;en. + Toutes les fonctions d'acc&egrave;s aux hash retourne <literal>TRUE</literal> (SUCCES) ou + <literal>FALSE</literal> (FAILURE), except&eacute; hash_exists(), qui retourne un bool&eacute;en. </simpara> </sect2> <sect2 id="phpdevel-addfunc-retsimple"> @@ -338,8 +347,8 @@ <listitem><simpara>RETURN_FALSE</simpara></listitem> <listitem><simpara>RETURN_TRUE</simpara></listitem> <listitem><simpara>RETURN_LONG(l)</simpara></listitem> - <listitem><simpara>RETURN_STRING(s,dup) Si dup est TRUE, duplique la cha&icirc;ne.</simpara></listitem> - <listitem><simpara>RETURN_STRINGL(s,l,dup) Retourne la cha&icirc;ne (s) en sp&eacute;cifiant la longueur (l).</simpara></listitem> + <listitem><simpara>RETURN_STRING(s,dup) Si dup est <literal>TRUE</literal>, duplique la cha&icirc;ne.</simpara></listitem> + <listitem><simpara>RETURN_STRINGL(s,l,dup) retourne la cha&icirc;ne (s) en sp&eacute;cifiant la longueur (l).</simpara></listitem> <listitem><simpara>RETURN_DOUBLE(d)</simpara></listitem> </itemizedlist> </para> @@ -349,10 +358,11 @@ <listitem><simpara>RETVAL_FALSE</simpara></listitem> <listitem><simpara>RETVAL_TRUE</simpara></listitem> <listitem><simpara>RETVAL_LONG(l)</simpara></listitem> - <listitem><simpara>RETVAL_STRING(s,dup) Si dup est TRUE, duplique la cha&icirc;ne</simpara></listitem> - <listitem><simpara>RETVAL_STRINGL(s,l,dup) Retourne la cha&icirc;ne (s) en sp&eacute;cifiant la longueur (l).</simpara></listitem> + <listitem><simpara>RETVAL_STRING(s,dup) Si dup est <literal>TRUE</literal>, duplique la cha&icirc;ne</simpara></listitem> + <listitem><simpara>RETVAL_STRINGL(s,l,dup) retourne la cha&icirc;ne (s) en sp&eacute;cifiant la longueur (l).</simpara></listitem> <listitem><simpara>RETVAL_DOUBLE(d)</simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> <simpara> Les macros ci dessus vont utiliser estrdup() sur les arguments pass&eacute;s. Cela vous permet de lib&eacute;rer tranquillement les arguments apr&egrave;s @@ -467,7 +477,9 @@ <listitem><simpara>add_next_index_string(return_value,str)</simpara></listitem> <listitem><simpara>add_next_index_stringl(return_value,str,length) - specify the string length</simpara></listitem> - </itemizedlist></para></sect2> + </itemizedlist> + </para> + </sect2> <sect2 id="phpdevel-addfunc-reslist"> <title>Using the resource list</title> <simpara> @@ -644,7 +656,7 @@ <sect2 id="phpdevel-addfunc-addcfg"> <title>Ajouter des directives de configuration &agrave; l'ex&eacute;cution</title> <para> - De nombreuses caract&eacute;ristiques de PHP3 peuvent &ecirc;tre configur&eacute;e + De nombreuses caract&eacute;ristiques de PHP 3 peuvent &ecirc;tre configur&eacute;e &agrave; l'&eacute;x&eacute;cution. Ces directives peuvent apparaitre dans le fichier <filename>php3.ini</filename>, ou, dans le cas du module Apache, dans le fichier <filename>.conf</filename>. L'avantage de l'avoir dans le fichier @@ -661,7 +673,7 @@ <listitem> <simpara> Ajouter la directive &agrave; la structure php3_ini_structure dans le - fichier mod_php3.h. + fichier <filename>mod_php3.h</filename>. </simpara> </listitem> <listitem> @@ -786,10 +798,10 @@ <title>Rapport d'erreurs</title> <simpara> Pour signaler les erreurs d'une fonction interne, vous devez appelez la fonction - php3_error(). Cette fonction prend deux arguments au - moins : le niveau de l'erreur, et le message d'erreur, sous forme de cha&icirc;ne - de caract&egrave;res. Tous les arguments suivants sont des param&egrave;tres de - formats de cha&icirc;ne. Les niveaux d'erreurs sont : + php3_error(). Cette fonction prend deux arguments au moins : le niveau de l'erreur, + et le message d'erreur, sous forme de cha&icirc;ne de caract&egrave;res. Tous les + arguments suivants sont des param&egrave;tres de formats de cha&icirc;ne. Les + niveaux d'erreurs sont : </simpara> <sect2 id="internal.e-notice"> <title>E_NOTICE</title> Index: phpdoc/fr/appendices/regexp.xml diff -u phpdoc/fr/appendices/regexp.xml:1.1 phpdoc/fr/appendices/regexp.xml:1.2 --- phpdoc/fr/appendices/regexp.xml:1.1 Sat Jul 22 03:17:10 2000 +++ phpdoc/fr/appendices/regexp.xml Thu Jan 11 00:53:17 2001 @@ -1,3 +1,2 @@ <chapt>Regular expressions <sect>Short overview to regexps with pointers to more info - Index: phpdoc/fr/appendices/debugger.xml diff -u phpdoc/fr/appendices/debugger.xml:1.3 phpdoc/fr/appendices/debugger.xml:1.4 --- phpdoc/fr/appendices/debugger.xml:1.3 Thu Oct 26 23:55:21 2000 +++ phpdoc/fr/appendices/debugger.xml Thu Jan 11 00:53:17 2001 @@ -1,65 +1,63 @@ <appendix id="debugger"> <title>D&eacute;buggeur PHP</title> - <sect1 id="debugger-using"> <title>Utiliser le d&eacute;buggeur PHP</title> - <para> - Le d&eacute;buggeur PHP sert &agrave; rep&eacute;rer les bugs + Le d&eacute;buggeur PHP sert &agrave; rep&eacute;rer les bugs r&eacute;calcitrants. Le d&eacute;buggeur fonctionne en se - connectant &agrave; un port <acronym>TCP</acronym> &agrave; chaque - d&eacute;marrage de PHP. Tous les messages d'erreur seront + connectant &agrave; un port <acronym>TCP</acronym> &agrave; chaque + d&eacute;marrage de PHP. Tous les messages d'erreur seront envoy&eacute;s sur cette connexion. Cette page est faite pour un - "serveur de d&eacute;buggage", qui peut peut fonctionner avec un + "serveur de d&eacute;buggage", qui peut peut fonctionner avec un <acronym>IDE</acronym> ou un &eacute;diteur programmable (tel que Emacs). </para> <para> - Comment param&eacute;trer le d&eacute;buggeur : + Comment param&eacute;trer le d&eacute;buggeur : <orderedlist> <listitem> - <simpara> - R&eacute;servez un port TCP pour le d&eacute;buggeur dans le fichier - <link linkend="configuration.file">de configuration</link> + <simpara> + R&eacute;servez un port TCP pour le d&eacute;buggeur dans le fichier + <link linkend="configuration.file">de configuration</link> (<link linkend="ini.debugger.port">debugger.port</link>) et activez le (<link linkend="ini.debugger.enabled">debugger.enabled</link>). </simpara> </listitem> <listitem> - <simpara> + <simpara> Configurer un client TCP sur ce port (par exemple <command>socket -l -s 1400</command> sous UNIX). </simpara> </listitem> <listitem> - <simpara> + <simpara> Dans votre code, placez la ligne "debugger_on(<replaceable>host</replaceable>)", o&uacute; <replaceable>host</replaceable> est l'IP ou le nom de l'h&ocirc;te qui supporte le client <acronym>TCP</acronym>. </simpara> </listitem> </orderedlist> - D&eacute;sormais, toutes les alertes, notes, ... seront envoy&eacute;es - sur la socket client, <emphasis>m&ecirc;me si vous avez inactiv&eacute; + D&eacute;sormais, toutes les alertes, notes, ... seront envoy&eacute;es + sur la socket client, <emphasis>m&ecirc;me si vous avez inactiv&eacute; le rapport d'erreur avec <function>error_reporting</function></emphasis>. </para> <note> <para> Le code du d&eacute;ggeur n'a pas &eacute;t&eacute; port&eacute; - en PHP 4.0, au moment de la r&eacute;daction de ce manuel : + en PHP 4.0, au moment de la r&eacute;daction de ce manuel : seule la version 3.0 accepte le d&eacute;buggeur. </para> </note> </sect1> - <sect1 id="debugger-protocol"> <title>Protocole du d&eacute;buggeur</title> <para> - Le protocole de d&eacute;bugage est ligne par ligne. Chaque ligne a un type <emphasis>type</emphasis>, et plusieurs lignes composent un message + Le protocole de d&eacute;bugage est ligne par ligne. Chaque ligne a un type + <emphasis>type</emphasis> et plusieurs lignes composent un message Chaque message commence avec une ligne du type <literal>start</literal> et se - termine avec une ligne de type <literal>end</literal>. PHP peut envoyer des + termine avec une ligne de type <literal>end</literal>. PHP peut envoyer des lignes de plusieurs messages simultan&eacute;ment. </para> <para> - Voici un exemple de ligne &agrave; ce format : + Voici un exemple de ligne &agrave; ce format : <informalexample> <literallayout> <replaceable>date</replaceable> <replaceable>time</replaceable> @@ -90,7 +88,7 @@ <term><replaceable>host</replaceable></term> <listitem> <simpara> - Le nom DNS ou adresse IP de l'h&ocirc;te qui a g&eacute;n&eacute;r&eacute; + Le nom DNS ou adresse IP de l'h&ocirc;te qui a g&eacute;n&eacute;r&eacute; l'erreur. </simpara> </listitem> @@ -99,7 +97,7 @@ <term><replaceable>pid</replaceable></term> <listitem> <simpara> - PID (process id) sur l'h&ocirc;te <replaceable>host</replaceable>, qui a + PID (process id) sur l'h&ocirc;te <replaceable>host</replaceable>, qui a g&eacute;n&eacute;r&eacute; l'erreur. </simpara> @@ -109,7 +107,7 @@ <term><replaceable>type</replaceable></term> <listitem> <para> - Type de la ligne. Indique au programme client comment traiter les + Type de la ligne. Indique au programme client comment traiter les donn&eacute;es suivantes : <table> <title>Types des lignes du D&eacute;buggeur</title> @@ -122,10 +120,10 @@ </thead> <tbody> <row> - <entry><literal>start</literal></entry> + <entry><literal>start</literal></entry> <entry> - Indique au programme client que le message du d&eacute;buggeur - commence ici. Le contenu de <replaceable>data</replaceable> sera un type + Indique au programme client que le message du d&eacute;buggeur + commence ici. Le contenu de <replaceable>data</replaceable> sera un type d'erreur, comme list&eacute; ci dessous. </entry> </row> @@ -136,9 +134,9 @@ <row> <entry><literal>location</literal></entry> <entry> - Nom du fichier, et num&eacute;ro de ligne, o&uacute; l'erreur est + Nom du fichier et num&eacute;ro de ligne, o&uacute; l'erreur est survenue. La premi&egrave;re occurence de <literal>location</literal> - contiendra toujours la localisation g&eacute;n&eacute;rale. + contiendra toujours la localisation g&eacute;n&eacute;rale. <replaceable>data</replaceable> contiendra : <literal><replaceable>file</replaceable>:<replaceable>line</replaceable></literal>. Il y a toujours une indication de <literal>location</literal> @@ -148,24 +146,24 @@ </row> <row> <entry> - <literal>frames</literal></entry> - <entry> - Nombre de frames dans le dump de la pile. Si il y a 4 frames, attendez - vous &agrave; des information sur 4 niveaux de fonctions. Si la ligne - "frame" n'existe pas, la profondeur doit &ecirc;tre 0 (une erreur - est survenue au niveau g&eacute;n&eacute;ral). - </entry> + <literal>frames</literal></entry> + <entry> + Nombre de frames dans le dump de la pile. Si il y a 4 frames, attendez + vous &agrave; des information sur 4 niveaux de fonctions. Si la ligne + "frame" n'existe pas, la profondeur doit &ecirc;tre 0 (une erreur + est survenue au niveau g&eacute;n&eacute;ral). + </entry> </row> <row> <entry> - <literal>function</literal></entry> + <literal>function</literal></entry> <entry> - Nom de la fonction qui a g&eacute;n&eacute;r&eacute; l'erreur. Elle sera + Nom de la fonction qui a g&eacute;n&eacute;r&eacute; l'erreur. Elle sera r&eacute;p&eacute;t&eacute;e &agrave; chaque niveau de la pile d'appel. </entry> </row> <row> - <entry><literal>end</literal></entry> + <entry><literal>end</literal></entry> <entry> Indique au client que le message du d&eacute;buggeur se termine ici. </entry> @@ -183,7 +181,6 @@ </listitem> </varlistentry> </variablelist> - <table> <title>Types d'erreur du d&eacute;buggeur</title> <tgroup cols="2"> @@ -225,7 +222,6 @@ </tbody> </tgroup> </table> - <example> <title>Exemple de message du d&eacute;buggeur</title> <literallayout> @@ -240,9 +236,7 @@ </example> </para> </sect1> - </appendix> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
« previous php.doc (#969333559) next »