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 @@ + Les variables @@ -9,9 +10,9 @@ 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]*' @@ -37,12 +38,12 @@ 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 à Expressions. @@ -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). - 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, "Mon nom est Pierre" s'affichera deux @@ -75,18 +76,18 @@ - 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. <?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. ?> @@ -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. @@ -111,7 +112,7 @@ 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 phpinfo. @@ -126,20 +127,20 @@ Ces variables sont créées par le serveur Apache. 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 CGI 1.1, et on peut s'attendre à les retrouver. - 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) - GATEWAY_INTERFACE + $GATEWAY_INTERFACE Numéro de révision de l'interface CGI du serveur : @@ -148,7 +149,7 @@ - SERVER_NAME + $SERVER_NAME Le nom du serveur hôte qui éxécute le script suivant. @@ -158,16 +159,16 @@ - SERVER_SOFTWARE + $SERVER_SOFTWARE - 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. - SERVER_PROTOCOL + $SERVER_PROTOCOL Nom et révision du protocole de communication : i.e. 'HTTP/1.0'; @@ -175,7 +176,7 @@ - REQUEST_METHOD + $REQUEST_METHOD Méthode de requête utilisée pour accéder @@ -184,7 +185,7 @@ - QUERY_STRING + $QUERY_STRING La chaîne de requête, si elle existe, qui est @@ -193,7 +194,7 @@ - DOCUMENT_ROOT + $DOCUMENT_ROOT La racine sous laquelle le script courant est exécuté, @@ -202,62 +203,62 @@ - HTTP_ACCEPT + $HTTP_ACCEPT - Contenu de l'entête Accept: de la - requête courant, si il y en a une. + Contenu de l'en-tête Accept: de la + requête courante, s'il y en a une. - HTTP_ACCEPT_CHARSET + $HTTP_ACCEPT_CHARSET - Contenu de l'entête Accept-Charset: - de la requête courante, si il existe. Par exemple : - 'iso-8859-1,*,utf-8'. + Contenu de l'en-tête Accept-Charset: + de la requête courante, s'elle existe. Par exemple : + 'iso-8859-1,*,utf-8'. - HTTP_ACCEPT_ENCODING + $HTTP_ACCEPT_ENCODING - Contenu de l'entête Accept-Encoding: + Contenu de l'en-tête Accept-Encoding: de la requête courante, si elle existe. Par exemple : 'gzip'. - HTTP_ACCEPT_LANGUAGE + $HTTP_ACCEPT_LANGUAGE - Contenu de l'entête Accept-Language: de + Contenu de l'en-tête Accept-Language: de la requête courante, si elle existe. Par exemple : 'en'. - HTTP_CONNECTION + $HTTP_CONNECTION - Contenu de l'entête Connection: de la + Contenu de l'en-tête Connection: de la requête courante, si elle existe. Par exemple : 'Keep-Alive'. - HTTP_HOST + $HTTP_HOST - Contenu de l'entête Host: de la + Contenu de l'en-tête Host: de la requête courante, si elle existe. - HTTP_REFERER + $HTTP_REFERER L'adresse de la page (si elle existe) qui a conduit le @@ -267,22 +268,22 @@ - HTTP_USER_AGENT + $HTTP_USER_AGENT - Contenu de l'entête User_Agent: de + Contenu de l'en-tête User_Agent: 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 : Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586). Entre autres choses, vous pouvez utiliser cette valeur avec get_browser pour optimiser votre page - en fonction des capacité du client. + en fonction des capacités du client. - REMOTE_ADDR + $REMOTE_ADDR L'adresse IP du client qui demande la page courante. @@ -290,7 +291,7 @@ - REMOTE_PORT + $REMOTE_PORT Le port utilisé par la machine cliente pour communiquer @@ -299,7 +300,7 @@ - SCRIPT_FILENAME + $SCRIPT_FILENAME Le chemin absolu jusqu'au script courant. @@ -307,29 +308,29 @@ - SERVER_ADMIN + $SERVER_ADMIN - 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. - SERVER_PORT + $SERVER_PORT 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é. - SERVER_SIGNATURE + $SERVER_SIGNATURE Chaîne contenant le numéro de version du serveur @@ -340,17 +341,17 @@ - PATH_TRANSLATED + $PATH_TRANSLATED 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. - SCRIPT_NAME + $SCRIPT_NAME Contient le nom du script courant. Cela sert lorsque @@ -359,7 +360,7 @@ - REQUEST_URI + $REQUEST_URI 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. - 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). @@ -397,25 +398,25 @@ track_vars 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. Depuis PHP 4.0.3, track_vars est toujours - activé, quelque soit la configuration. + activé, quelle que soit la configuration. Si la directive register_globals 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 $HTTP_*_VARS. Cette fonctionnalité doit être utilisée avec précautions, et de préférence, désactivée. Si $HTTP_*_VARS 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 register_globals, vous @@ -425,11 +426,11 @@ - argv + $argv - 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 @@ - argc + $argc 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). - PHP_SELF + $PHP_SELF - 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. - HTTP_COOKIE_VARS + $HTTP_COOKIE_VARS Un tableau associatif des variables passées au script @@ -469,7 +471,7 @@ - HTTP_GET_VARS + $HTTP_GET_VARS Un tableau associatif des variables passées au script @@ -483,7 +485,7 @@ - HTTP_POST_VARS + $HTTP_POST_VARS Un tableau associatif des variables passées au script @@ -497,12 +499,12 @@ - HTTP_POST_FILES + $HTTP_POST_FILES 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 Téléchargement par méthode POST pour plus de détails sur le contenu de @@ -510,12 +512,12 @@ $HTTP_POST_FILES n'est disponible que dans - PHP 4.0.0 et plus récent. + les versions 4.0.0 et plus récentes de PHP. - HTTP_ENV_VARS + $HTTP_ENV_VARS Un tableau associatif des variables passées au script @@ -524,7 +526,7 @@ - HTTP_SERVER_VARS + $HTTP_SERVER_VARS Un tableau associatif des variables passées au script @@ -540,8 +542,8 @@ Portée des variables - 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: @@ -604,8 +606,8 @@ 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 @@ 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: @@ -638,7 +640,7 @@ Une autre caractéristique importante de la portée des variables est la notion de variable static. 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: @@ -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. - 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 @@ Les variables dynamiques 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: @@ -722,7 +724,7 @@ Une variable dynamique prend la valeur d'une variable et l'utilise comme nom d'une autre variable. Dans l'exemple ci-dessous, - hello, peut être utilisé comme le nom d'une + bonjour peut être utilisé comme le nom d'une variable en utilisant le "$$" précédent la variable. C'est-à-dire @@ -760,11 +762,11 @@ 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. @@ -782,7 +784,7 @@ Exemple avec un formulaire simple <form action="foo.php3" method="post"> - Name: <input type="text" name="name"><br> + Name: <input type="text" name="name"><br> <input type="submit"> </form> @@ -791,7 +793,7 @@ Lorsque ce formulaire est envoyé, le PHP va créer la variable $name, qui contiendra la valeur - que vous avez entré dans le champs Name: + que vous avez entrée dans le champs Name: du formulaire. @@ -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 setcookie. Les cookies font partie intégrante du "header" HTTP, et donc la fonction setcookie 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 header. 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 getenv 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 putenv. @@ -953,14 +955,17 @@ Détermination du type des variables - 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 - gettype, is_long, - is_double, is_string, - is_array, et is_object. + PHP inclut des fonctions permettant de déterminer le + type d'une variable : + gettype, + is_long, + is_double, + is_string, + is_array et + is_object.