cvs: phpdoc /fr/appendices reserved.xml

From:	Damien Seguy	Date:	Tue, 23 Apr 2002 04:02:19 +0000
Subject:	cvs: phpdoc /fr/appendices reserved.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969344731@lists.php.net to get a copy of this message

dams Tue Apr 23 00:02:19 2002 EDT Modified files: /phpdoc/fr/appendices reserved.xml Log: Updated with the 4.1

Index: phpdoc/fr/appendices/reserved.xml diff -u phpdoc/fr/appendices/reserved.xml:1.9 phpdoc/fr/appendices/reserved.xml:1.10 --- phpdoc/fr/appendices/reserved.xml:1.9 Wed Nov 14 17:22:38 2001 +++ phpdoc/fr/appendices/reserved.xml Tue Apr 23 00:02:19 2002 @@ -1,2 +1,1282 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<appendix id="reserved"> <title>Mot réservés en PHP</title> <para> Voici la liste des mots réservés en PHP : ce sont généralement des <link linkend="language.constants">constantes</link> ou des <link linkend="language.variables.predefined">variables réservées</link>. Vous ne trouverez aucune fonction ici, mais plutôt des éléments de langage. Evitez de les utiliser comme nom de variable, fonction constante ou méthodes, car cela conduira certainement à 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></appendix> \ No newline at end of file + +<appendix id="reserved"> + <title>Mot 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 + variable ou de fonction dans vos scripts. Ces identifiants incluent + des mots clés, des constantes, des classes, et es variables + prédéfinies. Ces listes ne sont pas complètes ou exhaustives. + </para> + + <sect1 id="reserved.keywords"> + <title>Liste de mots-clé</title> + + <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> + </sect1> + <sect1 id="reserved.variables"> + <title>Variables prédéfinies</title> + + <sect2 id="reserved.variables.server"> + <title>Variables de serveur : <varname>$_SERVER</varname></title> + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_SERVER_VARS</varname>. + </simpara> + </note> + + <simpara> + <varname>$_SERVER</varname> is an array containing information + such as headers, paths, and script locations. The entries in this + array are created by the webserver. There is no guarantee that + every webserver will provide any of these; servers may omit some, + or provide others not listed here. That said, a large number of + these variables are accounted for in the <ulink + url="&url.cgispec;">CGI 1.1 specification</ulink>, so you should + be able to expect those. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_SERVER;</command> pour y accéder, comme + vous le faisiez avec <varname>$HTTP_SERVER_VARS</varname>. + </simpara> + + <simpara> + <varname>$HTTP_SERVER_VARS</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_SERVER</varname> et <varname>$HTTP_SERVER_VARS</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + + <simpara> + You may or may not find any of the following elements in + $_SERVER. Note that few, if any, of these will be available (or + indeed have any meaning) if running PHP on the command line. + </simpara> + + <para> + <variablelist> + <varlistentry> + <term>'<varname>PHP_SELF</varname>'</term> + <listitem> + <simpara> + Le nom du fichier du script en cour d'éxécution, par + rapport au document root. + Par exemple, <varname>$_SERVER['PHP_SELF']</varname> dans le script + situé à l'adresse <filename>http://www.monsite.com/test.php/foo.bar</filename> + sera <filename>/test.php/foo.bar</filename>. + </simpara> + <simpara> + Si PHP fonctionne en ligne de commande, + cette variable n'est pas disponible. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>argv</varname>'</term> + <listitem> + <simpara> + Tableau des arguments passées au script. Lorsque le script + est appelé en ligne de commande, cela donne accès + aux arguments, comme en langage C. Lorsque le script est + appelé avec la méthode GET, ce tableau contiendra + la chaîne de requête. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>argc</varname>'</term> + <listitem> + <simpara> + Contient le nombre de paramètres de la ligne de commande + passés au script (si le script fonctionne en ligne de commande). + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>GATEWAY_INTERFACE</varname>'</term> + <listitem> + <simpara> + Numéro de révision de l'interface CGI du serveur : + i.e. '<literal>CGI/1.1</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_NAME</varname>'</term> + <listitem> + <simpara> + Le nom du serveur hôte qui éxécute le script suivant. + Si le script est exécuté sur un hôte virtuel, ce sera + la valeur définie pour cet hôte virtuel. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_SOFTWARE</varname>'</term> + <listitem> + <simpara> + Chaîne d'identification du serveur, qui est donnée dans + les en-têtes lors de la réponse aux requêtes. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_PROTOCOL</varname>'</term> + <listitem> + <simpara> + Nom et révision du protocole de communication : i.e. '<literal>HTTP/1.0</literal>'; + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>REQUEST_METHOD</varname>'</term> + <listitem> + <simpara> + Méthode de requête utilisée pour accéder + à la page; i.e. '<literal>GET</literal>', + '<literal>HEAD</literal>', '<literal>POST</literal>', '<literal>PUT</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>QUERY_STRING</varname>'</term> + <listitem> + <simpara> + La chaîne de requête, si elle existe, qui est + utilisée pour accéder à la page. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>DOCUMENT_ROOT</varname>'</term> + <listitem> + <simpara> + La racine sous laquelle le script courant est exécuté, + comme défini dans la configuration du serveur. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_ACCEPT</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>Accept:</literal> de la + requête courante, s'il y en a une. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_ACCEPT_CHARSET</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>Accept-Charset:</literal> + de la requête courante, s'elle existe. Par exemple : + '<literal>iso-8859-1,*,utf-8</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_ACCEPT_ENCODING</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>Accept-Encoding:</literal> + de la requête courante, si elle existe. Par exemple : '<literal>gzip</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_ACCEPT_LANGUAGE</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>Accept-Language:</literal> de + la requête courante, si elle existe. Par exemple : '<literal>fr</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_CONNECTION</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>Connection:</literal> de la + requête courante, si elle existe. Par exemple : '<literal>Keep-Alive</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_HOST</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>Host:</literal> de la + requête courante, si elle existe. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_REFERER</varname>'</term> + <listitem> + <simpara> + L'adresse de la page (si elle existe) qui a conduit le + client à la page courante. Cette valeur est + affectée par le client, et tous les clients ne le font pas. + Certains navigateur permettent même de modifier la valeur de + <varname>HTTP_REFERER</varname>, sous forme de fonctionnalité. + En bref, ce n'est pas une valeur de confiance. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTP_USER_AGENT</varname>'</term> + <listitem> + <simpara> + Contenu de l'en-tête <literal>User_Agent:</literal> de + la requête courante, si elle existe. C'est une chaîne + qui décrit le client HTML utilisé pour voir + la page courante. Par exemple : + <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)</computeroutput>. + Entre autres choses, vous pouvez utiliser cette valeur avec + <function>get_browser</function> pour optimiser votre page + en fonction des capacités du client. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>REMOTE_ADDR</varname>'</term> + <listitem> + <simpara> + L'adresse IP du client qui demande la page courante. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>REMOTE_PORT</varname>'</term> + <listitem> + <simpara> + Le port utilisé par la machine cliente pour communiquer + avec le serveur web. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SCRIPT_FILENAME</varname>'</term> + <listitem> + <simpara> + Le chemin absolu jusqu'au script courant. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_ADMIN</varname>'</term> + <listitem> + <simpara> + La valeur donnée à la directive SERVER_ADMIN + (pour Apache), dans le fichier de configuration. Si le script + est exécuté par un hôte virtuel, ce sera la + valeur définie par l'hôte virtuel. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_PORT</varname>'</term> + <listitem> + <simpara> + Le port de la machine serveur utilisé pour les + communications. Par défaut, c'est '80'. En utilisant + SSL, par exemple, il sera remplacé par le numéro + de port HTTP sécurisé. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_SIGNATURE</varname>'</term> + <listitem> + <simpara> + Chaîne contenant le numéro de version du serveur + et le nom d'hôte virtuel, qui sont ajoutés aux + pages générées par le serveur, si cette + option est activée. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>PATH_TRANSLATED</varname>'</term> + <listitem> + <simpara> + Chemin dans le système de fichier (pas le document root-) + jusqu'au script courant, une fois que le serveur a fait + une chemin traduction virtuel->réel. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SCRIPT_NAME</varname>'</term> + <listitem> + <simpara> + Contient le nom du script courant. Cela sert lorsque + les pages doivent s'appeler elles-mêmes. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>REQUEST_URI</varname>'</term> + <listitem> + <simpara> + L'URI qui a été fourni pour accéder + à cette page. Par exemple : '<literal>/index.html</literal>'. + </simpara> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </sect2> + + <sect2 id="reserved.variables.environment"> + <title>Variables d'environnement : <varname>$_ENV</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_ENV_VARS</varname>. + </simpara> + </note> + + <simpara> + Cette variable est importée dans l'espace de nom global de PHP, + depuis l'environnement dans lequel l'exécutable PHP fonctionne. + De nombreuses valeur sont fournies par le shell qui exécute PHP, + et différents systèmes pouvant disposer de différents shell, même + un début de liste serait ici impossible. Reportez vous à la documentation + de votre shell pour connaître une liste de variables prédéfinies. + </simpara> + + <simpara> + Les autres variables d'environnement incluent les variables CGI, + placées ici, indépendemment du fait que PHP fonctionne en tant + que CGI ou bien que module du serveur. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_ENV;</command> pour y accéder, comme + vous le faisiez avec <varname>$HTTP_ENV_VARS</varname>. + </simpara> + + <simpara> + <varname>$HTTP_ENV_VARS</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_ENV</varname> et <varname>$HTTP_ENV_VARS</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.cookies"> + <title>HTTP Cookies: <varname>$_COOKIE</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_COOKIE_VARS</varname>. + </simpara> + </note> + + <simpara> + Un tableau associatif des valeurs passées au script courant via + les cookies HTTP. Elle est automatiquement global dans tous les + contextes d'exécution. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_COOKIE;</command> pour y accéder, comme + vous le faisiez avec <varname>$HTTP_COOKIE_VARS</varname>. + </simpara> + + <simpara> + <varname>$HTTP_COOKIE_VARS</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_COOKIE</varname> et <varname>$HTTP_COOKIE_VARS</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.get"> + <title>HTTP GET variables: <varname>$_GET</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_GET_VARS</varname>. + </simpara> + </note> + + <simpara> + Un tableau associatif des valeurs passées au script courant via + le protocole HTTP et la méthode GET. Elle est automatiquement + globale dans tous les contextes d'exécution. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_GET;</command> pour y accéder, comme + vous le faisiez avec <varname>$HTTP_GET_VARS</varname>. + </simpara> + + <simpara> + <varname>$HTTP_GET_VARS</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_GET</varname> et <varname>$HTTP_GET_VARS</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.post"> + <title>HTTP POST variables: <varname>$_POST</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_POST_VARS</varname>. + </simpara> + </note> + + <simpara> + Un tableau associatif des valeurs passées au script courant via + le protocole HTTP et la méthode POST. Elle est automatiquement + globale dans tous les contextes d'exécution. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_POST;</command> pour y accéder, comme + vous le faisiez avec <varname>$HTTP_POST_VARS</varname>. + </simpara> + + <simpara> + <varname>$HTTP_POST_VARS</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_POST</varname> et <varname>$HTTP_POST_VARS</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.files"> + <title>Variable de téléchargement de fichier via HTTP : <varname>$_FILES</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_POST_FILES</varname>. + </simpara> + </note> + + <simpara> + Un tableau associatif des valeurs téléchargées au script courant via + le protocole HTTP et la méthode POST. Elle est automatiquement + globale dans tous les contextes d'exécution. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_FILES;</command> pour y accéder, comme + vous le faisiez avec <varname>$HTTP_POST_FILES</varname>. + </simpara> + + <simpara> + <varname>$HTTP_POST_FILES</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_FILES</varname> et <varname>$HTTP_POST_FILES</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.request"> + <title>Variables de requête : <varname>$_REQUEST</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle n'avait + pas d'équivalent. + </simpara> + </note> + + <simpara> + Un tableau associatif constitué du contenu des + variables <varname>$_GET</varname>, <varname>$_POST</varname>, + <varname>$_COOKIE</varname>, et <varname>$_FILES</varname>. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_REQUEST;</command> pour y accéder. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_REQUEST</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.session"> + <title>Session variables: <varname>$_SESSION</varname></title> + + <note> + <simpara> + Introduite en 4.1.0. Dans les versions plus anciennes, elle s'appelait + <varname>$HTTP_SESSION_VARS</varname>. + </simpara> + </note> + + <simpara> + Un tableau associatif des valeurs stockées dans les sessions, + et accessible au script courant. Elle est automatiquement + globale dans tous les contextes d'exécution. Voyez l'extension + <link linkend="ref.session">Sessions</link> pour plus de détails sur comment + est utilisée cette variable. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $_SESSION;</command> pour y accéder, comme vous le + faisiez avec <varname>$HTTP_SESSION_VARS</varname>. + </simpara> + + <simpara> + <varname>$HTTP_SESSION_VARS</varname> contient les mêmes + informations, mais n'est pas autoglobale. + </simpara> + + <simpara> + Si la directive <link linkend="ini.register-globals">register_globals</link> + est active, alors ces variables seront aussi rendues directement + accessible dans le contexte d'exécution global. C'est à dire séparément + des tableaux <varname>$_SESSION</varname> et <varname>$HTTP_SESSION_VARS</varname>. + Pour plus d'informations sur la sécurité de cette configuration, voyez le + chapitre <link linkend="security.registerglobals">Utiliser la directive Register + Globals</link>. Ces variables globales individuelles ne sont pas des globales. + </simpara> + </sect2> + + <sect2 id="reserved.variables.globals"> + <title>Variables globales: <varname>$GLOBALS</varname></title> + + <note> + <simpara> + <varname>$GLOBALS</varname> est disponible depuis PHP 3.0.0. + </simpara> + </note> + + <simpara> + Un tableau associatif contenant les références sur toutes les variables + globales actuellement définies dans le contexte d'exécution global du + script. Les noms des variables sont les index du tableau. + </simpara> + + <simpara> + Cette variable est une 'superglobal', ou globale automatique. + Cela signifie qu'elle est simplement disponible dans tous les + contextes d'exécution (fonctions ou méthodes). Vous n'avez pas + besoin de faire + <command>global $GLOBALS;</command> pour y accéder. + </simpara> + + </sect2> + + <sect2 id="reserved.variables.phperrormsg"> + <title>Le dernier message d'erreur : <varname>$php_errormsg</varname></title> + <simpara> + <varname>$php_errormsg</varname> est une variable qui contient le texte + de la dernière erreur générée par PHP. Cette variable sera uniquement + accessible dans le même contexte d'exécution que celui de la ligne + qui a généré l'erreur, et uniquement si la directive de configuration <link + linkend="ini.track-errors">track_errors</link> est activée (elle est + désactivée par défaut). + </simpara> + </sect2> + </sect1> + + + <sect1 id="reserved.classes"> + <title>Classes prédéfinies</title> + + <sect2 id="reserved.classes.standard"> + <title>Classes standards</title> + + <simpara> + Ces classes sont définies dans le jeu de classe standard + de PHP, inclus dans toute version de PHP. + </simpara> + + <variablelist> + <varlistentry> + <term><classname>Directory</classname></term> + <listitem> + <simpara> + La classe qui permet d'instantier <function>dir</function>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>stdClass</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="reserved.classes.ming"> + <title>Classes définies par <link linkend="ref.ming">Ming</link></title> + + <simpara> + Ces classes sont définies dans l'extension + <link linkend="ref.ming">Ming</link> et ne seront pas disponibles + si PHP a été compilé pour être exécuté dynamiquement, ou bien si + elles n'ont pas été compilées dans PHP. + </simpara> + + <variablelist> + <varlistentry> + <term><classname>swfshape</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swffill</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfgradient</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfbitmap</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swftext</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swftextfield</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swffont</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfdisplayitem</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfmovie</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfbutton</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfaction</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfmorph</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>swfsprite</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="reserved.classes.oci8"> + <title>Classes définies par <link linkend="ref.oci8">Oracle 8</link></title> + + <simpara> + Ces classes sont définies dans l'extension + <link linkend="ref.oci8">Oracle 8</link> et ne seront pas disponibles + si PHP a été compilé pour être exécuté dynamiquement, ou bien si + elles n'ont pas été compilées dans PHP. + </simpara> + + <variablelist> + <varlistentry> + <term><classname>OCI-Lob</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>OCI-Collection</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="reserved.classes.qtdom"> + <title>Classes définies par <link linkend="ref.qtdom">qtdom</link></title> + + <simpara> + Ces classes sont définies dans l'extension + <link linkend="ref.qtdom">qtdom</link> et ne seront pas disponibles + si PHP a été compilé pour être exécuté dynamiquement, ou bien si + elles n'ont pas été compilées dans PHP. + </simpara> + + <variablelist> + <varlistentry> + <term><classname>QDomDocument</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><classname>QDomNode</classname></term> + <listitem> + <simpara> + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + </sect1> +</appendix> +