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: | Damien Seguy | 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égration. </para> - <note> +<!-- +<note> <para> Un projet de Visual Basic pour Linux a débuté, et il incluera un cré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éfinition d'une fonction (prototype)</title> + <para> + Chaque fonction est documentée pour permettre un accès rapide, + et savoir décoder le manuel rendra votre lecture plus facile. Plutôt + que de dépendre d'exemples prêts en copier/coller, il est mieux de + savoir lire la définition d'une fonction. Voici comment : + </para> + <note> + <title> + Pré-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ême des sens importants. + </para> + </note> + <para> + Les définitions de fonctions vous indique quel type de données est + <link linkend="functions.returning-values">retourné</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îne string . + </screen> + </para> + <para> + <table> + <title>Explications de la dé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ésente dans toutes les versions de PHP 3 et PHP 4. + </entry> + </row> + <row> + <entry> + int + </entry> + <entry> + Type de valeur retourné par cette fonction, qui est en l'occurence + un &integer; (i.e. la taille d'une chaîne est mesurée par un nombre). + </entry> + </row> + <row> + <entry> + ( string str ) + </entry> + <entry> + Le premier (et ici le seul) paramètre à fournir à strlen est le paramètre + <parameter>str</parameter>, qui doit être du type &string;. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Nous pourrions réécrire ce prototype avec une version plus générique : + </para> + <para> + <screen role="html"> + type_retourné nom_de_la fonction ( type_du_paramètre nom_du_paramètre ) + </screen> + </para> + <para> + Plusieurs fonctions ont besoin de plusieurs paramè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éussite ( le paramètre + <parameter>needle</parameter> a été trouvé dans le tableau + <parameter>haystack</parameter>) ou &false; en cas d'échec + ( le paramètre <parameter>needle</parameter> n'a pas été trouvé + dans le tableau <parameter>haystack</parameter>). Le premier + paramètre s'appelle <parameter>needle</parameter> et il peut être + de différents <link linkend="language.types">types</link> : il porte + donc la mention <emphasis>mixed</emphasis>. Le paramètre <parameter>needle</parameter> + (ce que nous recherchons) peut ê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ètre. Le troisième paramètre, <parameter>strict</parameter>, + est optionnel. Tous les paramètres optoinnels sont placés entre crochets. + La manuel indique que le paramètre <parameter>strict</parameter> vaut par dé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ées dans ce manuel</title> + <para> + Cette documentation contient des informations sur PHP 4, avec + des notes compatibilités et de migration depuis PHP 3. Le comportement, + les paramètres, les valeurs retournées, etc... qui ont changé entre + deux versions du manuel &php; sont documentées dans les notes utilisateurs, + et dasn le manuel lui même. + </para> + <para> + Vous pouvez trouvez des portions de documentation destinées aux + versions CVS de PHP, ce qui signifie que les toutes dernières versions + de développement de PHP proposent ces fonctionnalités. Si vous n'êtes + pas un développeur PHP, et que vous n'avez pas la possibilité d'utiliser + la dernière version de PHP, les fonctionnalités indiquées comme + "disponibles uniquement en CVS" ne vous seront pas accessibles. Toutes fois, + ces fonctionnalité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ée (par exemple, des fonctions + destinées à 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és qui seront disponible avec la + prochaine publication de PHP. + </para> + </sect1> <sect1 id="about.more"> <title>Où trouver plus d'information sur PHP?</title> @@ -247,6 +400,23 @@ </para> </sect1> + <sect1 id="about.translations.fr"> + <title>Traduction française</title> + <para> + La version française est traduite quotidiennement et disponible + chez Nexen (<ulink url="&url.nexen;">nexen.net/</ulink>). + Ce manuel a été généré à partir de + la documentation originale en anglais du PHP Documentation Group, au + format XML. Elle est 100% compatible avec le système de génération + du groupe PHP. Elle est traité avec un système développé par + Nexen pour produire divers autres formats. + </para> + <para> + Pour les problèmes liés à la traduction, vous pouvez + contacter directement l'é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é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 à 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ébuggeur PHP</title> <sect1 id="debugger-about"> @@ -9,8 +9,15 @@ </simpara> <simpara> PHP 4 n'inclut aucun support de débuggage. + Vous pouvez toutes fois utiliser un des débogeur externe. + Le <ulink url="&url.zend.ide;">Studio Zend</ulink> inclut + un débogeur et il y a aussi des dé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é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'équipe de développement de PHP inclue des douzaines de développeurs, et d'autres équipes travaillent à des projets lié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é 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 à PHP 3.0</title> <sect1 id="migration.about"> @@ -42,18 +42,22 @@ <example> <title>Migration: Migration: balises start/end </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est du code PHP/FI 2.0.\n";? -?> +?> +]]> </programlisting> </example> Comme en version 2.0, PHP/FI accepte aussi cette variante : <example> <title>Migration: premières nouvelles balises PHP</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est du code PHP 3.0!\n"; -?> +?> +]]> </programlisting> </example> Notez bien que la balise de fin contient désormais un point @@ -65,9 +69,11 @@ <example> <title>Migration: Nouvelles balises PHP</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est du code PHP 3.0!\n"; -?> +?> +]]> </programlisting> </example> Certains d'entre vous rencontrent des problèmes avec les éditeurs qui @@ -76,9 +82,12 @@ variation suivante a été introduite : <example><title>Nouvelles balises PHP</title> <programlisting role="php"> -<script language="php"> +<![CDATA[ +<script language="php"> echo "Ceci est du code PHP 3.0!\n"; -</script> +</script> +]]> + </programlisting> </example> </para> @@ -93,7 +102,8 @@ <example> <title>Migration: ancienne syntaxe if..endif </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if ($foo); echo "oui\n"; elseif ($bar); @@ -101,13 +111,15 @@ else; echo "non\n"; endif; -?> +?> +]]> </programlisting> </example> <example> <title>Migration: nouvelle syntaxe if..endif</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if ($foo): echo "oui\n"; elseif ($bar): @@ -115,7 +127,8 @@ else: echo "non\n"; endif; -?> +?> +]]> </programlisting> </example> Notez que les points virgules ont été remplacée par des points dans @@ -129,20 +142,24 @@ <example> <title>Migration: ancienne syntaxe while..endwhile </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php while ($more_to_come); ... endwhile; -?> +?> +]]> </programlisting> </example> <example><title>Migration: nouvelle syntaxe while..endwhile</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php while ($more_to_come): ... endwhile; -?> +?> +]]> </programlisting> </example> </para> @@ -164,7 +181,8 @@ Considérez les lignes suivantes: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a[0]=5; $a[1]=7; $key = key($a); @@ -172,7 +190,8 @@ echo "$keyn"; next($a); } -?> +?> +]]> </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"> -<?php +<![CDATA[ +<?php while ((string)$key != "") { -?> +?> +]]> </programlisting> </informalexample> </para> @@ -235,21 +256,25 @@ Migration depuis 2.0: valeur retournées, ancienne façon </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $fp = fopen($file, "r"); if ($fp == -1); - echo("Impossible d'ouvrir le fichier $file en lecture <br>\n"); + echo("Impossible d'ouvrir le fichier $file en lecture <br>\n"); endif; -?> +?> +]]> </programlisting> </example> <example> <title>Migration depuis 2.0: valeur retournées, nouvelle façon</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $fp = @fopen($file, "r") or - print("Impossible d'ouvrir le fichier $file en lecture<br>\n"); -?> + 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énation de chaînes</title> <programlisting role="php"> -<?php +<![CDATA[ +<?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 role="php"> -<?php +<![CDATA[ +<?php echo "1"."1"; -?> +?> +]]> </programlisting> <programlisting role="php"> -<?php +<![CDATA[ +<?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 role="php"> -<?php +<![CDATA[ +<?php $a = 1; $b = 1; echo $a.$b; -?> +?> +]]> </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 à 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é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 été renommé en <filename>php.ini</filename>. + a été renommé 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 été modifiés. <informalexample> <programlisting> -application/x-httpd-php3 --> application/x-httpd-php -application/x-httpd-php3-source --> 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éjà compilé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 @@ à 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ô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écurité du safe mode. + exemple, le &safemode; (si vous pouviez modifier les configurations dans le fichier + <filename>.htaccess</filename>, cela annulerait toute la sécurité 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é? Supposons que vous souhaitiez afficher toutes les erreurs, hormis les alertes de style, qui sont repéré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 & ~ ( E_NOTICE )</literal>. Si vous voulez supprimer en plus les alertes, vous pouvez ajouter la constante appropriée, en la combinant avec l'opérateur @@ -282,8 +294,8 @@ de telle manière que le script lui donne accès à un niveau de droits supé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éliorera grandement votre style et la sécurité du code. </para> @@ -350,13 +362,14 @@ l'analyse a eu lieu, et est terminée. La fonction short_tags() a cessé 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é qui a disparu est le débuggeur - de PHP 3.0, comme décrit dans un autre appendice. Un nouveau - débuggeur est promis par Zend, mais il n'a pas encore montré - le bout de son nez. + Une autre fonctionnalité qui ne fait pas partie de &php; + est le débogeur. Des débogueurs réalisés par des tiers + sont disponibles, mais ne sont pas distribués avec &php; + D'autres extensions du Zend Engine sont aussi disponibles auprè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înes</title> <para> PHP 4.0 dispose d'un nouveau mécanisme de substitution des @@ -439,6 +452,37 @@ problèmes ultérieurs. </para> </sect1> + <section id="migration4.variables"> + <title>Gestion des variables globales</title> + <para> + Alors que la gestion des variables globales a été surtout étudiée + pour être simple en &php; 3 et aux premières versions de &php; 4, + la sécurité est devenue la priorité avec les dernières versions. + Alors qu'en &php; 3, le code suivant fonctionnait sans problème, + en &php; 4, il faut utiliser <literal>unset($GLOBALS["id"]);</literal>. + Ce n'est qu'un des problème lié à 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éfé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éveloppement PHP</title> <sect1 id="phpdevel-addfunc"> @@ -9,8 +9,10 @@ <para> Toutes les fonctions suivent le schéma suivant : <programlisting role="c"> +<![CDATA[ void php3_foo(INTERNAL_FUNCTION_PARAMETERS) { } +]]> </programlisting> Même si votre fonction ne prend aucun argument, c'est comme cela qu'elle doit être appelé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,&arg1,&arg2)==FAILURE) { +if (ARG_COUNT(ht) != 2 || getParameters(ht,2,&arg1,&arg2)==FAILURE) { WRONG_PARAM_COUNT; } +]]> </programlisting> </example> NOTE: Les arguments peuvent être passé par valeur ou par @@ -66,12 +70,14 @@ <example> <title>Fonctions à nombre d'arguments variable</title> <programlisting role="c"> +<![CDATA[ pval *arg1, *arg2, *arg3; int arg_count = ARG_COUNT(ht); -if (arg_count < 2 || arg_count > 3 || - getParameters(ht,arg_count,&arg1,&arg2,&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îne est "" ou "0" elle devient 0, 1 sinon */ convert_string_to_number(arg1); /* Convertit une chaîne en LONG ou DOUBLE suivant la chaîne */ +]]> </programlisting> </para> <simpara> @@ -147,9 +155,9 @@ <para> La valeur de l'argument est enregistrée dans une union. Les membres sont : <itemizedlist> - <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> + <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émoire</title> - <simpara> - Soyez prudent. La valeur doit être placée dans une portion de - mémoire créée avec malloc(), sinon le gestionnaire de - mémoire essayera de libérer le pointeur plus tard. Ne passez - aucune mémoire allouée statiquement à 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 être + placée dans une portion de + mémoire créée avec malloc(), sinon le gestionnaire de + mémoire essayera de libérer le pointeur plus tard. Ne passez + aucune mémoire allouée statiquement à SET_VAR_STRING. + </simpara> + <simpara> + Les tables des symboles de &php; est une table de hash. A n'importe quel moment, &symbol_table est un pointeur sur la table principale, et active_symbol_table pointe sur la table actuellement utilisée. (ces deux tables peuvent être identiques au dé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"),&pvalue); +<![CDATA[ +hash_find(active_symbol_table,"foo",sizeof("foo"),&pvalue); check(pvalue.type); +]]> </programlisting> </example> En PHP 3.0, les tableaux sont implémentés en utilisant les @@ -267,9 +275,11 @@ <example> <title>Initialisation d'un tableau</title> <programlisting role="c"> +<![CDATA[ pval arr; -if (array_init(&arr) == FAILURE) { /*Initialiation échouée*/ }; -hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +if (array_init(&arr) == FAILURE) { /*Initialiation échouée*/ }; +hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +]]> </programlisting> </example> Ce code déclare un nouveau tableau, appelé $foo, dans la table @@ -282,17 +292,19 @@ <example> <title>Ajout d'entrées dans un tableau.</title> <programlisting role="c"> +<![CDATA[ pval entry; entry.type = IS_LONG; entry.value.lval = 5; /* définit $foo["bar"] = 5 */ -hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); +hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); /* définit $foo[7] = 5 */ -hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); +hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); /* définit la prochaine place libre dans $foo[], * $foo[8], qui sera 5 (comme en php2) */ -hash_next_index_insert(arr.value.ht,&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éré dans une @@ -311,25 +323,31 @@ comme ceci : </simpara> <programlisting role="c"> +<![CDATA[ if (array_init(return_value) == FAILURE) { échec...; } +]]> </programlisting> <simpara> puis ajouter les valeurs grâ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ûr, si l'ajout n'est pas fait juste aprè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 **)&arr)==FAILURE) +if (hash_find(active_symbol_table,"foo",sizeof("foo"),(void **)&arr)==FAILURE) { introuvable... } else -{ utilisez arr->value.ht... } +{ utilisez arr->value.ht... } +]]> </programlisting> </para> <simpara> @@ -428,7 +446,9 @@ les fonctions habituelles de .value.ht). L'enregistrement reél peut ê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émoire pour la ressource, et l'acquiert ... */ /* Ajoute la nouvelle ressource dans la liste */ -return_value->value.lval = php3_list_insert((void *) resource, LE_RESOURCE_TYPE); -return_value->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->value.lval, &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->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->value.lval); +php3_list_delete(resource_id->value.lval); +]]> </programlisting> </example> Les types de ressources doivent être enregistré 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ées par défaut, et indique que le script a rencontré quelque chose qui peut ê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ées par défaut, mais n'interrompent pas l'éxécution du script. Elles indiquent un problè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ées par défaut, et l'exé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 être générées que par l'analyseur. Elles ne sont citées ici que dans le but d'ê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énérées par le code de PHP. Les fonctions ne doivent pas géné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 à E_WARNING, mais elles sont + Elles sont similaires à <constant>E_WARNING</constant>, mais elles sont générées par le code de PHP. Les fonctions ne doivent pas géné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 à E_ERROR, mais elles sont + Elles sont similaires à <constant>E_ERROR</constant>, mais elles sont générées par Zend Scripting Engine. Les fonctions ne doivent pas géné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 à E_WARNING, mais elles sont + Elles sont similaires à <constant>E_WARNING</constant>, mais elles sont générées par Zend Scripting Engine. Les fonctions ne doivent pas géné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 à E_ERROR. Elle est + <constant>E_USER_ERROR</constant> est comparable à <constant>E_ERROR</constant>. Elle est générée en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas géné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 à E_WARNING. Elle est + <constant>E_USER_WARNING</constant> est comparable à <constant>E_WARNING</constant>. Elle est générée en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas géné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 à E_NOTICE. Elle est + <constant>E_USER_WARNING</constant> est comparable à <constant>E_NOTICE</constant>. Elle est générée en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas géné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éservés en PHP</title> + <title>Mots réservés en PHP</title> <para> Cette annexes est une liste d'identifiant prédéfinis en PHP. Aucun des identifiants utilisés ici ne doit être repris comme nom de @@ -13,370 +13,203 @@ <sect1 id="reserved.keywords"> <title>Liste de mots-clé</title> - <para> + <para> Ces mots ont un sens spécial en PHP. Certains représentent des objets qui ressemblent à des fonctions, d'autres à 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éservé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ôte qui lit le script courant. La résolution + DNS inverse est basée sur la valeur de <varname>REMOTE_ADDR</varname>. + </simpara> + <note> + <simpara> + Votre serveur web doit être configuré pour cré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é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>
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égration. </para> - <note> +<!-- +<note> <para> Un projet de Visual Basic pour Linux a débuté, et il incluera un cré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éfinition d'une fonction (prototype)</title> + <para> + Chaque fonction est documentée pour permettre un accès rapide, + et savoir décoder le manuel rendra votre lecture plus facile. Plutôt + que de dépendre d'exemples prêts en copier/coller, il est mieux de + savoir lire la définition d'une fonction. Voici comment : + </para> + <note> + <title> + Pré-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ême des sens importants. + </para> + </note> + <para> + Les définitions de fonctions vous indique quel type de données est + <link linkend="functions.returning-values">retourné</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îne string . + </screen> + </para> + <para> + <table> + <title>Explications de la dé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ésente dans toutes les versions de PHP 3 et PHP 4. + </entry> + </row> + <row> + <entry> + int + </entry> + <entry> + Type de valeur retourné par cette fonction, qui est en l'occurence + un &integer; (i.e. la taille d'une chaîne est mesurée par un nombre). + </entry> + </row> + <row> + <entry> + ( string str ) + </entry> + <entry> + Le premier (et ici le seul) paramètre à fournir à strlen est le paramètre + <parameter>str</parameter>, qui doit être du type &string;. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Nous pourrions réécrire ce prototype avec une version plus générique : + </para> + <para> + <screen role="html"> + type_retourné nom_de_la fonction ( type_du_paramètre nom_du_paramètre ) + </screen> + </para> + <para> + Plusieurs fonctions ont besoin de plusieurs paramè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éussite ( le paramètre + <parameter>needle</parameter> a été trouvé dans le tableau + <parameter>haystack</parameter>) ou &false; en cas d'échec + ( le paramètre <parameter>needle</parameter> n'a pas été trouvé + dans le tableau <parameter>haystack</parameter>). Le premier + paramètre s'appelle <parameter>needle</parameter> et il peut être + de différents <link linkend="language.types">types</link> : il porte + donc la mention <emphasis>mixed</emphasis>. Le paramètre <parameter>needle</parameter> + (ce que nous recherchons) peut ê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ètre. Le troisième paramètre, <parameter>strict</parameter>, + est optionnel. Tous les paramètres optoinnels sont placés entre crochets. + La manuel indique que le paramètre <parameter>strict</parameter> vaut par dé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ées dans ce manuel</title> + <para> + Cette documentation contient des informations sur PHP 4, avec + des notes compatibilités et de migration depuis PHP 3. Le comportement, + les paramètres, les valeurs retournées, etc... qui ont changé entre + deux versions du manuel &php; sont documentées dans les notes utilisateurs, + et dasn le manuel lui même. + </para> + <para> + Vous pouvez trouvez des portions de documentation destinées aux + versions CVS de PHP, ce qui signifie que les toutes dernières versions + de développement de PHP proposent ces fonctionnalités. Si vous n'êtes + pas un développeur PHP, et que vous n'avez pas la possibilité d'utiliser + la dernière version de PHP, les fonctionnalités indiquées comme + "disponibles uniquement en CVS" ne vous seront pas accessibles. Toutes fois, + ces fonctionnalité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ée (par exemple, des fonctions + destinées à 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és qui seront disponible avec la + prochaine publication de PHP. + </para> + </sect1> <sect1 id="about.more"> <title>Où trouver plus d'information sur PHP?</title> @@ -247,6 +400,23 @@ </para> </sect1> + <sect1 id="about.translations.fr"> + <title>Traduction française</title> + <para> + La version française est traduite quotidiennement et disponible + chez Nexen (<ulink url="&url.nexen;">nexen.net/</ulink>). + Ce manuel a été généré à partir de + la documentation originale en anglais du PHP Documentation Group, au + format XML. Elle est 100% compatible avec le système de génération + du groupe PHP. Elle est traité avec un système développé par + Nexen pour produire divers autres formats. + </para> + <para> + Pour les problèmes liés à la traduction, vous pouvez + contacter directement l'é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é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 à 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ébuggeur PHP</title> <sect1 id="debugger-about"> @@ -9,8 +9,15 @@ </simpara> <simpara> PHP 4 n'inclut aucun support de débuggage. + Vous pouvez toutes fois utiliser un des débogeur externe. + Le <ulink url="&url.zend.ide;">Studio Zend</ulink> inclut + un débogeur et il y a aussi des dé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é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'équipe de développement de PHP inclue des douzaines de développeurs, et d'autres équipes travaillent à des projets lié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é 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 à PHP 3.0</title> <sect1 id="migration.about"> @@ -42,18 +42,22 @@ <example> <title>Migration: Migration: balises start/end </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est du code PHP/FI 2.0.\n";? -?> +?> +]]> </programlisting> </example> Comme en version 2.0, PHP/FI accepte aussi cette variante : <example> <title>Migration: premières nouvelles balises PHP</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est du code PHP 3.0!\n"; -?> +?> +]]> </programlisting> </example> Notez bien que la balise de fin contient désormais un point @@ -65,9 +69,11 @@ <example> <title>Migration: Nouvelles balises PHP</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est du code PHP 3.0!\n"; -?> +?> +]]> </programlisting> </example> Certains d'entre vous rencontrent des problèmes avec les éditeurs qui @@ -76,9 +82,12 @@ variation suivante a été introduite : <example><title>Nouvelles balises PHP</title> <programlisting role="php"> -<script language="php"> +<![CDATA[ +<script language="php"> echo "Ceci est du code PHP 3.0!\n"; -</script> +</script> +]]> + </programlisting> </example> </para> @@ -93,7 +102,8 @@ <example> <title>Migration: ancienne syntaxe if..endif </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if ($foo); echo "oui\n"; elseif ($bar); @@ -101,13 +111,15 @@ else; echo "non\n"; endif; -?> +?> +]]> </programlisting> </example> <example> <title>Migration: nouvelle syntaxe if..endif</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if ($foo): echo "oui\n"; elseif ($bar): @@ -115,7 +127,8 @@ else: echo "non\n"; endif; -?> +?> +]]> </programlisting> </example> Notez que les points virgules ont été remplacée par des points dans @@ -129,20 +142,24 @@ <example> <title>Migration: ancienne syntaxe while..endwhile </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php while ($more_to_come); ... endwhile; -?> +?> +]]> </programlisting> </example> <example><title>Migration: nouvelle syntaxe while..endwhile</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php while ($more_to_come): ... endwhile; -?> +?> +]]> </programlisting> </example> </para> @@ -164,7 +181,8 @@ Considérez les lignes suivantes: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a[0]=5; $a[1]=7; $key = key($a); @@ -172,7 +190,8 @@ echo "$keyn"; next($a); } -?> +?> +]]> </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"> -<?php +<![CDATA[ +<?php while ((string)$key != "") { -?> +?> +]]> </programlisting> </informalexample> </para> @@ -235,21 +256,25 @@ Migration depuis 2.0: valeur retournées, ancienne façon </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $fp = fopen($file, "r"); if ($fp == -1); - echo("Impossible d'ouvrir le fichier $file en lecture <br>\n"); + echo("Impossible d'ouvrir le fichier $file en lecture <br>\n"); endif; -?> +?> +]]> </programlisting> </example> <example> <title>Migration depuis 2.0: valeur retournées, nouvelle façon</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $fp = @fopen($file, "r") or - print("Impossible d'ouvrir le fichier $file en lecture<br>\n"); -?> + 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énation de chaînes</title> <programlisting role="php"> -<?php +<![CDATA[ +<?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 role="php"> -<?php +<![CDATA[ +<?php echo "1"."1"; -?> +?> +]]> </programlisting> <programlisting role="php"> -<?php +<![CDATA[ +<?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 role="php"> -<?php +<![CDATA[ +<?php $a = 1; $b = 1; echo $a.$b; -?> +?> +]]> </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 à 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é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 été renommé en <filename>php.ini</filename>. + a été renommé 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 été modifiés. <informalexample> <programlisting> -application/x-httpd-php3 --> application/x-httpd-php -application/x-httpd-php3-source --> 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éjà compilé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 @@ à 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ô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écurité du safe mode. + exemple, le &safemode; (si vous pouviez modifier les configurations dans le fichier + <filename>.htaccess</filename>, cela annulerait toute la sécurité 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é? Supposons que vous souhaitiez afficher toutes les erreurs, hormis les alertes de style, qui sont repéré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 & ~ ( E_NOTICE )</literal>. Si vous voulez supprimer en plus les alertes, vous pouvez ajouter la constante appropriée, en la combinant avec l'opérateur @@ -282,8 +294,8 @@ de telle manière que le script lui donne accès à un niveau de droits supé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éliorera grandement votre style et la sécurité du code. </para> @@ -350,13 +362,14 @@ l'analyse a eu lieu, et est terminée. La fonction short_tags() a cessé 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é qui a disparu est le débuggeur - de PHP 3.0, comme décrit dans un autre appendice. Un nouveau - débuggeur est promis par Zend, mais il n'a pas encore montré - le bout de son nez. + Une autre fonctionnalité qui ne fait pas partie de &php; + est le débogeur. Des débogueurs réalisés par des tiers + sont disponibles, mais ne sont pas distribués avec &php; + D'autres extensions du Zend Engine sont aussi disponibles auprè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înes</title> <para> PHP 4.0 dispose d'un nouveau mécanisme de substitution des @@ -439,6 +452,37 @@ problèmes ultérieurs. </para> </sect1> + <section id="migration4.variables"> + <title>Gestion des variables globales</title> + <para> + Alors que la gestion des variables globales a été surtout étudiée + pour être simple en &php; 3 et aux premières versions de &php; 4, + la sécurité est devenue la priorité avec les dernières versions. + Alors qu'en &php; 3, le code suivant fonctionnait sans problème, + en &php; 4, il faut utiliser <literal>unset($GLOBALS["id"]);</literal>. + Ce n'est qu'un des problème lié à 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éfé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éveloppement PHP</title> <sect1 id="phpdevel-addfunc"> @@ -9,8 +9,10 @@ <para> Toutes les fonctions suivent le schéma suivant : <programlisting role="c"> +<![CDATA[ void php3_foo(INTERNAL_FUNCTION_PARAMETERS) { } +]]> </programlisting> Même si votre fonction ne prend aucun argument, c'est comme cela qu'elle doit être appelé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,&arg1,&arg2)==FAILURE) { +if (ARG_COUNT(ht) != 2 || getParameters(ht,2,&arg1,&arg2)==FAILURE) { WRONG_PARAM_COUNT; } +]]> </programlisting> </example> NOTE: Les arguments peuvent être passé par valeur ou par @@ -66,12 +70,14 @@ <example> <title>Fonctions à nombre d'arguments variable</title> <programlisting role="c"> +<![CDATA[ pval *arg1, *arg2, *arg3; int arg_count = ARG_COUNT(ht); -if (arg_count < 2 || arg_count > 3 || - getParameters(ht,arg_count,&arg1,&arg2,&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îne est "" ou "0" elle devient 0, 1 sinon */ convert_string_to_number(arg1); /* Convertit une chaîne en LONG ou DOUBLE suivant la chaîne */ +]]> </programlisting> </para> <simpara> @@ -147,9 +155,9 @@ <para> La valeur de l'argument est enregistrée dans une union. Les membres sont : <itemizedlist> - <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> + <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émoire</title> - <simpara> - Soyez prudent. La valeur doit être placée dans une portion de - mémoire créée avec malloc(), sinon le gestionnaire de - mémoire essayera de libérer le pointeur plus tard. Ne passez - aucune mémoire allouée statiquement à 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 être + placée dans une portion de + mémoire créée avec malloc(), sinon le gestionnaire de + mémoire essayera de libérer le pointeur plus tard. Ne passez + aucune mémoire allouée statiquement à SET_VAR_STRING. + </simpara> + <simpara> + Les tables des symboles de &php; est une table de hash. A n'importe quel moment, &symbol_table est un pointeur sur la table principale, et active_symbol_table pointe sur la table actuellement utilisée. (ces deux tables peuvent être identiques au dé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"),&pvalue); +<![CDATA[ +hash_find(active_symbol_table,"foo",sizeof("foo"),&pvalue); check(pvalue.type); +]]> </programlisting> </example> En PHP 3.0, les tableaux sont implémentés en utilisant les @@ -267,9 +275,11 @@ <example> <title>Initialisation d'un tableau</title> <programlisting role="c"> +<![CDATA[ pval arr; -if (array_init(&arr) == FAILURE) { /*Initialiation échouée*/ }; -hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +if (array_init(&arr) == FAILURE) { /*Initialiation échouée*/ }; +hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +]]> </programlisting> </example> Ce code déclare un nouveau tableau, appelé $foo, dans la table @@ -282,17 +292,19 @@ <example> <title>Ajout d'entrées dans un tableau.</title> <programlisting role="c"> +<![CDATA[ pval entry; entry.type = IS_LONG; entry.value.lval = 5; /* définit $foo["bar"] = 5 */ -hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); +hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); /* définit $foo[7] = 5 */ -hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); +hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); /* définit la prochaine place libre dans $foo[], * $foo[8], qui sera 5 (comme en php2) */ -hash_next_index_insert(arr.value.ht,&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éré dans une @@ -311,25 +323,31 @@ comme ceci : </simpara> <programlisting role="c"> +<![CDATA[ if (array_init(return_value) == FAILURE) { échec...; } +]]> </programlisting> <simpara> puis ajouter les valeurs grâ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ûr, si l'ajout n'est pas fait juste aprè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 **)&arr)==FAILURE) +if (hash_find(active_symbol_table,"foo",sizeof("foo"),(void **)&arr)==FAILURE) { introuvable... } else -{ utilisez arr->value.ht... } +{ utilisez arr->value.ht... } +]]> </programlisting> </para> <simpara> @@ -428,7 +446,9 @@ les fonctions habituelles de .value.ht). L'enregistrement reél peut ê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émoire pour la ressource, et l'acquiert ... */ /* Ajoute la nouvelle ressource dans la liste */ -return_value->value.lval = php3_list_insert((void *) resource, LE_RESOURCE_TYPE); -return_value->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->value.lval, &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->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->value.lval); +php3_list_delete(resource_id->value.lval); +]]> </programlisting> </example> Les types de ressources doivent être enregistré 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ées par défaut, et indique que le script a rencontré quelque chose qui peut ê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ées par défaut, mais n'interrompent pas l'éxécution du script. Elles indiquent un problè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ées par défaut, et l'exé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 être générées que par l'analyseur. Elles ne sont citées ici que dans le but d'ê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énérées par le code de PHP. Les fonctions ne doivent pas géné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 à E_WARNING, mais elles sont + Elles sont similaires à <constant>E_WARNING</constant>, mais elles sont générées par le code de PHP. Les fonctions ne doivent pas géné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 à E_ERROR, mais elles sont + Elles sont similaires à <constant>E_ERROR</constant>, mais elles sont générées par Zend Scripting Engine. Les fonctions ne doivent pas géné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 à E_WARNING, mais elles sont + Elles sont similaires à <constant>E_WARNING</constant>, mais elles sont générées par Zend Scripting Engine. Les fonctions ne doivent pas géné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 à E_ERROR. Elle est + <constant>E_USER_ERROR</constant> est comparable à <constant>E_ERROR</constant>. Elle est générée en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas géné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 à E_WARNING. Elle est + <constant>E_USER_WARNING</constant> est comparable à <constant>E_WARNING</constant>. Elle est générée en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas géné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 à E_NOTICE. Elle est + <constant>E_USER_WARNING</constant> est comparable à <constant>E_NOTICE</constant>. Elle est générée en PHP par l'utilisation de la fonction <function>trigger_error</function>. Les fonctions ne doivent pas géné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éservés en PHP</title> + <title>Mots réservés en PHP</title> <para> Cette annexes est une liste d'identifiant prédéfinis en PHP. Aucun des identifiants utilisés ici ne doit être repris comme nom de @@ -13,370 +13,203 @@ <sect1 id="reserved.keywords"> <title>Liste de mots-clé</title> - <para> + <para> Ces mots ont un sens spécial en PHP. Certains représentent des objets qui ressemblent à des fonctions, d'autres à 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éservé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ôte qui lit le script courant. La résolution + DNS inverse est basée sur la valeur de <varname>REMOTE_ADDR</varname>. + </simpara> + <note> + <simpara> + Votre serveur web doit être configuré pour cré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é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>