cvs: phpdoc /fr/language variables.xml
| From: | Damien Seguy | Date: | Tue, 23 Apr 2002 04:03:24 +0000 |
| Subject: | cvs: phpdoc /fr/language variables.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969344732@lists.php.net to get a copy of this message | ||
dams Tue Apr 23 00:03:24 2002 EDT
Modified files:
/phpdoc/fr/language variables.xml
Log:
Updated with the 4.1.0 new variables.
Index: phpdoc/fr/language/variables.xml diff -u phpdoc/fr/language/variables.xml:1.31 phpdoc/fr/language/variables.xml:1.32 --- phpdoc/fr/language/variables.xml:1.31 Tue Jan 29 18:18:20 2002 +++ phpdoc/fr/language/variables.xml Tue Apr 23 00:03:23 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.31 $ --> +<!-- $Revision: 1.32 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -106,6 +106,159 @@ de ces variables ne seront pas accessibles lorsque PHP fonctionne en exécutable. </simpara> + <warning> + <simpara> + En PHP 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont + disponibles dans l'environnement global a changé. Les variables + d'entrées et de serveurs ne sont plus <emphasis>par défaut</emphasis> + placées dans le contexte d'exécution global. Elles sont placées dans + les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. + </simpara> + <simpara> + Vous pouvez toujours forcer l'ancien comportement de PHP en le configurant + avec <link linkend="ini.register-globals">register_globals</link> à + <literal>On</literal> votre fichier &php.ini;. + </simpara> + <simpara> + Pour plus d'informations et d'explications sur ce changement, voyez + <ulink url="&url.php.release4.1.0;">l'annonce de PHP 4.1.0</ulink> (en anglais). + </simpara> + </warning> + <simpara> + Depuis la version 4.1.0, PHP fourni un jeu de tableaux + prédéfinis, contenant les variables du serveur (si possible), les + variables d'environnement et celle d'entrées. Ces nouveaux tableaux + sont un peut particuliers, car ils ont automatiquement globaux : + ils sont automatiquement disponibles dans tous les environnements + d'exécution, sans avoir à utiliser le mot réservé <literal>global</literal>. + Pour cette raison, ils sont dits 'auto-globaux' ou bien encore + 'superglobaux' (il n'y a pas de mécanisme PHP pour créer de telles + variables. Les superglobales sont listées ci-dessous. Cependant, pour + connaître le détails de leur contenu, et une présentation approfondie + sur les variables prédéfinies PHP, et leur nature, reportez vous + à la section <link linkend="reserved.variables">variables prédefinies</link>. + </simpara> + + <variablelist id="language.variables.superglobals"> + <title>Tableaux superglobaux de PHP</title> + <varlistentry> + <term><link linkend="reserved.variables.globals">$GLOBALS</link></term> + <listitem> + <simpara> + Contient une référence sur chaque variable qui est actuellement disponible + dans l'environnement d'exécution global. Les clés de ce tableau sont les + noms des variables globales. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.server">$_SERVER</link></term> + <listitem> + <simpara> + Les variables fournies par le serveur web, ou bien directement + liées à l'environnement d'exécution du script courant. C'est + la nouvelle version de l'ancienne variable <varname>$HTTP_SERVER_VARS</varname>, + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.get">$_GET</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP en méthode GET. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_GET_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.post">$_POST</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP en méthode POST. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_POST_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.cookies">$_COOKIE</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP, dans les cookies. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_COOKIE_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.files">$_FILES</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP, suite à un téléchargement de fichier. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_POST_FILES</varname> + qui est maintenant obsolète, mais toujours là. Voir + <link linkend="features.file-upload.post-method">Téléchargement par méthode POST</link>, + pour plus d'informations. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.environment">$_ENV</link></term> + <listitem> + <simpara> + Les variables fournies par l'environnement. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_ENV_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.request">$_REQUEST</link></term> + <listitem> + <simpara> + Les variables fournies au script par n'importe quel mécanisme d'entrée + et qui ne doit recevoir une confiance limitée. Note : lorsque + vous exécutez un script en ligne de commande, cette variable ne + va <emphasis>pas</emphasis> inclure les variables <varname>argv</varname> + et <varname>argc</varname>. Elles seront présentes dans la variable + <varname>$_SERVER</varname>. La présence et la valeur des entrées + de ce tableau sont réglés par la directive + <link linkend="ini.variables-order">variables_order</link>. Ce tableau + n'est l'évolution d'aucune variable d'avant PHP 4.1.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.session">$_SESSION</link></term> + <listitem> + <simpara> + Les variables qui sont actuellement enregistrées dans la session attachée + au script. which are currently registered to a script's + session.C'est la nouvelle version de l'ancienne variable <varname>$HTTP_SESSION_VARS</varname>. + Voir le chapitre <link linkend="ref.session">Sessions handling functions</link> + pour plus d'informations. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1 id="language.variables.old"> + <warning> + <simpara> + Cette section est la documentation qui avait cours jusqu'en PHP + version 4.1.2. Elle est laissée ici pour assurer la transition + avec les nouvelles versions, qui ont <emphasis>abandonné définitivement</emphasis> + leur usage. Nous recommandons vivement au lecteur la + <link linkend="language.variables.superglobals">section précédente</link>. + </simpara> + <simpara> + Pour assurer une meilleure compatibilité de vos scripts avec + les nouvelles versions de PHP, n'utilisez plus ces variables. + </simpara> + </warning> <simpara> Malgré ces données, voici une liste de variables prédéfinies, qui seront accessibles avec une @@ -800,7 +953,7 @@ </simpara> <note> <para> - La directive de configuration <link + La directive de configuration <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> affecte les valeurs issues des méthodes GET et POST ainsi aue des Cookies. Si cette directive est active, une valeur telle que <literal>It's "PHP!"</literal>
Index: phpdoc/fr/language/variables.xml diff -u phpdoc/fr/language/variables.xml:1.31 phpdoc/fr/language/variables.xml:1.32 --- phpdoc/fr/language/variables.xml:1.31 Tue Jan 29 18:18:20 2002 +++ phpdoc/fr/language/variables.xml Tue Apr 23 00:03:23 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.31 $ --> +<!-- $Revision: 1.32 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -106,6 +106,159 @@ de ces variables ne seront pas accessibles lorsque PHP fonctionne en exécutable. </simpara> + <warning> + <simpara> + En PHP 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont + disponibles dans l'environnement global a changé. Les variables + d'entrées et de serveurs ne sont plus <emphasis>par défaut</emphasis> + placées dans le contexte d'exécution global. Elles sont placées dans + les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. + </simpara> + <simpara> + Vous pouvez toujours forcer l'ancien comportement de PHP en le configurant + avec <link linkend="ini.register-globals">register_globals</link> à + <literal>On</literal> votre fichier &php.ini;. + </simpara> + <simpara> + Pour plus d'informations et d'explications sur ce changement, voyez + <ulink url="&url.php.release4.1.0;">l'annonce de PHP 4.1.0</ulink> (en anglais). + </simpara> + </warning> + <simpara> + Depuis la version 4.1.0, PHP fourni un jeu de tableaux + prédéfinis, contenant les variables du serveur (si possible), les + variables d'environnement et celle d'entrées. Ces nouveaux tableaux + sont un peut particuliers, car ils ont automatiquement globaux : + ils sont automatiquement disponibles dans tous les environnements + d'exécution, sans avoir à utiliser le mot réservé <literal>global</literal>. + Pour cette raison, ils sont dits 'auto-globaux' ou bien encore + 'superglobaux' (il n'y a pas de mécanisme PHP pour créer de telles + variables. Les superglobales sont listées ci-dessous. Cependant, pour + connaître le détails de leur contenu, et une présentation approfondie + sur les variables prédéfinies PHP, et leur nature, reportez vous + à la section <link linkend="reserved.variables">variables prédefinies</link>. + </simpara> + + <variablelist id="language.variables.superglobals"> + <title>Tableaux superglobaux de PHP</title> + <varlistentry> + <term><link linkend="reserved.variables.globals">$GLOBALS</link></term> + <listitem> + <simpara> + Contient une référence sur chaque variable qui est actuellement disponible + dans l'environnement d'exécution global. Les clés de ce tableau sont les + noms des variables globales. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.server">$_SERVER</link></term> + <listitem> + <simpara> + Les variables fournies par le serveur web, ou bien directement + liées à l'environnement d'exécution du script courant. C'est + la nouvelle version de l'ancienne variable <varname>$HTTP_SERVER_VARS</varname>, + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.get">$_GET</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP en méthode GET. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_GET_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.post">$_POST</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP en méthode POST. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_POST_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.cookies">$_COOKIE</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP, dans les cookies. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_COOKIE_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.files">$_FILES</link></term> + <listitem> + <simpara> + Les variables fournies par le protocole HTTP, suite à un téléchargement de fichier. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_POST_FILES</varname> + qui est maintenant obsolète, mais toujours là. Voir + <link linkend="features.file-upload.post-method">Téléchargement par méthode POST</link>, + pour plus d'informations. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.environment">$_ENV</link></term> + <listitem> + <simpara> + Les variables fournies par l'environnement. + C'est la nouvelle version de l'ancienne variable <varname>$HTTP_ENV_VARS</varname> + qui est maintenant obsolète, mais toujours là. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.request">$_REQUEST</link></term> + <listitem> + <simpara> + Les variables fournies au script par n'importe quel mécanisme d'entrée + et qui ne doit recevoir une confiance limitée. Note : lorsque + vous exécutez un script en ligne de commande, cette variable ne + va <emphasis>pas</emphasis> inclure les variables <varname>argv</varname> + et <varname>argc</varname>. Elles seront présentes dans la variable + <varname>$_SERVER</varname>. La présence et la valeur des entrées + de ce tableau sont réglés par la directive + <link linkend="ini.variables-order">variables_order</link>. Ce tableau + n'est l'évolution d'aucune variable d'avant PHP 4.1.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.session">$_SESSION</link></term> + <listitem> + <simpara> + Les variables qui sont actuellement enregistrées dans la session attachée + au script. which are currently registered to a script's + session.C'est la nouvelle version de l'ancienne variable <varname>$HTTP_SESSION_VARS</varname>. + Voir le chapitre <link linkend="ref.session">Sessions handling functions</link> + pour plus d'informations. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect1> + + <sect1 id="language.variables.old"> + <warning> + <simpara> + Cette section est la documentation qui avait cours jusqu'en PHP + version 4.1.2. Elle est laissée ici pour assurer la transition + avec les nouvelles versions, qui ont <emphasis>abandonné définitivement</emphasis> + leur usage. Nous recommandons vivement au lecteur la + <link linkend="language.variables.superglobals">section précédente</link>. + </simpara> + <simpara> + Pour assurer une meilleure compatibilité de vos scripts avec + les nouvelles versions de PHP, n'utilisez plus ces variables. + </simpara> + </warning> <simpara> Malgré ces données, voici une liste de variables prédéfinies, qui seront accessibles avec une @@ -800,7 +953,7 @@ </simpara> <note> <para> - La directive de configuration <link + La directive de configuration <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> affecte les valeurs issues des méthodes GET et POST ainsi aue des Cookies. Si cette directive est active, une valeur telle que <literal>It's "PHP!"</literal>