[PHP-DOC] cvs: phpdoc /fr/language variables.xml

[Damien Seguy]

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&eacute;cutable.
    </simpara>
+   <warning>
+    <simpara>
+     En PHP 4.2.0 et plus r&eacute;cent, le jeu de variables 
+pr&eacute;d&eacute;finies qui sont
+     disponibles dans l'environnement global a chang&eacute;. Les variables
+     d'entr&eacute;es et de serveurs ne sont plus <emphasis>par 
+d&eacute;faut</emphasis>
+     plac&eacute;es dans le contexte d'ex&eacute;cution global. Elles sont 
+plac&eacute;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> &agrave;
+     <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&eacute;d&eacute;finis, contenant les variables du serveur (si possible), les
+    variables d'environnement et celle d'entr&eacute;es. Ces nouveaux tableaux
+    sont un peut particuliers, car ils ont automatiquement globaux : 
+    ils sont automatiquement disponibles dans tous les environnements
+    d'ex&eacute;cution, sans avoir &agrave; utiliser le mot r&eacute;serv&eacute; 
+<literal>global</literal>.
+    Pour cette raison, ils sont dits 'auto-globaux' ou bien encore
+    'superglobaux' (il n'y a pas de m&eacute;canisme PHP pour cr&eacute;er de telles
+    variables. Les superglobales sont list&eacute;es ci-dessous. Cependant, pour
+    conna&icirc;tre le d&eacute;tails de leur contenu, et une pr&eacute;sentation 
+approfondie
+    sur les variables pr&eacute;d&eacute;finies PHP, et leur nature, reportez vous
+    &agrave; la section <link linkend="reserved.variables">variables 
+pr&eacute;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&eacute;f&eacute;rence sur chaque variable qui est actuellement 
+disponible
+       dans l'environnement d'ex&eacute;cution global. Les cl&eacute;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&eacute;es &agrave; l'environnement d'ex&eacute;cution du script courant. 
+C'est
+       la nouvelle version de l'ancienne variable 
+<varname>$HTTP_SERVER_VARS</varname>,
+       qui est maintenant obsol&egrave;te, mais toujours l&agrave;.
+      </simpara>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><link linkend="reserved.variables.get">$_GET</link></term>
+     <listitem>
+      <simpara>
+       Les variables fournies par le protocole HTTP en m&eacute;thode GET.
+        C'est la nouvelle version de l'ancienne variable 
+<varname>$HTTP_GET_VARS</varname>
+       qui est maintenant obsol&egrave;te, mais toujours l&agrave;.
+      </simpara>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><link linkend="reserved.variables.post">$_POST</link></term>
+     <listitem>
+      <simpara>
+        Les variables fournies par le protocole HTTP en m&eacute;thode POST.
+        C'est la nouvelle version de l'ancienne variable 
+<varname>$HTTP_POST_VARS</varname>
+       qui est maintenant obsol&egrave;te, mais toujours l&agrave;.
+      </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&egrave;te, mais toujours l&agrave;.
+      </simpara>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><link linkend="reserved.variables.files">$_FILES</link></term>
+     <listitem>
+      <simpara>
+        Les variables fournies par le protocole HTTP, suite &agrave; un 
+t&eacute;l&eacute;chargement de fichier.
+        C'est la nouvelle version de l'ancienne variable 
+<varname>$HTTP_POST_FILES</varname>
+       qui est maintenant obsol&egrave;te, mais toujours l&agrave;. Voir
+       <link linkend="features.file-upload.post-method">T&eacute;l&eacute;chargement 
+par m&eacute;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&egrave;te, mais toujours l&agrave;.
+      </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&eacute;canisme 
+d'entr&eacute;e
+        et qui ne doit recevoir une confiance limit&eacute;e. Note : lorsque
+        vous ex&eacute;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&eacute;sentes dans la variable
+        <varname>$_SERVER</varname>. La pr&eacute;sence et la valeur des 
+entr&eacute;es
+        de ce tableau sont r&eacute;gl&eacute;s par la directive 
+        <link linkend="ini.variables-order">variables_order</link>. Ce tableau
+        n'est l'&eacute;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&eacute;es dans la session 
+attach&eacute;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&eacute;e ici pour assurer la transition
+     avec les nouvelles versions, qui ont <emphasis>abandonn&eacute; 
+d&eacute;finitivement</emphasis>
+     leur usage. Nous recommandons vivement au lecteur la 
+     <link linkend="language.variables.superglobals">section 
+pr&eacute;c&eacute;dente</link>.
+    </simpara>
+    <simpara>
+     Pour assurer une meilleure compatibilit&eacute; de vos scripts avec
+     les nouvelles versions de PHP, n'utilisez plus ces variables.
+    </simpara>
+   </warning>
    <simpara>
     Malgr&eacute; ces donn&eacute;es, voici une liste de variables
     pr&eacute;d&eacute;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&eacute;thodes GET et POST ainsi aue des Cookies. Si cette 
       directive est active, une valeur telle que <literal>It's "PHP!"</literal>