cvs: phpdoc /fr/language variables.xml
| From: | Damien Seguy | Date: | Tue, 14 Aug 2001 18:18:46 +0000 |
| Subject: | cvs: phpdoc /fr/language variables.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969337101@lists.php.net to get a copy of this message | ||
dams Tue Aug 14 14:18:46 2001 EDT
Modified files:
/phpdoc/fr/language variables.xml
Log:
Typos.
Index: phpdoc/fr/language/variables.xml diff -u phpdoc/fr/language/variables.xml:1.24 phpdoc/fr/language/variables.xml:1.25 --- phpdoc/fr/language/variables.xml:1.24 Mon Mar 19 12:06:31 2001 +++ phpdoc/fr/language/variables.xml Tue Aug 14 14:18:44 2001 @@ -1,3 +1,4 @@ +<!-- $Revision: 1.25 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -9,9 +10,9 @@ </simpara> <para> Les noms de variables suivent les mêmes règles de nommage que - les autres entitées PHP. Un nom de variable valide doit commencer par + les autres entités PHP. Un nom de variable valide doit commencer par une lettre ou un souligné (_), suivi de lettres, chiffres ou soulignés. - Exprimé sous forme d'une expression régulière, cela donne : + Exprimé sous la forme d'une expression régulière, cela donne : '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*' </para> <note> @@ -37,12 +38,12 @@ </para> <para> En PHP 3, les variables sont toujours assignées par valeur. - C'est à dire, lorsque vous assignez une expression à + C'est-à-dire, lorsque vous assignez une expression à une variable, la valeur de l'expression est recopiée dans la variable. Cela signifie, par exemple, qu'après avoir assigné la valeur d'une variable à une autre, - modifier une variable n'aura pas d'effet sur l'autre. Pour plus - de détails sur ce genre d'assignement, reportez vous à + modifier l'une des variables n'aura pas d'effet sur l'autre. Pour plus + de détails sur ce genre d'assignation, reportez-vous à <link linkend="language.expressions">Expressions</link>. </para> <para> @@ -52,12 +53,12 @@ (en d'autres terme, "devient un alias de", ou encore "pointe sur") la variable originale. Les modifications de la nouvelle variable affecteront l'ancienne, et vice versa. Cela signifie aussi - qu'aucune copie n'est faite : l'assignement est donc beaucoup + qu'aucune copie n'est faite : l'assignation est donc beaucoup plus rapide. Cela se fera notamment sentir dans des boucles, - ou lors d'assignement de grands objets (tableaux). + ou lors d'assignation de grands objets (tableaux). </para> <para> - Pour assigner par référence, ajoute simplement + Pour assigner par référence, ajoutez simplement un & (ET commercial) au début de la variable qui est assignée (la variable source). Dans l'exemple suivant, "<literal>Mon nom est Pierre</literal>" s'affichera deux @@ -75,18 +76,18 @@ </informalexample> </para> <para> - Une chose importante à noter est que seules, les variables + Une chose importante à noter est que seules les variables nommées peuvent être assignées par référence. <informalexample> <programlisting role="php"> <?php $foo = 25; -$bar = &$foo; // Assignement valide . -$bar = &(24 * 7); // Assignement Invalide : référence une expression sans nom +$bar = &$foo; // assignation valide . +$bar = &(24 * 7); // assignation invalide : référence une expression sans nom function test() { return 25; } -$bar = &test(); // Invalide. +$bar = &test(); // assignation invalide. ?> </programlisting> </informalexample> @@ -99,7 +100,7 @@ Cependant, beaucoup de ces variables ne peuvent pas être présentées ici, car elles dépendent du serveur sur lequel elles tournent, de la version du serveur, et de la - configuration du serveur, ou encore d'autres facteurs.. Certaines + configuration du serveur, ou encore d'autres facteurs. Certaines de ces variables ne seront pas accessibles lorsque PHP fonctionne en exécutable. </simpara> @@ -111,7 +112,7 @@ </simpara> <simpara> Pour la liste complète des variables prédéfinies - (et d'autres informations pratiques) reportez vous (et usez) de + (et d'autres informations pratiques) reportez-vous (et usez) de <function>phpinfo</function>. </simpara> <note> @@ -126,20 +127,20 @@ <simpara> Ces variables sont créées par le serveur <ulink url="&url.apache;">Apache</ulink>. Si vous utilisez un autre - serveur web, il n'est pas sur que celui ci vous fournira + serveur web, il n'est pas sur que celui-ci vous fournira les mêmes variables. Il peut ne pas les fournir, en fournir d'autres. Cependant, un bon nombre de ces variables font partie de l'interface <ulink url="&url.cgispec;">CGI 1.1</ulink>, et on peut s'attendre à les retrouver. </simpara> <simpara> - Notez que peu d'entre elles seront accessible lorsque PHP est appelé + Notez que peu d'entre elles seront accessibles lorsque PHP est appelé en ligne de commande, (et elles n'auront alors peut être pas de sens) </simpara> <para> <variablelist> <varlistentry> - <term>GATEWAY_INTERFACE</term> + <term>$GATEWAY_INTERFACE</term> <listitem> <simpara> Numéro de révision de l'interface CGI du serveur : @@ -148,7 +149,7 @@ </listitem> </varlistentry> <varlistentry> - <term>SERVER_NAME</term> + <term>$SERVER_NAME</term> <listitem> <simpara> Le nom du serveur hôte qui éxécute le script suivant. @@ -158,16 +159,16 @@ </listitem> </varlistentry> <varlistentry> - <term>SERVER_SOFTWARE</term> + <term>$SERVER_SOFTWARE</term> <listitem> <simpara> - Chaîne d'identification du serveur, qui est données dans - les entêtes lors de la réponse aux requêtes. + 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>SERVER_PROTOCOL</term> + <term>$SERVER_PROTOCOL</term> <listitem> <simpara> Nom et révision du protocole de communication : i.e. 'HTTP/1.0'; @@ -175,7 +176,7 @@ </listitem> </varlistentry> <varlistentry> - <term>REQUEST_METHOD</term> + <term>$REQUEST_METHOD</term> <listitem> <simpara> Méthode de requête utilisée pour accéder @@ -184,7 +185,7 @@ </listitem> </varlistentry> <varlistentry> - <term>QUERY_STRING</term> + <term>$QUERY_STRING</term> <listitem> <simpara> La chaîne de requête, si elle existe, qui est @@ -193,7 +194,7 @@ </listitem> </varlistentry> <varlistentry> - <term>DOCUMENT_ROOT</term> + <term>$DOCUMENT_ROOT</term> <listitem> <simpara> La racine sous laquelle le script courant est exécuté, @@ -202,62 +203,62 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_ACCEPT</term> + <term>$HTTP_ACCEPT</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept:</literal> de la - requête courant, si il y en a une. + 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>HTTP_ACCEPT_CHARSET</term> + <term>$HTTP_ACCEPT_CHARSET</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept-Charset:</literal> - de la requête courante, si il existe. Par exemple : - 'iso-8859-1,*,utf-8'. + 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>HTTP_ACCEPT_ENCODING</term> + <term>$HTTP_ACCEPT_ENCODING</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept-Encoding:</literal> + Contenu de l'en-tête <literal>Accept-Encoding:</literal> de la requête courante, si elle existe. Par exemple : 'gzip'. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_ACCEPT_LANGUAGE</term> + <term>$HTTP_ACCEPT_LANGUAGE</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept-Language:</literal> de + Contenu de l'en-tête <literal>Accept-Language:</literal> de la requête courante, si elle existe. Par exemple : 'en'. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_CONNECTION</term> + <term>$HTTP_CONNECTION</term> <listitem> <simpara> - Contenu de l'entête <literal>Connection:</literal> de la + Contenu de l'en-tête <literal>Connection:</literal> de la requête courante, si elle existe. Par exemple : 'Keep-Alive'. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_HOST</term> + <term>$HTTP_HOST</term> <listitem> <simpara> - Contenu de l'entête <literal>Host:</literal> de la + Contenu de l'en-tête <literal>Host:</literal> de la requête courante, si elle existe. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_REFERER</term> + <term>$HTTP_REFERER</term> <listitem> <simpara> L'adresse de la page (si elle existe) qui a conduit le @@ -267,22 +268,22 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_USER_AGENT</term> + <term>$HTTP_USER_AGENT</term> <listitem> <simpara> - Contenu de l'entête <literal>User_Agent:</literal> de + 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é du client. + en fonction des capacités du client. </simpara> </listitem> </varlistentry> <varlistentry> - <term>REMOTE_ADDR</term> + <term>$REMOTE_ADDR</term> <listitem> <simpara> L'adresse IP du client qui demande la page courante. @@ -290,7 +291,7 @@ </listitem> </varlistentry> <varlistentry> - <term>REMOTE_PORT</term> + <term>$REMOTE_PORT</term> <listitem> <simpara> Le port utilisé par la machine cliente pour communiquer @@ -299,7 +300,7 @@ </listitem> </varlistentry> <varlistentry> - <term>SCRIPT_FILENAME</term> + <term>$SCRIPT_FILENAME</term> <listitem> <simpara> Le chemin absolu jusqu'au script courant. @@ -307,29 +308,29 @@ </listitem> </varlistentry> <varlistentry> - <term>SERVER_ADMIN</term> + <term>$SERVER_ADMIN</term> <listitem> <simpara> - La valeur donné à la directive SERVER_ADMIN + 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, cela sera la + est exécuté par un hôte virtuel, ce sera la valeur définie par l'hôte virtuel. </simpara> </listitem> </varlistentry> <varlistentry> - <term>SERVER_PORT</term> + <term>$SERVER_PORT</term> <listitem> <simpara> Le port de la machine serveur utilisé pour les - communications. Par défaut, c'est '80'; en utilisant + 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>SERVER_SIGNATURE</term> + <term>$SERVER_SIGNATURE</term> <listitem> <simpara> Chaîne contenant le numéro de version du serveur @@ -340,17 +341,17 @@ </listitem> </varlistentry> <varlistentry> - <term>PATH_TRANSLATED</term> + <term>$PATH_TRANSLATED</term> <listitem> <simpara> Chemin dans le système de fichier (pas le document root-) - jusqu'au script courant, une fois que le serveur à fait + jusqu'au script courant, une fois que le serveur a fait une chemin traduction virtuel->réel. </simpara> </listitem> </varlistentry> <varlistentry> - <term>SCRIPT_NAME</term> + <term>$SCRIPT_NAME</term> <listitem> <simpara> Contient le nom du script courant. Cela sert lorsque @@ -359,7 +360,7 @@ </listitem> </varlistentry> <varlistentry> - <term>REQUEST_URI</term> + <term>$REQUEST_URI</term> <listitem> <simpara> L'URI qui a été fourni pour accéder @@ -376,15 +377,15 @@ Ces variables sont importées dans l'espace de nom global de PHP, depuis l'environnement sous lequel PHP fonctionne. Beaucoup d'entre elles sont fournies par le shell qui exécute PHP et - différents systèmes étant suceptibles + différents systèmes étant susceptibles de disposer de différents shells, une liste définitive - est impossible à établir. Reportez vous à la + est impossible à établir. Reportez-vous à la documentation de votre shell, pour connaître la liste des variables d'environnement prédéfinies. </simpara> <simpara> - Les autres variables d'environments inclues les variables CGI, - placées ici, quelque fois la méthode + Les autres variables d'environment incluent les variables CGI, + placées ici, quelquefois la méthode d'éxécution de PHP (CGI ou module). </simpara> </sect2> @@ -397,25 +398,25 @@ <link linkend="ini.track-vars">track_vars</link> a été activée. Lorsque c'est le cas, ces variables existent toujours, même si ce sont des tableaux vides. Cela évite les - usurpations malintentionnées de ces variables. + usurpations mal intentionnées de ces variables. </simpara> <note> <para> Depuis PHP 4.0.3, <link linkend="ini.track-vars">track_vars</link> est toujours - activé, quelque soit la configuration. + activé, quelle que soit la configuration. </para> </note> <para> Si la directive <link linkend="ini.register-globals">register_globals</link> est activée, - alors ces variables seront aussi disponibles comme variable - global du script : c'est à dire, indépendamment des tableaux + alors ces variables seront aussi disponibles comme variables + globales du script : c'est-à-dire, indépendamment des tableaux <varname>$HTTP_*_VARS</varname>. Cette fonctionnalité doit être utilisée avec précautions, et de préférence, désactivée. Si <varname>$HTTP_*_VARS</varname> est sécurisé, - les équivalents globaux peuvent être écrasé + les équivalents globaux peuvent être écrasés par les données d'entrée de l'utilisateur, avec des intrusions possibles. Si vous ne pouvez pas désactiver <link linkend="ini.register-globals">register_globals</link>, vous @@ -425,11 +426,11 @@ <para> <variablelist> <varlistentry> - <term>argv</term> + <term>$argv</term> <listitem> <simpara> - Tableau des rguments passées au script. Lorsque le script - est appelé en ligne de commande, cela dconne accès + 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. @@ -437,25 +438,26 @@ </listitem> </varlistentry> <varlistentry> - <term>argc</term> + <term>$argc</term> <listitem> <simpara> Contient le nombre de paramètres de la ligne de commande - passés au script (s'il fonctionne en ligne de commande). + passés au script (si le script fonctionne en ligne de commande). </simpara> </listitem> </varlistentry> <varlistentry> - <term>PHP_SELF</term> + <term>$PHP_SELF</term> <listitem> <simpara> - Le nom du fichier du script en cour d'éxécution, par rapport au document root. - Si PHP fonctionne en ligne de commande, cette variable n'est pas disponible. + Le nom du fichier du script en cour d'éxécution, par + rapport au document root. Si PHP fonctionne en ligne de commande, + cette variable n'est pas disponible. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_COOKIE_VARS</term> + <term>$HTTP_COOKIE_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -469,7 +471,7 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_GET_VARS</term> + <term>$HTTP_GET_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -483,7 +485,7 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_POST_VARS</term> + <term>$HTTP_POST_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -497,12 +499,12 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_POST_FILES</term> + <term>$HTTP_POST_FILES</term> <listitem> <simpara> Un tableau associatif contenant les informations sur les fichiers téléchargés avec la méthode - HTTP POST. Reportez vous au chapitre + HTTP POST. Reportez-vous au chapitre <link linkend="features.file-upload.post-method"> Téléchargement par méthode POST</link> pour plus de détails sur le contenu de @@ -510,12 +512,12 @@ </simpara> <para> <varname>$HTTP_POST_FILES</varname> n'est disponible que dans - PHP 4.0.0 et plus récent. + les versions 4.0.0 et plus récentes de PHP. </para> </listitem> </varlistentry> <varlistentry> - <term>HTTP_ENV_VARS</term> + <term>$HTTP_ENV_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -524,7 +526,7 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_SERVER_VARS</term> + <term>$HTTP_SERVER_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -540,8 +542,8 @@ <sect1 id="language.variables.scope"> <title>Portée des variables</title> <simpara> - La portée d'une variable dépends du contexte - dans lequel la variable est définie. Pour la plupart des + La portée d'une variable dépend du contexte + dans lequel la variable est définie. Pour la majorité des variables, la portée concerne la totalité d'un script PHP. Mais, lorsque vous définissez une fonction, la portée d'une variable définie dans cette fonction @@ -585,7 +587,7 @@ localement dans la fonction. Cela peut poser des problèmes si vous redéfinissez des variables globales localement. En PHP, une variable globale doit être - déclarée à l'intérieure de chaque + déclarée à l'intérieur de chaque fonction afin de pouvoir être utilisée dans cette fonction. Par exemple: </simpara> @@ -604,8 +606,8 @@ </informalexample> <simpara> Le script ci-dessus va afficher la valeur "3". - En déclarant global les variables $a et $b localement - dans la fonction, toutes les références à + En déclarant globales les variables $a et $b locales + de la fonction somme(), toutes les références à ces variables concerneront les variables globales. Il n'y a aucune limite au nombre de variables globales qui peuvent être manipulées par une fonction. @@ -613,7 +615,7 @@ <simpara> Une deuxième méthode pour accéder aux variables globales est d'utiliser le tableau associatif - prédéfini $GLOBALS. Le pécédent + prédéfini $GLOBALS. Le précédent exemple peut être réécrit de la manière suivante: </simpara> @@ -638,7 +640,7 @@ <simpara> Une autre caractéristique importante de la portée des variables est la notion de variable <emphasis>static</emphasis>. Une variable statique a - une portée locale uniquement mais elle ne perd pas sa valeur lorsque le + une portée locale uniquement, mais elle ne perd pas sa valeur lorsque le script appelle la fonction. Prenons l'exemple suivant: </simpara> <informalexample> @@ -656,7 +658,7 @@ Cette fonction est un peu inutile car à chaque fois qu'elle est appelée, elle initialise $a à 0 et affiche "0". L'incrémentation de la variable ($a++) - ne sert pas à grand chose car dès que la + ne sert pas à grand chose, car dès que la fonction est terminée la variable disparaît. Pour faire une fonction de comptage utile, c'est-à-dire qui ne perdra pas la trace du compteur, la variable $a est @@ -679,7 +681,7 @@ de 1. </simpara> <simpara> - Les variables statiques sont essentielles lorsque vous faîtes des + Les variables statiques sont essentielles lorsque vous faites des appels récursifs à une fonction. Une fonction récursive est une fonction qui s'appelle elle-même. Il faut faire attention lorsque vous écrivez une fonction @@ -708,7 +710,7 @@ <title>Les variables dynamiques</title> <simpara> Il est pratique d'avoir parfois des noms de variables qui sont variables. - C'est-à-dire un nom de variable qui affecté et utilisé + C'est-à-dire un nom de variable qui est affectée et utilisée dynamiquement. Une variable classique est affecté avec l'instruction suivante: </simpara> @@ -722,7 +724,7 @@ <simpara> Une variable dynamique prend la valeur d'une variable et l'utilise comme nom d'une autre variable. Dans l'exemple ci-dessous, - <emphasis>hello</emphasis>, peut être utilisé comme le nom d'une + <emphasis>bonjour</emphasis> peut être utilisé comme le nom d'une variable en utilisant le "$$" précédent la variable. C'est-à-dire </simpara> @@ -760,11 +762,11 @@ </simpara> <simpara> Afin de pouvoir utiliser les variables dynamiques avec les tableaux, - vous avez a résoudre un problème ambigu. Si vous + vous avez à résoudre un problème ambigu. Si vous écrivez $$a[1], le parseur a besoin de savoir si vous parler de la variable qui a pour nom $a[1] ou bien si vous voulez l'index [1] de la variable $$a. La syntaxe pour résoudre - cette ambiguité est la suivante: ${$a[1]} pour le premier + cette ambiguïté est la suivante: ${$a[1]} pour le premier cas, et ${$a}[1] pour le deuxième. </simpara> </sect1> @@ -782,7 +784,7 @@ <title>Exemple avec un formulaire simple</title> <programlisting role="html"> <form action="foo.php3" method="post"> - Name: <input type="text" name="name"><br> + Name: <input type="text" name="name"><br> <input type="submit"> </form> </programlisting> @@ -791,7 +793,7 @@ <simpara> Lorsque ce formulaire est envoyé, le PHP va créer la variable <computeroutput>$name</computeroutput>, qui contiendra la valeur - que vous avez entré dans le champs <emphasis>Name:</emphasis> + que vous avez entrée dans le champs <emphasis>Name:</emphasis> du formulaire. </simpara> <simpara> @@ -843,8 +845,8 @@ Lorsqu'un utilisateur clique sur l'image, le formulaire sera transmis au serveur avec deux variables de plus, sub_x et sub_y. Ces deux variables contiennent les coordonnées - de l'endroit oú l'utilisateur à cliqué. Les - utilisateurs expérimentés remarquerons que les noms + de l'endroit où l'utilisateur à cliqué. Les + utilisateurs expérimentés remarqueront que les noms de variables sont transmis avec une virgule à la place du caractère "_", mais le PHP fait la conversion automatiquement. @@ -863,7 +865,7 @@ la fonction <function>setcookie</function>. Les cookies font partie intégrante du "header" HTTP, et donc la fonction <function>setcookie</function> doit être - appelé avant que le moindre affichage ne soit envoyé + appelée avant que le moindre affichage ne soit envoyé au navigateur. C'est la même restriction que pour la fonction <function>header</function>. Tout cookie envoyé depuis le client sur le serveur sera automatiquement stocké sous @@ -918,9 +920,9 @@ Même si le PHP crée les variables lors de l'utilisation des méthodes GET, POST et cookie, il est de temps en temps préférable de transmettre explicitement la valeur de - la variable afin d'être sûre de la valeur. + la variable afin d'être sûr de la valeur. La fonction <function>getenv</function> peut être - utilisé pour récupéré la valeur + utilisée pour récupérer la valeur des variables d'environnement. Vous pouvez aussi affecter une variable d'environnement grâce à la fonction <function>putenv</function>. @@ -953,14 +955,17 @@ <sect2 id="language.variables.determining-type-of"> <title>Détermination du type des variables</title> <para> - Parce que le PHP détermine le type des variables et + Parceque le PHP détermine le type des variables et les convertit (généralement) comme il faut, ce n'est pas toujours le type de variable que vous souhaitez. - PHP inclus des fonctions permettant de déterminer le - type d'une variable. Les fonctions - <function>gettype</function>, <function>is_long</function>, - <function>is_double</function>, <function>is_string</function>, - <function>is_array</function>, et <function>is_object</function>. + PHP inclut des fonctions permettant de déterminer le + type d'une variable : + <function>gettype</function>, + <function>is_long</function>, + <function>is_double</function>, + <function>is_string</function>, + <function>is_array</function> et + <function>is_object</function>. </para> </sect2> </sect1>
Index: phpdoc/fr/language/variables.xml diff -u phpdoc/fr/language/variables.xml:1.24 phpdoc/fr/language/variables.xml:1.25 --- phpdoc/fr/language/variables.xml:1.24 Mon Mar 19 12:06:31 2001 +++ phpdoc/fr/language/variables.xml Tue Aug 14 14:18:44 2001 @@ -1,3 +1,4 @@ +<!-- $Revision: 1.25 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> @@ -9,9 +10,9 @@ </simpara> <para> Les noms de variables suivent les mêmes règles de nommage que - les autres entitées PHP. Un nom de variable valide doit commencer par + les autres entités PHP. Un nom de variable valide doit commencer par une lettre ou un souligné (_), suivi de lettres, chiffres ou soulignés. - Exprimé sous forme d'une expression régulière, cela donne : + Exprimé sous la forme d'une expression régulière, cela donne : '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*' </para> <note> @@ -37,12 +38,12 @@ </para> <para> En PHP 3, les variables sont toujours assignées par valeur. - C'est à dire, lorsque vous assignez une expression à + C'est-à-dire, lorsque vous assignez une expression à une variable, la valeur de l'expression est recopiée dans la variable. Cela signifie, par exemple, qu'après avoir assigné la valeur d'une variable à une autre, - modifier une variable n'aura pas d'effet sur l'autre. Pour plus - de détails sur ce genre d'assignement, reportez vous à + modifier l'une des variables n'aura pas d'effet sur l'autre. Pour plus + de détails sur ce genre d'assignation, reportez-vous à <link linkend="language.expressions">Expressions</link>. </para> <para> @@ -52,12 +53,12 @@ (en d'autres terme, "devient un alias de", ou encore "pointe sur") la variable originale. Les modifications de la nouvelle variable affecteront l'ancienne, et vice versa. Cela signifie aussi - qu'aucune copie n'est faite : l'assignement est donc beaucoup + qu'aucune copie n'est faite : l'assignation est donc beaucoup plus rapide. Cela se fera notamment sentir dans des boucles, - ou lors d'assignement de grands objets (tableaux). + ou lors d'assignation de grands objets (tableaux). </para> <para> - Pour assigner par référence, ajoute simplement + Pour assigner par référence, ajoutez simplement un & (ET commercial) au début de la variable qui est assignée (la variable source). Dans l'exemple suivant, "<literal>Mon nom est Pierre</literal>" s'affichera deux @@ -75,18 +76,18 @@ </informalexample> </para> <para> - Une chose importante à noter est que seules, les variables + Une chose importante à noter est que seules les variables nommées peuvent être assignées par référence. <informalexample> <programlisting role="php"> <?php $foo = 25; -$bar = &$foo; // Assignement valide . -$bar = &(24 * 7); // Assignement Invalide : référence une expression sans nom +$bar = &$foo; // assignation valide . +$bar = &(24 * 7); // assignation invalide : référence une expression sans nom function test() { return 25; } -$bar = &test(); // Invalide. +$bar = &test(); // assignation invalide. ?> </programlisting> </informalexample> @@ -99,7 +100,7 @@ Cependant, beaucoup de ces variables ne peuvent pas être présentées ici, car elles dépendent du serveur sur lequel elles tournent, de la version du serveur, et de la - configuration du serveur, ou encore d'autres facteurs.. Certaines + configuration du serveur, ou encore d'autres facteurs. Certaines de ces variables ne seront pas accessibles lorsque PHP fonctionne en exécutable. </simpara> @@ -111,7 +112,7 @@ </simpara> <simpara> Pour la liste complète des variables prédéfinies - (et d'autres informations pratiques) reportez vous (et usez) de + (et d'autres informations pratiques) reportez-vous (et usez) de <function>phpinfo</function>. </simpara> <note> @@ -126,20 +127,20 @@ <simpara> Ces variables sont créées par le serveur <ulink url="&url.apache;">Apache</ulink>. Si vous utilisez un autre - serveur web, il n'est pas sur que celui ci vous fournira + serveur web, il n'est pas sur que celui-ci vous fournira les mêmes variables. Il peut ne pas les fournir, en fournir d'autres. Cependant, un bon nombre de ces variables font partie de l'interface <ulink url="&url.cgispec;">CGI 1.1</ulink>, et on peut s'attendre à les retrouver. </simpara> <simpara> - Notez que peu d'entre elles seront accessible lorsque PHP est appelé + Notez que peu d'entre elles seront accessibles lorsque PHP est appelé en ligne de commande, (et elles n'auront alors peut être pas de sens) </simpara> <para> <variablelist> <varlistentry> - <term>GATEWAY_INTERFACE</term> + <term>$GATEWAY_INTERFACE</term> <listitem> <simpara> Numéro de révision de l'interface CGI du serveur : @@ -148,7 +149,7 @@ </listitem> </varlistentry> <varlistentry> - <term>SERVER_NAME</term> + <term>$SERVER_NAME</term> <listitem> <simpara> Le nom du serveur hôte qui éxécute le script suivant. @@ -158,16 +159,16 @@ </listitem> </varlistentry> <varlistentry> - <term>SERVER_SOFTWARE</term> + <term>$SERVER_SOFTWARE</term> <listitem> <simpara> - Chaîne d'identification du serveur, qui est données dans - les entêtes lors de la réponse aux requêtes. + 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>SERVER_PROTOCOL</term> + <term>$SERVER_PROTOCOL</term> <listitem> <simpara> Nom et révision du protocole de communication : i.e. 'HTTP/1.0'; @@ -175,7 +176,7 @@ </listitem> </varlistentry> <varlistentry> - <term>REQUEST_METHOD</term> + <term>$REQUEST_METHOD</term> <listitem> <simpara> Méthode de requête utilisée pour accéder @@ -184,7 +185,7 @@ </listitem> </varlistentry> <varlistentry> - <term>QUERY_STRING</term> + <term>$QUERY_STRING</term> <listitem> <simpara> La chaîne de requête, si elle existe, qui est @@ -193,7 +194,7 @@ </listitem> </varlistentry> <varlistentry> - <term>DOCUMENT_ROOT</term> + <term>$DOCUMENT_ROOT</term> <listitem> <simpara> La racine sous laquelle le script courant est exécuté, @@ -202,62 +203,62 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_ACCEPT</term> + <term>$HTTP_ACCEPT</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept:</literal> de la - requête courant, si il y en a une. + 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>HTTP_ACCEPT_CHARSET</term> + <term>$HTTP_ACCEPT_CHARSET</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept-Charset:</literal> - de la requête courante, si il existe. Par exemple : - 'iso-8859-1,*,utf-8'. + 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>HTTP_ACCEPT_ENCODING</term> + <term>$HTTP_ACCEPT_ENCODING</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept-Encoding:</literal> + Contenu de l'en-tête <literal>Accept-Encoding:</literal> de la requête courante, si elle existe. Par exemple : 'gzip'. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_ACCEPT_LANGUAGE</term> + <term>$HTTP_ACCEPT_LANGUAGE</term> <listitem> <simpara> - Contenu de l'entête <literal>Accept-Language:</literal> de + Contenu de l'en-tête <literal>Accept-Language:</literal> de la requête courante, si elle existe. Par exemple : 'en'. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_CONNECTION</term> + <term>$HTTP_CONNECTION</term> <listitem> <simpara> - Contenu de l'entête <literal>Connection:</literal> de la + Contenu de l'en-tête <literal>Connection:</literal> de la requête courante, si elle existe. Par exemple : 'Keep-Alive'. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_HOST</term> + <term>$HTTP_HOST</term> <listitem> <simpara> - Contenu de l'entête <literal>Host:</literal> de la + Contenu de l'en-tête <literal>Host:</literal> de la requête courante, si elle existe. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_REFERER</term> + <term>$HTTP_REFERER</term> <listitem> <simpara> L'adresse de la page (si elle existe) qui a conduit le @@ -267,22 +268,22 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_USER_AGENT</term> + <term>$HTTP_USER_AGENT</term> <listitem> <simpara> - Contenu de l'entête <literal>User_Agent:</literal> de + 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é du client. + en fonction des capacités du client. </simpara> </listitem> </varlistentry> <varlistentry> - <term>REMOTE_ADDR</term> + <term>$REMOTE_ADDR</term> <listitem> <simpara> L'adresse IP du client qui demande la page courante. @@ -290,7 +291,7 @@ </listitem> </varlistentry> <varlistentry> - <term>REMOTE_PORT</term> + <term>$REMOTE_PORT</term> <listitem> <simpara> Le port utilisé par la machine cliente pour communiquer @@ -299,7 +300,7 @@ </listitem> </varlistentry> <varlistentry> - <term>SCRIPT_FILENAME</term> + <term>$SCRIPT_FILENAME</term> <listitem> <simpara> Le chemin absolu jusqu'au script courant. @@ -307,29 +308,29 @@ </listitem> </varlistentry> <varlistentry> - <term>SERVER_ADMIN</term> + <term>$SERVER_ADMIN</term> <listitem> <simpara> - La valeur donné à la directive SERVER_ADMIN + 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, cela sera la + est exécuté par un hôte virtuel, ce sera la valeur définie par l'hôte virtuel. </simpara> </listitem> </varlistentry> <varlistentry> - <term>SERVER_PORT</term> + <term>$SERVER_PORT</term> <listitem> <simpara> Le port de la machine serveur utilisé pour les - communications. Par défaut, c'est '80'; en utilisant + 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>SERVER_SIGNATURE</term> + <term>$SERVER_SIGNATURE</term> <listitem> <simpara> Chaîne contenant le numéro de version du serveur @@ -340,17 +341,17 @@ </listitem> </varlistentry> <varlistentry> - <term>PATH_TRANSLATED</term> + <term>$PATH_TRANSLATED</term> <listitem> <simpara> Chemin dans le système de fichier (pas le document root-) - jusqu'au script courant, une fois que le serveur à fait + jusqu'au script courant, une fois que le serveur a fait une chemin traduction virtuel->réel. </simpara> </listitem> </varlistentry> <varlistentry> - <term>SCRIPT_NAME</term> + <term>$SCRIPT_NAME</term> <listitem> <simpara> Contient le nom du script courant. Cela sert lorsque @@ -359,7 +360,7 @@ </listitem> </varlistentry> <varlistentry> - <term>REQUEST_URI</term> + <term>$REQUEST_URI</term> <listitem> <simpara> L'URI qui a été fourni pour accéder @@ -376,15 +377,15 @@ Ces variables sont importées dans l'espace de nom global de PHP, depuis l'environnement sous lequel PHP fonctionne. Beaucoup d'entre elles sont fournies par le shell qui exécute PHP et - différents systèmes étant suceptibles + différents systèmes étant susceptibles de disposer de différents shells, une liste définitive - est impossible à établir. Reportez vous à la + est impossible à établir. Reportez-vous à la documentation de votre shell, pour connaître la liste des variables d'environnement prédéfinies. </simpara> <simpara> - Les autres variables d'environments inclues les variables CGI, - placées ici, quelque fois la méthode + Les autres variables d'environment incluent les variables CGI, + placées ici, quelquefois la méthode d'éxécution de PHP (CGI ou module). </simpara> </sect2> @@ -397,25 +398,25 @@ <link linkend="ini.track-vars">track_vars</link> a été activée. Lorsque c'est le cas, ces variables existent toujours, même si ce sont des tableaux vides. Cela évite les - usurpations malintentionnées de ces variables. + usurpations mal intentionnées de ces variables. </simpara> <note> <para> Depuis PHP 4.0.3, <link linkend="ini.track-vars">track_vars</link> est toujours - activé, quelque soit la configuration. + activé, quelle que soit la configuration. </para> </note> <para> Si la directive <link linkend="ini.register-globals">register_globals</link> est activée, - alors ces variables seront aussi disponibles comme variable - global du script : c'est à dire, indépendamment des tableaux + alors ces variables seront aussi disponibles comme variables + globales du script : c'est-à-dire, indépendamment des tableaux <varname>$HTTP_*_VARS</varname>. Cette fonctionnalité doit être utilisée avec précautions, et de préférence, désactivée. Si <varname>$HTTP_*_VARS</varname> est sécurisé, - les équivalents globaux peuvent être écrasé + les équivalents globaux peuvent être écrasés par les données d'entrée de l'utilisateur, avec des intrusions possibles. Si vous ne pouvez pas désactiver <link linkend="ini.register-globals">register_globals</link>, vous @@ -425,11 +426,11 @@ <para> <variablelist> <varlistentry> - <term>argv</term> + <term>$argv</term> <listitem> <simpara> - Tableau des rguments passées au script. Lorsque le script - est appelé en ligne de commande, cela dconne accès + 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. @@ -437,25 +438,26 @@ </listitem> </varlistentry> <varlistentry> - <term>argc</term> + <term>$argc</term> <listitem> <simpara> Contient le nombre de paramètres de la ligne de commande - passés au script (s'il fonctionne en ligne de commande). + passés au script (si le script fonctionne en ligne de commande). </simpara> </listitem> </varlistentry> <varlistentry> - <term>PHP_SELF</term> + <term>$PHP_SELF</term> <listitem> <simpara> - Le nom du fichier du script en cour d'éxécution, par rapport au document root. - Si PHP fonctionne en ligne de commande, cette variable n'est pas disponible. + Le nom du fichier du script en cour d'éxécution, par + rapport au document root. Si PHP fonctionne en ligne de commande, + cette variable n'est pas disponible. </simpara> </listitem> </varlistentry> <varlistentry> - <term>HTTP_COOKIE_VARS</term> + <term>$HTTP_COOKIE_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -469,7 +471,7 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_GET_VARS</term> + <term>$HTTP_GET_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -483,7 +485,7 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_POST_VARS</term> + <term>$HTTP_POST_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -497,12 +499,12 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_POST_FILES</term> + <term>$HTTP_POST_FILES</term> <listitem> <simpara> Un tableau associatif contenant les informations sur les fichiers téléchargés avec la méthode - HTTP POST. Reportez vous au chapitre + HTTP POST. Reportez-vous au chapitre <link linkend="features.file-upload.post-method"> Téléchargement par méthode POST</link> pour plus de détails sur le contenu de @@ -510,12 +512,12 @@ </simpara> <para> <varname>$HTTP_POST_FILES</varname> n'est disponible que dans - PHP 4.0.0 et plus récent. + les versions 4.0.0 et plus récentes de PHP. </para> </listitem> </varlistentry> <varlistentry> - <term>HTTP_ENV_VARS</term> + <term>$HTTP_ENV_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -524,7 +526,7 @@ </listitem> </varlistentry> <varlistentry> - <term>HTTP_SERVER_VARS</term> + <term>$HTTP_SERVER_VARS</term> <listitem> <simpara> Un tableau associatif des variables passées au script @@ -540,8 +542,8 @@ <sect1 id="language.variables.scope"> <title>Portée des variables</title> <simpara> - La portée d'une variable dépends du contexte - dans lequel la variable est définie. Pour la plupart des + La portée d'une variable dépend du contexte + dans lequel la variable est définie. Pour la majorité des variables, la portée concerne la totalité d'un script PHP. Mais, lorsque vous définissez une fonction, la portée d'une variable définie dans cette fonction @@ -585,7 +587,7 @@ localement dans la fonction. Cela peut poser des problèmes si vous redéfinissez des variables globales localement. En PHP, une variable globale doit être - déclarée à l'intérieure de chaque + déclarée à l'intérieur de chaque fonction afin de pouvoir être utilisée dans cette fonction. Par exemple: </simpara> @@ -604,8 +606,8 @@ </informalexample> <simpara> Le script ci-dessus va afficher la valeur "3". - En déclarant global les variables $a et $b localement - dans la fonction, toutes les références à + En déclarant globales les variables $a et $b locales + de la fonction somme(), toutes les références à ces variables concerneront les variables globales. Il n'y a aucune limite au nombre de variables globales qui peuvent être manipulées par une fonction. @@ -613,7 +615,7 @@ <simpara> Une deuxième méthode pour accéder aux variables globales est d'utiliser le tableau associatif - prédéfini $GLOBALS. Le pécédent + prédéfini $GLOBALS. Le précédent exemple peut être réécrit de la manière suivante: </simpara> @@ -638,7 +640,7 @@ <simpara> Une autre caractéristique importante de la portée des variables est la notion de variable <emphasis>static</emphasis>. Une variable statique a - une portée locale uniquement mais elle ne perd pas sa valeur lorsque le + une portée locale uniquement, mais elle ne perd pas sa valeur lorsque le script appelle la fonction. Prenons l'exemple suivant: </simpara> <informalexample> @@ -656,7 +658,7 @@ Cette fonction est un peu inutile car à chaque fois qu'elle est appelée, elle initialise $a à 0 et affiche "0". L'incrémentation de la variable ($a++) - ne sert pas à grand chose car dès que la + ne sert pas à grand chose, car dès que la fonction est terminée la variable disparaît. Pour faire une fonction de comptage utile, c'est-à-dire qui ne perdra pas la trace du compteur, la variable $a est @@ -679,7 +681,7 @@ de 1. </simpara> <simpara> - Les variables statiques sont essentielles lorsque vous faîtes des + Les variables statiques sont essentielles lorsque vous faites des appels récursifs à une fonction. Une fonction récursive est une fonction qui s'appelle elle-même. Il faut faire attention lorsque vous écrivez une fonction @@ -708,7 +710,7 @@ <title>Les variables dynamiques</title> <simpara> Il est pratique d'avoir parfois des noms de variables qui sont variables. - C'est-à-dire un nom de variable qui affecté et utilisé + C'est-à-dire un nom de variable qui est affectée et utilisée dynamiquement. Une variable classique est affecté avec l'instruction suivante: </simpara> @@ -722,7 +724,7 @@ <simpara> Une variable dynamique prend la valeur d'une variable et l'utilise comme nom d'une autre variable. Dans l'exemple ci-dessous, - <emphasis>hello</emphasis>, peut être utilisé comme le nom d'une + <emphasis>bonjour</emphasis> peut être utilisé comme le nom d'une variable en utilisant le "$$" précédent la variable. C'est-à-dire </simpara> @@ -760,11 +762,11 @@ </simpara> <simpara> Afin de pouvoir utiliser les variables dynamiques avec les tableaux, - vous avez a résoudre un problème ambigu. Si vous + vous avez à résoudre un problème ambigu. Si vous écrivez $$a[1], le parseur a besoin de savoir si vous parler de la variable qui a pour nom $a[1] ou bien si vous voulez l'index [1] de la variable $$a. La syntaxe pour résoudre - cette ambiguité est la suivante: ${$a[1]} pour le premier + cette ambiguïté est la suivante: ${$a[1]} pour le premier cas, et ${$a}[1] pour le deuxième. </simpara> </sect1> @@ -782,7 +784,7 @@ <title>Exemple avec un formulaire simple</title> <programlisting role="html"> <form action="foo.php3" method="post"> - Name: <input type="text" name="name"><br> + Name: <input type="text" name="name"><br> <input type="submit"> </form> </programlisting> @@ -791,7 +793,7 @@ <simpara> Lorsque ce formulaire est envoyé, le PHP va créer la variable <computeroutput>$name</computeroutput>, qui contiendra la valeur - que vous avez entré dans le champs <emphasis>Name:</emphasis> + que vous avez entrée dans le champs <emphasis>Name:</emphasis> du formulaire. </simpara> <simpara> @@ -843,8 +845,8 @@ Lorsqu'un utilisateur clique sur l'image, le formulaire sera transmis au serveur avec deux variables de plus, sub_x et sub_y. Ces deux variables contiennent les coordonnées - de l'endroit oú l'utilisateur à cliqué. Les - utilisateurs expérimentés remarquerons que les noms + de l'endroit où l'utilisateur à cliqué. Les + utilisateurs expérimentés remarqueront que les noms de variables sont transmis avec une virgule à la place du caractère "_", mais le PHP fait la conversion automatiquement. @@ -863,7 +865,7 @@ la fonction <function>setcookie</function>. Les cookies font partie intégrante du "header" HTTP, et donc la fonction <function>setcookie</function> doit être - appelé avant que le moindre affichage ne soit envoyé + appelée avant que le moindre affichage ne soit envoyé au navigateur. C'est la même restriction que pour la fonction <function>header</function>. Tout cookie envoyé depuis le client sur le serveur sera automatiquement stocké sous @@ -918,9 +920,9 @@ Même si le PHP crée les variables lors de l'utilisation des méthodes GET, POST et cookie, il est de temps en temps préférable de transmettre explicitement la valeur de - la variable afin d'être sûre de la valeur. + la variable afin d'être sûr de la valeur. La fonction <function>getenv</function> peut être - utilisé pour récupéré la valeur + utilisée pour récupérer la valeur des variables d'environnement. Vous pouvez aussi affecter une variable d'environnement grâce à la fonction <function>putenv</function>. @@ -953,14 +955,17 @@ <sect2 id="language.variables.determining-type-of"> <title>Détermination du type des variables</title> <para> - Parce que le PHP détermine le type des variables et + Parceque le PHP détermine le type des variables et les convertit (généralement) comme il faut, ce n'est pas toujours le type de variable que vous souhaitez. - PHP inclus des fonctions permettant de déterminer le - type d'une variable. Les fonctions - <function>gettype</function>, <function>is_long</function>, - <function>is_double</function>, <function>is_string</function>, - <function>is_array</function>, et <function>is_object</function>. + PHP inclut des fonctions permettant de déterminer le + type d'une variable : + <function>gettype</function>, + <function>is_long</function>, + <function>is_double</function>, + <function>is_string</function>, + <function>is_array</function> et + <function>is_object</function>. </para> </sect2> </sect1>