cvs: phpdoc-fr /appendices about.xml aliases.xml debugger.xml history.xml migration.xml migration4.xml phpdevel.xml reserved.xml resources.xml
tokens.xml

From: Date: Fri, 07 Feb 2003 18:11:30 +0000
Subject: cvs: phpdoc-fr /appendices about.xml aliases.xml debugger.xml history.xml migration.xml migration4.xml phpdevel.xml reserved.xml resources.xml
tokens.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-240@lists.php.net to get a copy of this message
dams Fri Feb 7 13:11:30 2003 EDT Modified files: /phpdoc-fr/appendices about.xml aliases.xml debugger.xml history.xml migration.xml migration4.xml phpdevel.xml reserved.xml resources.xml tokens.xml Log: Keeping up

Index: phpdoc-fr/appendices/about.xml diff -u phpdoc-fr/appendices/about.xml:1.4 phpdoc-fr/appendices/about.xml:1.5 --- phpdoc-fr/appendices/about.xml:1.4 Thu Feb 6 19:51:06 2003 +++ phpdoc-fr/appendices/about.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- TODO: add manual conventions section (eg. how to read @@ -75,7 +75,8 @@ IDE sous Windows fournissent des liens avec ce format pour une meilleure int&eacute;gration. </para> - <note> +<!-- +<note> <para> Un projet de Visual Basic pour Linux a d&eacute;but&eacute;, et il incluera un cr&eacute;ateur de format CHM Creator et Viewer for Linux. Voyez leur @@ -83,6 +84,7 @@ vous interesse. </para> </note> + --> </sect1> <sect1 id="about.notes"> @@ -104,6 +106,157 @@ </para> </note> </sect1> + + + <sect1 id="about.prototypes"> + <title>Comment lire la d&eacute;finition d'une fonction (prototype)</title> + <para> + Chaque fonction est document&eacute;e pour permettre un acc&egrave;s rapide, + et savoir d&eacute;coder le manuel rendra votre lecture plus facile. Plut&ocirc;t + que de d&eacute;pendre d'exemples pr&ecirc;ts en copier/coller, il est mieux de + savoir lire la d&eacute;finition d'une fonction. Voici comment : + </para> + <note> + <title> + Pr&eacute;-requis : Connaissances de bases des <link linkend="language.types">types</link>. + </title> + <para> + Bien que &php; soit un langage sans typage fort, une connaissance + de base des <link linkend="language.types">types</link> est essentielle, + car ils ont quand m&ecirc;me des sens importants. + </para> + </note> + <para> + Les d&eacute;finitions de fonctions vous indique quel type de donn&eacute;es est + <link linkend="functions.returning-values">retourn&eacute;</link>. Examinons + la fonction <function>strlen</function> comme exemple : + </para> + <para> + <screen role="html"> +strlen + +PHP 3, PHP 4 + +int Êstrlen ( string Ê str ) + +strlen retourne la taille de la cha&icirc;ne string . + </screen> + </para> + <para> + <table> + <title>Explications de la d&eacute;finition de la fonction</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Partie</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + strlen + </entry> + <entry> + Le nom de la fonction. + </entry> + </row> + <row> + <entry> + (PHP 3, PHP 4) + </entry> + <entry> + strlen() est pr&eacute;sente dans toutes les versions de PHP 3 et PHP 4. + </entry> + </row> + <row> + <entry> + int + </entry> + <entry> + Type de valeur retourn&eacute; par cette fonction, qui est en l'occurence + un &integer; (i.e. la taille d'une cha&icirc;ne est mesur&eacute;e par un nombre). + </entry> + </row> + <row> + <entry> + ( string str ) + </entry> + <entry> + Le premier (et ici le seul) param&egrave;tre &agrave; fournir &agrave; strlen est le param&egrave;tre + <parameter>str</parameter>, qui doit &ecirc;tre du type &string;. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Nous pourrions r&eacute;&eacute;crire ce prototype avec une version plus g&eacute;n&eacute;rique : + </para> + <para> + <screen role="html"> + type_retourn&eacute; nom_de_la fonction ( type_du_param&egrave;tre nom_du_param&egrave;tre ) + </screen> + </para> + <para> + Plusieurs fonctions ont besoin de plusieurs param&egrave;tres, comme par exemple <function>in_array</function>. + Son prototype est le suivant : + </para> + <para> + <screen role="html"> + bool in_array ( mixed needle, array haystack [, bool strict]) + </screen> + </para> + <para> + Qu'est ce que cela signifie? <function>in_array</function> retourne + un &boolean; &true; en cas de r&eacute;ussite ( le param&egrave;tre + <parameter>needle</parameter> a &eacute;t&eacute; trouv&eacute; dans le tableau + <parameter>haystack</parameter>) ou &false; en cas d'&eacute;chec + ( le param&egrave;tre <parameter>needle</parameter> n'a pas &eacute;t&eacute; trouv&eacute; + dans le tableau <parameter>haystack</parameter>). Le premier + param&egrave;tre s'appelle <parameter>needle</parameter> et il peut &ecirc;tre + de diff&eacute;rents <link linkend="language.types">types</link> : il porte + donc la mention <emphasis>mixed</emphasis>. Le param&egrave;tre <parameter>needle</parameter> + (ce que nous recherchons) peut &ecirc;tre une valeur scalaire ( &string;, &integer;, + ou &float;), ou encore un &array;. + <parameter>haystack</parameter> (le &array; dans lequel nous recherchons) est + le second param&egrave;tre. Le troisi&egrave;me param&egrave;tre, <parameter>strict</parameter>, + est optionnel. Tous les param&egrave;tres optoinnels sont plac&eacute;s entre crochets. + La manuel indique que le param&egrave;tre <parameter>strict</parameter> vaut par d&eacute;faut + &false;. Reportez-vous au manuel de chaque fonction pour savoir comment elle fonctionne. + </para> + </sect1> + + <sect1 id="about.phpversions"> + <title>Versions de PHP documment&eacute;es dans ce manuel</title> + <para> + Cette documentation contient des informations sur PHP 4, avec + des notes compatibilit&eacute;s et de migration depuis PHP 3. Le comportement, + les param&egrave;tres, les valeurs retourn&eacute;es, etc... qui ont chang&eacute; entre + deux versions du manuel &php; sont document&eacute;es dans les notes utilisateurs, + et dasn le manuel lui m&ecirc;me. + </para> + <para> + Vous pouvez trouvez des portions de documentation destin&eacute;es aux + versions CVS de PHP, ce qui signifie que les toutes derni&egrave;res versions + de d&eacute;veloppement de PHP proposent ces fonctionnalit&eacute;s. Si vous n'&ecirc;tes + pas un d&eacute;veloppeur PHP, et que vous n'avez pas la possibilit&eacute; d'utiliser + la derni&egrave;re version de PHP, les fonctionnalit&eacute;s indiqu&eacute;es comme + "disponibles uniquement en CVS" ne vous seront pas accessibles. Toutes fois, + ces fonctionnalit&eacute;s seront surement disponible dans la prochaine version + stable de PHP. Si vous voulez obtenir une version des derniers sources + de PHP, passez par <ulink url="&url.php.anoncvs;">le serveur CVS anonyme</ulink>. + </para> + <para> + Vous pouvez aussi rencontrer de la documentation qui est disponible pour + une version de PHP qui n'est pas encore publi&eacute;e (par exemple, des fonctions + destin&eacute;es &agrave; la version PHP 4.3.0, alors que la version publique actuelle + est PHP 4.2.3). La plus part du temps, ce n'est pas une erreur de documentation, + mais une indication sur les fonctionnalit&eacute;s qui seront disponible avec la + prochaine publication de PHP. + </para> + </sect1> <sect1 id="about.more"> <title>O&ugrave; trouver plus d'information sur PHP?</title> @@ -247,6 +400,23 @@ </para> </sect1> + <sect1 id="about.translations.fr"> + <title>Traduction fran&ccedil;aise</title> + <para> + La version fran&ccedil;aise est traduite quotidiennement et disponible + chez Nexen (<ulink url="&url.nexen;">nexen.net/</ulink>). + Ce manuel a &eacute;t&eacute; g&eacute;n&eacute;r&eacute; &agrave; partir de + la documentation originale en anglais du PHP Documentation Group, au + format XML. Elle est 100% compatible avec le syst&egrave;me de g&eacute;n&eacute;ration + du groupe PHP. Elle est trait&eacute; avec un syst&egrave;me d&eacute;velopp&eacute; par + Nexen pour produire divers autres formats. + </para> + <para> + Pour les probl&egrave;mes li&eacute;s &agrave; la traduction, vous pouvez + contacter directement l'&eacute;diteur de ce manuel + <ulink url="mailto:&email.dams;">&email.dams;</ulink>. + </para> + </sect1> </appendix> <!-- Keep this comment at the end of the file Index: phpdoc-fr/appendices/aliases.xml diff -u phpdoc-fr/appendices/aliases.xml:1.5 phpdoc-fr/appendices/aliases.xml:1.6 --- phpdoc-fr/appendices/aliases.xml:1.5 Thu Aug 22 15:59:17 2002 +++ phpdoc-fr/appendices/aliases.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <appendix id="aliases"> <title>Liste d'alias</title> <para> @@ -15,7 +15,9 @@ syntaxes plus r&eacute;centes. </para> <para> - Cette liste est en phase avec PHP 4.0.6. + Cette liste est en phase avec PHP 4.0.6. Pour une liste d'alias + qui soit mise &agrave; jour quotidiennement, voyez + <ulink url="&url.zend.aliaslist;">le site de Zend</ulink>. </para> <para> <table> Index: phpdoc-fr/appendices/debugger.xml diff -u phpdoc-fr/appendices/debugger.xml:1.13 phpdoc-fr/appendices/debugger.xml:1.14 --- phpdoc-fr/appendices/debugger.xml:1.13 Fri Aug 23 14:31:16 2002 +++ phpdoc-fr/appendices/debugger.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <appendix id="debugger"> <title>D&eacute;buggeur PHP</title> <sect1 id="debugger-about"> @@ -9,8 +9,15 @@ </simpara> <simpara> PHP 4 n'inclut aucun support de d&eacute;buggage. + Vous pouvez toutes fois utiliser un des d&eacute;bogeur externe. + Le <ulink url="&url.zend.ide;">Studio Zend</ulink> inclut + un d&eacute;bogeur et il y a aussi des d&eacute;bogeurs gratuits comme + <ulink url="&url.dbg;">&url.dbg;</ulink>, le + <ulink url="&url.apd;">Advanced PHP Debugger</ulink> (APD) ou + <ulink url="&url.xdebug;">Xdebug</ulink> </simpara> </sect1> + <sect1 id="debugger-using"> <title>Utiliser le d&eacute;buggeur PHP</title> <para> Index: phpdoc-fr/appendices/history.xml diff -u phpdoc-fr/appendices/history.xml:1.8 phpdoc-fr/appendices/history.xml:1.9 --- phpdoc-fr/appendices/history.xml:1.8 Sun Feb 10 23:37:45 2002 +++ phpdoc-fr/appendices/history.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <appendix id="history"> <title>Histoire de PHP</title> @@ -134,6 +134,14 @@ L'&eacute;quipe de d&eacute;veloppement de PHP inclue des douzaines de d&eacute;veloppeurs, et d'autres &eacute;quipes travaillent &agrave; des projets li&eacute;s tels que PEAR ou la documentation. + </para> + </sect2> + <sect2 id="history.php5"> + <title>PHP 5</title> + <para> + Le futur de &php; est essentiellement constitu&eacute; par son coeur, le Zend Engine. + PHP 5 incluera la nouvelle version du Zend Engine 2.0. Pour plus d'informations + sur ce moteur, <ulink url="&url.zend.future;">voyez sa page web</ulink>. </para> </sect2> </sect1> Index: phpdoc-fr/appendices/migration.xml diff -u phpdoc-fr/appendices/migration.xml:1.13 phpdoc-fr/appendices/migration.xml:1.14 --- phpdoc-fr/appendices/migration.xml:1.13 Thu Aug 22 15:59:17 2002 +++ phpdoc-fr/appendices/migration.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <appendix id="migration"> <title>Migration de PHP/FI 2.0 &agrave; PHP 3.0</title> <sect1 id="migration.about"> @@ -42,18 +42,22 @@ <example> <title>Migration: Migration: balises start/end </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?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 role="php"> -&lt;?php +<![CDATA[ +<?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 @@ -65,9 +69,11 @@ <example> <title>Migration: Nouvelles balises PHP</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php echo "Ceci est du code PHP 3.0!\n"; -?&gt; +?> +]]> </programlisting> </example> Certains d'entre vous rencontrent des probl&egrave;mes avec les &eacute;diteurs qui @@ -76,9 +82,12 @@ variation suivante a &eacute;t&eacute; introduite : <example><title>Nouvelles balises PHP</title> <programlisting role="php"> -&lt;script language="php"&gt; +<![CDATA[ +<script language="php"> echo "Ceci est du code PHP 3.0!\n"; -&lt;/script&gt; +</script> +]]> + </programlisting> </example> </para> @@ -93,7 +102,8 @@ <example> <title>Migration: ancienne syntaxe if..endif </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php if ($foo); echo "oui\n"; elseif ($bar); @@ -101,13 +111,15 @@ else; echo "non\n"; endif; -?&gt; +?> +]]> </programlisting> </example> <example> <title>Migration: nouvelle syntaxe if..endif</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php if ($foo): echo "oui\n"; elseif ($bar): @@ -115,7 +127,8 @@ else: echo "non\n"; endif; -?&gt; +?> +]]> </programlisting> </example> Notez que les points virgules ont &eacute;t&eacute; remplac&eacute;e par des points dans @@ -129,20 +142,24 @@ <example> <title>Migration: ancienne syntaxe while..endwhile </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php while ($more_to_come); ... endwhile; -?&gt; +?> +]]> </programlisting> </example> <example><title>Migration: nouvelle syntaxe while..endwhile</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php while ($more_to_come): ... endwhile; -?&gt; +?> +]]> </programlisting> </example> </para> @@ -164,7 +181,8 @@ Consid&eacute;rez les lignes suivantes: <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $a[0]=5; $a[1]=7; $key = key($a); @@ -172,7 +190,8 @@ echo "$keyn"; next($a); } -?&gt; +?> +]]> </programlisting> </informalexample> En PHP/FI 2.0, cet exemple va afficher les indices des $a. @@ -189,9 +208,11 @@ La correction de ceci est simple : il suffit de remplacer les commandes while par: <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php while ((string)$key != "") { -?&gt; +?> +]]> </programlisting> </informalexample> </para> @@ -235,21 +256,25 @@ Migration depuis 2.0: valeur retourn&eacute;es, ancienne fa&ccedil;on </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $fp = fopen($file, "r"); if ($fp == -1); - echo("Impossible d'ouvrir le fichier $file en lecture &lt;br&gt;\n"); + echo("Impossible d'ouvrir le fichier $file en lecture <br>\n"); endif; -?&gt; +?> +]]> </programlisting> </example> <example> <title>Migration depuis 2.0: valeur retourn&eacute;es, nouvelle fa&ccedil;on</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $fp = @fopen($file, "r") or - print("Impossible d'ouvrir le fichier $file en lecture&lt;br&gt;\n"); -?&gt; + print("Impossible d'ouvrir le fichier $file en lecture<br>\n"); +?> +]]> </programlisting> </example> </para> @@ -305,34 +330,42 @@ <example> <title>Migration depuis 2.0: concat&eacute;nation de cha&icirc;nes</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php echo "1" + "1"; -?&gt; +?> +]]> </programlisting> <para> En PHP 2.0 cela retournerait 11, en PHP 3.0 cela va retourner 2. A la place, faites : <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php echo "1"."1"; -?&gt; +?> +]]> </programlisting> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $a = 1; $b = 1; echo $a + $b; -?&gt; +?> +]]> </programlisting> </para> <para> Cela va afficher 2, tant en PHP 2.0 qu'en 3.0. <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $a = 1; $b = 1; echo $a.$b; -?&gt; +?> +]]> </programlisting> Cela va afficher 11 en PHP 3.0. </para> Index: phpdoc-fr/appendices/migration4.xml diff -u phpdoc-fr/appendices/migration4.xml:1.15 phpdoc-fr/appendices/migration4.xml:1.16 --- phpdoc-fr/appendices/migration4.xml:1.15 Fri Aug 23 14:31:17 2002 +++ phpdoc-fr/appendices/migration4.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <appendix id="migration4"> <title>Migration de PHP 3.0 &agrave; PHP 4.0</title> <sect1 id="migration4.changes"> @@ -48,16 +48,18 @@ Pour l'activer, configurez PHP 3 et PHP 4 pour qu'ils utilisent APXS (<link linkend="install.configure.with-apxs"><option role="configure">--with-apxs</option></link>) et les extensions n&eacute;cessaires - (<link linkend="install.configure.enable-versioning"><option role="configure">--enable-versioning</option></link>). + (<link linkend="install.configure.enable-versioning.php4"><option role="configure">--enable-versioning</option></link>). En dehors de cela, toutes les instructions d'installation habituelles s'appliquent. Par exemple : <informalexample> <programlisting> +<![CDATA[ $ ./configure \ --with-apxs=/apache/bin/apxs \ --enable-versioning \ --with-mysql \ --enable-track-vars +]]> </programlisting> </informalexample> </para> @@ -66,15 +68,17 @@ <title>Migration des fichiers de configuration</title> <para> Le fichier de configuration global, <filename>php3.ini</filename>, - a &eacute;t&eacute; renomm&eacute; en <filename>php.ini</filename>. + a &eacute;t&eacute; renomm&eacute; en &php.ini;. </para> <para> Pour les fichiers de configuration Apache, il y a eu des modifications plus importantes. Les types MIME reconnus par le module PHP ont &eacute;t&eacute; modifi&eacute;s. <informalexample> <programlisting> -application/x-httpd-php3 --&gt; application/x-httpd-php -application/x-httpd-php3-source --&gt; application/x-httpd-php-source +<![CDATA[ +application/x-httpd-php3 --> application/x-httpd-php +application/x-httpd-php3-source --> application/x-httpd-php-source +]]> </programlisting> </informalexample> </para> @@ -84,10 +88,12 @@ d&eacute;j&agrave; compil&eacute;e sur le serveur), en utilisant la syntaxe suivante : <informalexample> <programlisting> +<![CDATA[ AddType application/x-httpd-php3 .php3 AddType application/x-httpd-php3-source .php3s AddType application/x-httpd-php .php AddType application/x-httpd-php-source .phps +]]> </programlisting> </informalexample> </para> @@ -99,10 +105,12 @@ &agrave; PHP : <informalexample> <programlisting> +<![CDATA[ php_value [PHP directive name] [value] php_flag [PHP directive name] [On|Off] php_admin_value [PHP directive name] [value] php_admin_flag [PHP directive name] [On|Off] +]]> </programlisting> </informalexample> </para> @@ -119,8 +127,8 @@ <listitem> <simpara> Les valeurs Standard ne peuvent pas contr&ocirc;ler certaines directives PHP. Par - exemple, le safe mode (si vous pouviez modifier les configurations dans le fichier - <filename>.htaccess</filename>, cela annulerait toute la s&eacute;curit&eacute; du safe mode. + exemple, le &safemode; (si vous pouviez modifier les configurations dans le fichier + <filename>.htaccess</filename>, cela annulerait toute la s&eacute;curit&eacute; du &safemode;. A l'inverse, les valeurs Admin peuvent modifier n'importe quelle directive PHP. </simpara> @@ -140,7 +148,9 @@ <filename>scripts/apache/</filename>). Par exemple : <informalexample> <programlisting> +<![CDATA[ ~/php4/scripts/apache:# ./apconf-conv.sh /usr/local/apache/conf/httpd.conf +]]> </programlisting> </informalexample> </para> @@ -154,7 +164,9 @@ <filename>scripts/apache/</filename>). Par exemple : <informalexample> <programlisting> +<![CDATA[ ~/php4/scripts/apache:# find / -name .htaccess -exec ./aphtaccess-conv.sh {} \; +]]> </programlisting> </informalexample> </para> @@ -230,7 +242,7 @@ l'air compliqu&eacute;? Supposons que vous souhaitiez afficher toutes les erreurs, hormis les alertes de style, qui sont rep&eacute;r&eacute;es par la constante : E_NOTICE. Il suffit d'ajouter la valeur - suivante dans le fichier <filename>php.ini</filename>: + suivante dans le fichier &php.ini; : <literal>error_reporting = E_ALL &amp; ~ ( E_NOTICE )</literal>. Si vous voulez supprimer en plus les alertes, vous pouvez ajouter la constante appropri&eacute;e, en la combinant avec l'op&eacute;rateur @@ -282,8 +294,8 @@ de telle mani&egrave;re que le script lui donne acc&egrave;s &agrave; un niveau de droits sup&eacute;rieur. PHP 4.0 vous signalera tout oubli de guillemets comme par exemple dans : - <literal>$HTTP_SERVER_VARS[REQUEST_METHOD]</literal>. Modifier - ce code en <literal>$HTTP_SERVER_VARS['REQUEST_METHOD']</literal> + <literal>$_SERVER[REQUEST_METHOD]</literal>. Modifier + ce code en <literal>$_SERVER['REQUEST_METHOD']</literal> rendra l'analyseur heureux, et am&eacute;liorera grandement votre style et la s&eacute;curit&eacute; du code. </para> @@ -350,13 +362,14 @@ l'analyse a eu lieu, et est termin&eacute;e. La fonction short_tags() a cess&eacute; d'exister. Vous pouvez toujours modifier le comportement de l'analyseur avec - le fichier <filename>php.ini</filename>. + le fichier &php.ini;. </para> <para> - Une autre fonctionnalit&eacute; qui a disparu est le d&eacute;buggeur - de PHP 3.0, comme d&eacute;crit dans un autre appendice. Un nouveau - d&eacute;buggeur est promis par Zend, mais il n'a pas encore montr&eacute; - le bout de son nez. + Une autre fonctionnalit&eacute; qui ne fait pas partie de &php; + est le d&eacute;bogeur. Des d&eacute;bogueurs r&eacute;alis&eacute;s par des tiers + sont disponibles, mais ne sont pas distribu&eacute;s avec &php; + D'autres extensions du Zend Engine sont aussi disponibles aupr&egrave;s + de divers sites et groupes. </para> </sect2> <sect2 id="migration4.deprecate"> @@ -397,7 +410,7 @@ de portage ne fait pas partie de cet appendice (pour le moment). </para> </sect1> - <sect1 id="migration4.string"> + <sect1 id="migration4.strings"> <title>Substitution de variables dans les cha&icirc;nes</title> <para> PHP 4.0 dispose d'un nouveau m&eacute;canisme de substitution des @@ -439,6 +452,37 @@ probl&egrave;mes ult&eacute;rieurs. </para> </sect1> + <section id="migration4.variables"> + <title>Gestion des variables globales</title> + <para> + Alors que la gestion des variables globales a &eacute;t&eacute; surtout &eacute;tudi&eacute;e + pour &ecirc;tre simple en &php; 3 et aux premi&egrave;res versions de &php; 4, + la s&eacute;curit&eacute; est devenue la priorit&eacute; avec les derni&egrave;res versions. + Alors qu'en &php; 3, le code suivant fonctionnait sans probl&egrave;me, + en &php; 4, il faut utiliser <literal>unset($GLOBALS["id"]);</literal>. + Ce n'est qu'un des probl&egrave;me li&eacute; &agrave; la gestion des variables. + Il faut toujours utiliser la variable <varname>$GLOBALS</varname> avec + les nouvelles versions de &php;. Apprenez-en plus sur ce sujet + dans la section <link linkend="references.global">R&eacute;f&eacute;rences globales</link>. + </para> + <example> + <title>Migration des variables globales</title> + <programlisting role="php"> +<![CDATA[ +<?php + $id = 1; + function test() { + global $id; + unset($id); + } + test(); + echo($id); + // Ceci va afficher 1 en PHP 4 +?> +]]> + </programlisting> + </example> + </section> </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.20 phpdoc-fr/appendices/phpdevel.xml:1.21 --- phpdoc-fr/appendices/phpdevel.xml:1.20 Thu Aug 22 15:59:18 2002 +++ phpdoc-fr/appendices/phpdevel.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> +<!-- $Revision: 1.21 $ --> <appendix id="phpdevel"> <title>D&eacute;veloppement PHP</title> <sect1 id="phpdevel-addfunc"> @@ -9,8 +9,10 @@ <para> Toutes les fonctions suivent le sch&eacute;ma suivant : <programlisting role="c"> +<![CDATA[ void php3_foo(INTERNAL_FUNCTION_PARAMETERS) { } +]]> </programlisting> M&ecirc;me si votre fonction ne prend aucun argument, c'est comme cela qu'elle doit &ecirc;tre appel&eacute;e. @@ -27,10 +29,12 @@ <example> <title>Argument de fonction de lecture</title> <programlisting role="c"> +<![CDATA[ pval *arg1, *arg2; -if (ARG_COUNT(ht) != 2 || getParameters(ht,2,&amp;arg1,&amp;arg2)==FAILURE) { +if (ARG_COUNT(ht) != 2 || getParameters(ht,2,&arg1,&arg2)==FAILURE) { WRONG_PARAM_COUNT; } +]]> </programlisting> </example> NOTE: Les arguments peuvent &ecirc;tre pass&eacute; par valeur ou par @@ -66,12 +70,14 @@ <example> <title>Fonctions &agrave; nombre d'arguments variable</title> <programlisting role="c"> +<![CDATA[ pval *arg1, *arg2, *arg3; int arg_count = ARG_COUNT(ht); -if (arg_count &lt; 2 || arg_count &gt; 3 || - getParameters(ht,arg_count,&amp;arg1,&amp;arg2,&amp;arg3)==FAILURE) { +if (arg_count < 2 || arg_count > 3 || + getParameters(ht,arg_count,&arg1,&arg2,&arg3)==FAILURE) { WRONG_PARAM_COUNT; } +]]> </programlisting> </example> </para> @@ -132,6 +138,7 @@ avec un autre type, ou si vous voulez simplement forcer le type, vous pouvez utiliser l'une des fonctions de conversion suivantes : <programlisting role="c"> +<![CDATA[ convert_to_long(arg1); convert_to_double(arg1); convert_to_string(arg1); @@ -139,6 +146,7 @@ /* Si la cha&icirc;ne est "" ou "0" elle devient 0, 1 sinon */ convert_string_to_number(arg1); /* Convertit une cha&icirc;ne en LONG ou DOUBLE suivant la cha&icirc;ne */ +]]> </programlisting> </para> <simpara> @@ -147,9 +155,9 @@ <para> La valeur de l'argument est enregistr&eacute;e dans une union. Les membres sont : <itemizedlist> - <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> + <listitem><simpara>IS_STRING: arg1->value.str.val</simpara></listitem> + <listitem><simpara>IS_LONG: arg1->value.lval</simpara></listitem> + <listitem><simpara>IS_DOUBLE: arg1->value.dval</simpara></listitem> </itemizedlist> </para> </sect2> @@ -202,19 +210,15 @@ <listitem><simpara>SET_VAR_LONG(name,value)</simpara></listitem> </itemizedlist> </para> - <para> - <blockquote id="symtab-1"> - <title>Gestion de la m&eacute;moire</title> - <simpara> - Soyez prudent. La valeur doit &ecirc;tre plac&eacute;e dans une portion de - m&eacute;moire cr&eacute;&eacute;e avec malloc(), sinon le gestionnaire de - m&eacute;moire essayera de lib&eacute;rer le pointeur plus tard. Ne passez - aucune m&eacute;moire allou&eacute;e statiquement &agrave; SET_VAR_STRING. - </simpara> - </blockquote> - </para> <simpara> - Les tables des symboles de PHP 3 est une table de hash. A n'importe quel moment, + Soyez prudent avec la constante SET_VAR_STRING. La valeur doit &ecirc;tre + plac&eacute;e dans une portion de + m&eacute;moire cr&eacute;&eacute;e avec malloc(), sinon le gestionnaire de + m&eacute;moire essayera de lib&eacute;rer le pointeur plus tard. Ne passez + aucune m&eacute;moire allou&eacute;e statiquement &agrave; SET_VAR_STRING. + </simpara> + <simpara> + Les tables des symboles de &php; est une table de hash. A n'importe quel moment, &amp;symbol_table est un pointeur sur la table principale, et active_symbol_table pointe sur la table actuellement utilis&eacute;e. (ces deux tables peuvent &ecirc;tre identiques au d&eacute;marrage, ou @@ -233,18 +237,22 @@ la table des symboles </title> <programlisting role="php"> +<![CDATA[ if (hash_exists(active_symbol_table,"foo",sizeof("foo"))) { // existe... } else { // n'existe pas } +]]> </programlisting> </example> <example> <title>Rechercher la taille d'une variable dans la table des symboles</title> <programlisting role="c"> -hash_find(active_symbol_table,"foo",sizeof("foo"),&amp;pvalue); +<![CDATA[ +hash_find(active_symbol_table,"foo",sizeof("foo"),&pvalue); check(pvalue.type); +]]> </programlisting> </example> En PHP 3.0, les tableaux sont impl&eacute;ment&eacute;s en utilisant les @@ -267,9 +275,11 @@ <example> <title>Initialisation d'un tableau</title> <programlisting role="c"> +<![CDATA[ pval arr; -if (array_init(&amp;arr) == FAILURE) { /*Initialiation &eacute;chou&eacute;e*/ }; -hash_update(active_symbol_table,"foo",sizeof("foo"),&amp;arr,sizeof(pval),NULL); +if (array_init(&arr) == FAILURE) { /*Initialiation &eacute;chou&eacute;e*/ }; +hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +]]> </programlisting> </example> Ce code d&eacute;clare un nouveau tableau, appel&eacute; $foo, dans la table @@ -282,17 +292,19 @@ <example> <title>Ajout d'entr&eacute;es dans un tableau.</title> <programlisting role="c"> +<![CDATA[ pval entry; entry.type = IS_LONG; entry.value.lval = 5; /* d&eacute;finit $foo["bar"] = 5 */ -hash_update(arr.value.ht,"bar",sizeof("bar"),&amp;entry,sizeof(pval),NULL); +hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); /* d&eacute;finit $foo[7] = 5 */ -hash_index_update(arr.value.ht,7,&amp;entry,sizeof(pval),NULL); +hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); /* d&eacute;finit la prochaine place libre dans $foo[], * $foo[8], qui sera 5 (comme en php2) */ -hash_next_index_insert(arr.value.ht,&amp;entry,sizeof(pval),NULL); +hash_next_index_insert(arr.value.ht,&entry,sizeof(pval),NULL); +]]> </programlisting> </example> Si vous voulez modifier une valeur que vous avez ins&eacute;r&eacute; dans une @@ -311,25 +323,31 @@ comme ceci : </simpara> <programlisting role="c"> +<![CDATA[ if (array_init(return_value) == FAILURE) { &eacute;chec...; } +]]> </programlisting> <simpara> puis ajouter les valeurs gr&acirc;ces aux macros: </simpara> <programlisting role="c"> +<![CDATA[ add_next_index_long(return_value,long_value); add_next_index_double(return_value,double_value); add_next_index_string(return_value,estrdup(string_value)); +]]> </programlisting> <para> Bien s&ucirc;r, si l'ajout n'est pas fait juste apr&egrave;s l'initialisation, vous devrez d'abord rechercher le tableau : <programlisting role="c"> +<![CDATA[ pval *arr; -if (hash_find(active_symbol_table,"foo",sizeof("foo"),(void **)&amp;arr)==FAILURE) +if (hash_find(active_symbol_table,"foo",sizeof("foo"),(void **)&arr)==FAILURE) { introuvable... } else -{ utilisez arr-&gt;value.ht... } +{ utilisez arr->value.ht... } +]]> </programlisting> </para> <simpara> @@ -428,7 +446,9 @@ les fonctions habituelles de .value.ht). L'enregistrement re&eacute;l peut &ecirc;tre fait comme suit : <programlisting role="c"> +<![CDATA[ add_method( return_value, function_name, function_ptr ); +]]> </programlisting> </para> </listitem> @@ -532,36 +552,42 @@ <example> <title>Ajouter une nouvelle ressource</title> <programlisting role="c"> +<![CDATA[ RESOURCE *resource; /* ...alloue de la m&eacute;moire pour la ressource, et l'acquiert ... */ /* Ajoute la nouvelle ressource dans la liste */ -return_value-&gt;value.lval = php3_list_insert((void *) resource, LE_RESOURCE_TYPE); -return_value-&gt;type = IS_LONG; +return_value->value.lval = php3_list_insert((void *) resource, LE_RESOURCE_TYPE); +return_value->type = IS_LONG; +]]> </programlisting> </example> <example> <title>Utiliser une ressource existante</title> <programlisting role="c"> +<![CDATA[ pval *resource_id; RESOURCE *resource; int type; convert_to_long(resource_id); -resource = php3_list_find(resource_id-&gt;value.lval, &amp;type); +resource = php3_list_find(resource_id->value.lval, &type); if (type != LE_RESOURCE_TYPE) { - php3_error(E_WARNING,"resource index %d has the wrong type",resource_id-&gt;value.lval); + php3_error(E_WARNING,"resource index %d has the wrong type",resource_id->value.lval); RETURN_FALSE; } /* ...utiliser la ressource... */ +]]> </programlisting> </example> <example> <title>Effacer une ressource existante</title> <programlisting role="c"> +<![CDATA[ pval *resource_id; RESOURCE *resource; int type; convert_to_long(resource_id); -php3_list_delete(resource_id-&gt;value.lval); +php3_list_delete(resource_id->value.lval); +]]> </programlisting> </example> Les types de ressources doivent &ecirc;tre enregistr&eacute; dans le fichier @@ -829,7 +855,7 @@ niveaux d'erreurs sont : </simpara> <sect2 id="internal.e-notice"> - <title>E_NOTICE</title> + <title><constant>E_NOTICE</constant></title> <simpara> Les notes ne sont pas affich&eacute;es par d&eacute;faut, et indique que le script a rencontr&eacute; quelque chose qui peut &ecirc;tre une erreur, @@ -840,7 +866,7 @@ </simpara> </sect2> <sect2 id="internal.e-warning"> - <title>E_WARNING</title> + <title><constant>E_WARNING</constant></title> <simpara> Les alertes sont affich&eacute;es par d&eacute;faut, mais n'interrompent pas l'&eacute;x&eacute;cution du script. Elles indiquent un probl&egrave;me qui @@ -849,7 +875,7 @@ </simpara> </sect2> <sect2 id="internal.e-error"> - <title>E_ERROR</title> + <title><constant>E_ERROR</constant></title> <simpara> Les erreurs sont aussi affich&eacute;es par d&eacute;faut, et l'ex&eacute;cution du script est interrompue. Elles indiquent des erreurs @@ -858,7 +884,7 @@ </simpara> </sect2> <sect2 id="internal.e-parse"> - <title>E_PARSE</title> + <title><constant>E_PARSE</constant></title> <simpara> Les erreurs d'analyse de doivent &ecirc;tre g&eacute;n&eacute;r&eacute;es que par l'analyseur. Elles ne sont cit&eacute;es ici que dans le but d'&ecirc;tre @@ -866,62 +892,69 @@ </simpara> </sect2> <sect2 id="internal.e-core-error"> - <title>E_CORE_ERROR</title> + <title><constant>E_CORE_ERROR</constant></title> <simpara> - Elles sont similaires aux erreurs E_ERROR, mais elles sont + Elles sont similaires aux erreurs <constant>E_ERROR</constant>, mais elles sont g&eacute;n&eacute;r&eacute;es par le code de PHP. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. </simpara> </sect2> <sect2 id="internal.e-core-warning"> - <title>E_CORE_WARNING</title> + <title><constant>E_CORE_WARNING</constant></title> <simpara> - Elles sont similaires &agrave; E_WARNING, mais elles sont + Elles sont similaires &agrave; <constant>E_WARNING</constant>, mais elles sont g&eacute;n&eacute;r&eacute;es par le code de PHP. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. </simpara> </sect2> <sect2 id="internal.e-compile-error"> - <title>E_COMPILE_ERROR</title> + <title><constant>E_COMPILE_ERROR</constant></title> <simpara> - Elles sont similaires &agrave; E_ERROR, mais elles sont + Elles sont similaires &agrave; <constant>E_ERROR</constant>, mais elles sont g&eacute;n&eacute;r&eacute;es par Zend Scripting Engine. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. </simpara> </sect2> <sect2 id="internal.e-compile-warning"> - <title>E_COMPILE_WARNING</title> + <title><constant>E_COMPILE_WARNING</constant></title> <simpara> - Elles sont similaires &agrave; E_WARNING, mais elles sont + Elles sont similaires &agrave; <constant>E_WARNING</constant>, mais elles sont g&eacute;n&eacute;r&eacute;es par Zend Scripting Engine. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. </simpara> </sect2> <sect2 id="internal.e-user-error"> - <title>E_USER_ERROR</title> + <title><constant>E_USER_ERROR</constant></title> <simpara> - E_USER_ERROR est comparable &agrave; E_ERROR. Elle est + <constant>E_USER_ERROR</constant> est comparable &agrave; <constant>E_ERROR</constant>. Elle est g&eacute;n&eacute;r&eacute;e en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. </simpara> </sect2> <sect2 id="internal.e-user-warning"> - <title>E_USER_WARNING</title> + <title><constant>E_USER_WARNING</constant></title> <simpara> - E_USER_WARNING est comparable &agrave; E_WARNING. Elle est + <constant>E_USER_WARNING</constant> est comparable &agrave; <constant>E_WARNING</constant>. Elle est g&eacute;n&eacute;r&eacute;e en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. </simpara> </sect2> <sect2 id="internal.e-user-notice"> - <title>E_USER_NOTICE</title> + <title><constant>E_USER_NOTICE</constant></title> <simpara> - E_USER_WARNING est comparable &agrave; E_NOTICE. Elle est + <constant>E_USER_WARNING</constant> est comparable &agrave; <constant>E_NOTICE</constant>. Elle est g&eacute;n&eacute;r&eacute;e en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas g&eacute;n&eacute;rer ce genre d'erreur. + </simpara> + </sect2> + <sect2 id="internal.e-all"> + <title><constant>E_ALL</constant></title> + <simpara> + Toutes les erreurs ci-dessus. Utiliser ce niveau de rapport d'erreur + provoque l'affichage de toutes les erreurs. </simpara> </sect2> </sect1> Index: phpdoc-fr/appendices/reserved.xml diff -u phpdoc-fr/appendices/reserved.xml:1.12 phpdoc-fr/appendices/reserved.xml:1.13 --- phpdoc-fr/appendices/reserved.xml:1.12 Thu Aug 22 15:59:18 2002 +++ phpdoc-fr/appendices/reserved.xml Fri Feb 7 13:11:29 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <appendix id="reserved"> - <title>Mot r&eacute;serv&eacute;s en PHP</title> + <title>Mots r&eacute;serv&eacute;s en PHP</title> <para> Cette annexes est une liste d'identifiant pr&eacute;d&eacute;finis en PHP. Aucun des identifiants utilis&eacute;s ici ne doit &ecirc;tre repris comme nom de @@ -13,370 +13,203 @@ <sect1 id="reserved.keywords"> <title>Liste de mots-cl&eacute;</title> - <para> + <para> Ces mots ont un sens sp&eacute;cial en PHP. Certains repr&eacute;sentent des objets qui ressemblent &agrave; des fonctions, d'autres &agrave; des contantes, et ainsi de suite, mais ils n'en sont pas vraiment : ce sont des structures de langage. Vous ne pourrez pas les utiliser comme constantes, nom de classe ou fonctions. Vous pouvez les utiliser comme noms de variables, mais cela risque de vous mener des confusions. - <itemizedlist> - <listitem> - <simpara> - <link linkend="language.operators.logical">and</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.foreach">as</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$argv</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$argc</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.break">break</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.switch">case</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="functions.old-syntax">cfunction</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.class">class</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.continue">continue</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.declare">declare</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.switch">default</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.do.while">do</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>die</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>echo</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.else">else</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.elseif">elseif</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>empty</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.declare">enddeclare</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.alternative-syntax">endfor</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.alternative-syntax">endforeach</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.alternative-syntax">endif</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.alternative-syntax">endswitch</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.alternative-syntax">endwhile</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="function.eval">eval</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">E_ALL</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">E_PARSE</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">E_ERROR</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">E_WARNING</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>exit</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.class">extends</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">&false;</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.for">for</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.foreach">foreach</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="functions.user-defined">function</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$HTTP_COOKIE_VARS</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$HTTP_GET_VARS</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$HTTP_POST_VARS</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$HTTP_POST_FILES</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$HTTP_ENV_VARS</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$HTTP_SERVER_VARS</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.if">if</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>include</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>include_once</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.scope">global</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>list</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.class">new</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.operators.logical">not</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants.predefined">NULL</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="functions.old-syntax">old_function</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.operators.logical">or</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.parent">parent</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">PHP_OS</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.predefined.php">$PHP_SELF</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">PHP_VERSION</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>print</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>require</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>require_once</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="functions.user-defined">return</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.variables.scope">static</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.switch">switch</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.class">stdClass</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.class">$this</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">&true;</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="keyword.class">var</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.operators.logical">xor</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <function>virtual</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="control-structures.while">while</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">__FILE__</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.constants">__LINE__</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.oop.magic-functions">__sleep</link>. - </simpara> - </listitem> - <listitem> - <simpara> - <link linkend="language.oop.magic-functions">__wakeup</link>. - </simpara> - </listitem> - </itemizedlist> + </para> + <para> + <table> + <title>Mots r&eacute;serv&eacute;s en &php;</title> + <tgroup cols="4"> + <tbody> + <row> + <entry> + <link linkend="language.operators.logical">and</link> + </entry> + <entry> + <link linkend="language.operators.logical">or</link> + </entry> + <entry> + <link linkend="language.operators.logical">xor</link> + </entry> + <entry> + __FILE__ + </entry> + </row> + <row> + <entry> + __LINE__ + </entry> + <entry> + <function>array</function> + </entry> + <entry> + <link linkend="control-structures.foreach">as</link> + </entry> + <entry> + <link linkend="control-structures.break">break</link> + </entry> + <entry> + <link linkend="control-structures.switch">case</link> + </entry> + </row> + <row> + <entry> + <link linkend="functions.old-syntax">cfunction</link> + </entry> + <entry> + <link linkend="keyword.class">class</link> + </entry> + <entry> + const + </entry> + <entry> + <link linkend="control-structures.continue">continue</link> + </entry> + <entry> + <link linkend="control-structures.declare">declare</link> + </entry> + </row> + <row> + <entry> + <link linkend="control-structures.switch">default</link> + </entry> + <entry> + <function>die</function> + </entry> + <entry> + <link linkend="control-structures.do.while">do</link> + </entry> + <entry> + <function>echo</function> + </entry> + <entry> + <link linkend="control-structures.else">else</link> + </entry> + </row> + <row> + <entry> + <link linkend="control-structures.elseif">elseif</link> + </entry> + <entry> + <function>empty</function> + </entry> + <entry> + <link linkend="control-structures.declare">enddeclare</link> + </entry> + <entry> + <link linkend="control-structures.alternative-syntax">endfor</link> + </entry> + <entry> + <link linkend="control-structures.alternative-syntax">endforeach</link> + </entry> + </row> + <row> + <entry> + <link linkend="control-structures.alternative-syntax">endif</link> + </entry> + <entry> + <link linkend="control-structures.alternative-syntax">endswitch</link> + </entry> + <entry> + <link linkend="control-structures.alternative-syntax">endwhile</link> + </entry> + <entry> + <link linkend="function.eval">eval</link> + </entry> + <entry> + <function>exit</function> + </entry> + </row> + <row> + <entry> + <link linkend="keyword.class">extends</link> + </entry> + <entry> + <link linkend="control-structures.for">for</link> + </entry> + <entry> + <link linkend="control-structures.foreach">foreach</link> + </entry> + <entry> + <link linkend="functions.user-defined">function</link> + </entry> + <entry> + <link linkend="language.variables.scope">global</link> + </entry> + </row> + <row> + <entry> + <link linkend="control-structures.if">if</link> + </entry> + <entry> + <function>include</function> + </entry> + <entry> + <function>include_once</function> + </entry> + <entry> + <function>isset</function> + </entry> + <entry> + <function>list</function> + </entry> + </row> + <row> + <entry> + <link linkend="keyword.class">new</link> + </entry> + <entry> + <link linkend="functions.old-syntax">old_function</link> + </entry> + <entry> + <function>print</function> + </entry> + <entry> + <function>require</function> + </entry> + <entry> + <function>require_once</function> + </entry> + </row> + <row> + <entry> + <function>return</function> + </entry> + <entry> + <link linkend="language.variables.scope">static</link> + </entry> + <entry> + <link linkend="control-structures.switch">switch</link> + </entry> + <entry> + <function>unset</function> + </entry> + <entry> + use + </entry> + </row> + <row> + <entry> + <link linkend="keyword.class">var</link> + </entry> + <entry> + <link linkend="control-structures.while">while</link> + </entry> + <entry> + <constant>__FUNCTION__</constant> + </entry> + <entry> + <constant>__CLASS__</constant> + </entry> + </row> + </tbody> + </tgroup> + </table> </para> </sect1> <sect1 id="reserved.variables"> @@ -646,6 +479,25 @@ </varlistentry> <varlistentry> + <term>'<varname>REMOTE_HOST</varname>'</term> + <listitem> + <simpara> + Le nom de l'h&ocirc;te qui lit le script courant. La r&eacute;solution + DNS inverse est bas&eacute;e sur la valeur de <varname>REMOTE_ADDR</varname>. + </simpara> + <note> + <simpara> + Votre serveur web doit &ecirc;tre configur&eacute; pour cr&eacute;er cette variable. + Par exemple, pour Apache, vous devez ajouter la directive + <literal>HostnameLookups On</literal> dans le fichier + <filename>httpd.conf</filename>, pour que cette variable existe. + Voyez aussi <function>gethostbyaddr</function>. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry> <term>'<varname>REMOTE_PORT</varname>'</term> <listitem> <simpara> @@ -1257,8 +1109,10 @@ </varlistentry> </variablelist> </sect2> - </sect1> + + &appendices.reserved.constants; + </appendix> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/appendices/resources.xml diff -u phpdoc-fr/appendices/resources.xml:1.14 phpdoc-fr/appendices/resources.xml:1.15 --- phpdoc-fr/appendices/resources.xml:1.14 Thu Aug 22 15:59:18 2002 +++ phpdoc-fr/appendices/resources.xml Fri Feb 7 13:11:29 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<appendix id="resources"> +<!-- $Revision: 1.15 $ --> +<appendix id="resource"> <title>Types des ressources PHP</title> <para> Voici la liste des fonctions qui cr&eacute;ent, utilisent Index: phpdoc-fr/appendices/tokens.xml diff -u phpdoc-fr/appendices/tokens.xml:1.3 phpdoc-fr/appendices/tokens.xml:1.4 --- phpdoc-fr/appendices/tokens.xml:1.3 Thu Aug 22 15:59:18 2002 +++ phpdoc-fr/appendices/tokens.xml Fri Feb 7 13:11:29 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <appendix id="tokens"> <title>Liste des token de l'analyseur</title> @@ -554,13 +554,13 @@ <entry>T_FUNC_C</entry> <entry>__FUNCTION__</entry> <entry><link linkend="language.constants">constantes</link>, depuis - <literal>PHP</literal> 4.3.0</entry> + &php; 4.3.0</entry> </row> <row> <entry>T_CLASS_C</entry> <entry>__CLASS__</entry> <entry><link linkend="language.constants">constantes</link>, depuis - <literal>PHP</literal> 4.3.0</entry> + &php; 4.3.0</entry> </row> </tbody> </tgroup>
« previous php.doc.fr (#240) next »