<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="language.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>Les variables</title>

<sect1 xml:id="language.variables.basics">

<title>Essentiel</title>

<simpara>

En PHP, les variables sont représentées par un signe

dollar "$" suivi du nom de la variable. Le nom est sensible à

la casse.

</simpara>

<para>

Un nom de variable valide commence par une lettre

(<literal>A-Z</literal>, <literal>a-z</literal>, ou les octets de 128 à 255)

ou par un souligné (_), suivi de lettres, chiffres ou

soulignés. Exprimé sous la forme d'une expression

régulière, cela donne :

<code>^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$</code>

</para>

<note>

<simpara>

PHP ne prend pas en charge les noms de variables Unicode, cependant, certains

encodages de caractères (comme UTF-8) encodent les caractères de manière

que tous les octets d'un caractère multi-octet soient dans la plage

autorisée, ce qui en fait ainsi un nom de variable valide.

</simpara>

</note>

<note>

<simpara>

<literal>$this</literal> est une variable spéciale,

qui ne peut pas être assignée.

Avant PHP 7.1.0, l'affectation indirecte (c.-à-d. en utilisant

<link linkend="language.variables.variable">les variables variables</link>)

était impossible.

</simpara>

</note>

&tip.userlandnaming;

<example>

<title>Noms de variables valides</title>

<programlisting role="php">

</programlisting>

</example>

<example>

<title>Noms de variables invalides</title>

<programlisting role="php">

</programlisting>

</example>

<simpara>

PHP accepte une séquence de n'importe quels octets comme nom de variable.

Les noms de variables qui ne respectent pas les règles de nommage mentionnées ci-dessus

ne peuvent être accédés que dynamiquement à l'exécution. Voir

<link linkend="language.variables.variable">variables variables</link>

pour plus d'informations sur la façon d'y accéder.

</simpara>

<example>

<title>Accéder à des noms de variables inhabituels</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

<para>

Par défaut, les variables sont toujours assignées par valeur.

C'est-à-dire, lorsqu'une expression est affectée à 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 l'une des variables n'aura pas d'effet sur l'autre. Pour plus

de détails sur ce genre d'assignation, se reporter aux

<link linkend="language.expressions">expressions</link>.

</para>

<para>

PHP permet aussi d'assigner les valeurs aux variables

<link linkend="language.references">par référence</link>. Cela

signifie que la nouvelle variable ne fait que référencer

(en d'autres termes, "devient un alias de", ou encore "pointe sur") la

variable originale. Les modifications de la nouvelle variable

affecteront l'ancienne et vice versa.

</para>

<para>

Pour assigner par référence, il suffit d'ajouter

un &amp; (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

fois :

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

</para>

<para>

Une chose importante à noter est que seules les variables

peuvent être assignées par référence.

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

</para>

<para>

Il n'est pas nécessaire de déclarer des variables en PHP, cependant, c'est une très

bonne pratique. Accéder à une variable non définie entraînera un

<constant>E_WARNING</constant> (avant PHP 8.0.0, <constant>E_NOTICE</constant>).

Une variable non définie a une valeur par défaut de &null;.

La construction de langage <function>isset</function> peut être utilisée

pour détecter si une variable a déjà été initialisée.

</para>

<para>

<example>

<title>Valeur par défaut d'une variable non initialisée</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<simpara>

PHP permet l'autovivification de tableaux (création automatique de nouveaux tableaux)

à partir d'une variable non définie.

Ajouter un élément à une variable non définie créera un nouveau tableau et

ne générera pas d'avertissement.

</simpara>

<example>

<title>Autovivification d'un tableau à partir d'une variable non définie</title>

<programlisting role="php">

</programlisting>

</example>

<warning>

<simpara>

Compter sur la valeur par défaut d'une variable non initialisée est problématique

lorsqu'un fichier inclus dans un autre utilise le même

nom de variable.

</simpara>

</warning>

<simpara>

Une variable peut être détruite en utilisant la construction de langage <function>unset</function>.

</simpara>

<simpara>

Pour plus d'informations sur les fonctions liées aux variables, consulter la

<link linkend="ref.var">Référence des fonctions sur les variables</link>.

</simpara>

</sect1>

<sect1 xml:id="language.variables.predefined">

<title>Variables prédéfinies</title>

<para>

PHP fournit un certain nombre de

<link linkend="reserved.variables">variables prédéfinies</link>.

PHP fournit aussi un jeu de tableaux prédéfinis contenant les variables

du serveur (si possible), les variables d'environnement et celles d'entrées.

Ces tableaux sont automatiquement disponibles dans chaque portée.

Pour cette raison, ils sont dits 'superglobaux'. (il n'y a pas de mécanisme en

PHP pour créer de telles variables.) Pour plus de détails voir la

<link linkend="language.variables.superglobals">liste des superglobales</link>.

</para>

<note>

<title>Variables variables</title>

<para>

Les superglobales ne peuvent pas être utilisées comme

<link linkend="language.variables.variable">variables dynamiques</link>

dans les fonctions ou les méthodes des classes.

</para>

</note>

<para>

Si certaines variables de

<link linkend="ini.variables-order"><option>variables_order</option></link>

ne sont pas définies, leur tableau prédéfini PHP correspondant est laissé vide.

</para>

</sect1>

<sect1 xml:id="language.variables.scope">

<title>Portée des variables</title>

<simpara>

La portée d'une variable est le contexte dans lequel elle est définie.

PHP possède une portée de fonction et une portée globale.

Toute variable définie en dehors d'une fonction est limitée à la portée globale.

Lorsqu'un fichier est inclus, le code qu'il contient hérite de la portée des variables

de la ligne où l'inclusion a lieu.

</simpara>

<example>

<title>Exemple de portée de variable globale</title>

<programlisting role="php">

</programlisting>

</example>

<simpara>

Toute variable créée à l'intérieur d'une fonction nommée ou d'une

<link linkend="functions.anonymous">fonction anonyme</link>

est limitée à la portée du corps de la fonction.

Cependant, les <link linkend="functions.arrow">fonctions fléchées</link>

lient les variables de la portée parente pour les rendre disponibles dans le corps.

Si un fichier est inclus à l'intérieur d'une fonction dans

le fichier appelant, les variables contenues dans le fichier appelé seront

disponibles comme si elles avaient été définies à l'intérieur de la fonction appelante.

</simpara>

<example>

<title>Exemple de portée de variable locale</title>

<programlisting role="php">

</programlisting>

</example>

<simpara>

L'exemple ci-dessus générera un <constant>E_WARNING</constant> de variable indéfinie

(ou un <constant>E_NOTICE</constant> avant PHP 8.0.0).

La raison pour cela est que

l'instruction <function>echo</function> utilise la variable locale <varname>$a</varname>,

et celle-ci n'a pas été assignée

préalablement dans la fonction. Il est à noter que

ce concept diffère un petit peu du langage C dans

lequel une variable globale est automatiquement accessible dans

les fonctions, à moins d'être redéfinie

localement dans la fonction. Cela peut poser des problèmes

lors de la redéfinition de variables globales localement.

En PHP, une variable globale doit être

déclarée à l'intérieur de chaque

fonction afin de pouvoir être utilisée dans cette

fonction.

</simpara>

<sect2 xml:id="language.variables.scope.global">

<title>Le mot clé <literal>global</literal></title>

<simpara>

Le mot-clé <literal>global</literal> est utilisé pour lier une variable

de la portée globale dans une portée locale. Le mot-clé peut être utilisé avec

une liste de variables ou une seule variable. Une variable locale sera créée

faisant référence à la variable globale du même nom. Si la variable globale

n'existe pas, la variable sera créée dans la portée globale et

assignée à &null;.

</simpara>

<para>

<example>

<title>Exemple avec <literal>global</literal></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<simpara>

En déclarant globales les variables <varname>$a</varname> et

<varname>$b</varname> 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.

</simpara>

<simpara>

Une deuxième méthode pour accéder aux

variables globales est d'utiliser le tableau associatif

prédéfini <varname>$GLOBALS</varname>. Le précédent

exemple peut être réécrit de la

manière suivante :

</simpara>

<para>

<example>

<title>Les variables globales et <varname>$GLOBALS</varname></title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Le tableau <varname>$GLOBALS</varname> est un tableau associatif avec le nom

des variables globales comme clé et les valeurs des éléments

du tableau comme valeur des variables. Il est à noter que <varname>$GLOBALS</varname>

existe dans tous les contextes, car <varname>$GLOBALS</varname> est un

<link linkend="language.variables.superglobals">superglobal</link>.

Voici un exemple illustrant la puissance des superglobaux :

</simpara>

<para>

<example>

<title>Exemple montrant les superglobales et la portée</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<note>

<simpara>

L'utilisation du mot clé <literal>global</literal> à l'extérieur

d'une fonction n'est pas une erreur. Il peut être utilisé si le fichier

est inclus depuis l'intérieur d'une fonction.

</simpara>

</note>

</sect2>

<sect2 xml:id="language.variables.scope.static">

<title>Utilisation des variables <literal>static</literal></title>

<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

script appelle la fonction. Prenons l'exemple suivant :

</simpara>

<para>

<example>

<title>Les variables statiques</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Cette fonction est un peu inutile car à chaque fois

qu'elle est appelée, elle initialise <varname>$a</varname> à <literal>0</literal> et

affiche "<literal>0</literal>". L'incrémentation de la variable (<varname>$a</varname>++)

ne sert pas à grand chose, car dès que la

fonction est terminée, la variable <varname>$a</varname> disparaît.

Pour faire une fonction de comptage utile, c'est-à-dire qui

ne perdra pas la trace du compteur, la variable <varname>$a</varname> est

déclarée comme une variable statique :

</simpara>

<para>

<example>

<title>Les variables statiques (2)</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Maintenant, la variable <varname>$a</varname> est initialisée uniquement

lors du premier appel à la fonction et, à chaque fois que la fonction

<literal>test()</literal> est appelée, elle affichera une valeur de

<varname>$a</varname> incrémentée de 1.

</simpara>

<simpara>

Les variables statiques sont essentielles lors

d'appels récursifs à une fonction. La fonction

suivante compte récursivement jusqu'à 10, en utilisant la variable

<varname>$count</varname> pour savoir quand il faut s'arrêter :

</simpara>

<para>

<example>

<title>Les variables statiques et la récursivité</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

Avant PHP 8.3.0, une variable statique ne pouvait être initialisée qu'en utilisant

une expression constante. À partir de PHP 8.3.0, les expressions dynamiques

(par exemple, les appels de fonction) sont également autorisées :

</para>

<para>

<example>

<title>Déclaration de variables statiques</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Les variables statiques à l'intérieur des fonctions anonymes persistent uniquement au sein de cette

instance spécifique de la fonction. Si la fonction anonyme est recréée à chaque

appel, la variable statique sera réinitialisée.

</simpara>

<example>

<title>Variables statiques dans les fonctions anonymes</title>

<programlisting role="php">

</programlisting>

</example>

<para>

À partir de PHP 8.1.0, lorsqu'une méthode utilisant des variables statiques

est héritée (mais pas surchargée), la méthode héritée partage désormais les

variables statiques avec la méthode parente.

Cela signifie que les variables statiques dans les méthodes se comportent

dorénavant de la même manière que les propriétés statiques.

</para>

<simpara>

À partir de PHP 8.3.0, les variables statiques peuvent être initialisées avec des expressions arbitraires.

Cela signifie que des appels de méthode, par exemple, peuvent être utilisés pour initialiser des variables statiques.

</simpara>

<example>

<title>Utilisation de variables statiques dans les méthodes héritées</title>

<programlisting role="php">

</programlisting>

</example>

</sect2>

<sect2 xml:id="language.variables.scope.references">

<title>

Les références avec les variables <literal>global</literal> et <literal>static</literal>

</title>

<simpara>

PHP implémente les modificateurs de variables

<link linkend="language.variables.scope.static">static</link>

et <link linkend="language.variables.scope.global">global</link>,

en termes de <link linkend="language.references">référence</link>.

Par exemple, une vraie variable globale est importée dans un

contexte de fonction avec <literal>global</literal>.

Cette commande crée en fait une référence sur la variable globale. Cela

peut mener à des comportements inattendus, par exemple :

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

&example.outputs;

<screen>

</screen>

<simpara>

Un comportement similaire s'applique à la commande <literal>static</literal>.

Les références ne sont pas stockées dynamiquement :

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

&example.outputs;

<screen>

</screen>

<simpara>

Ces exemples illustrent les problèmes rencontrés lors de l'assignation

de référence à des variables statiques, qui sont

<emphasis>oubliées</emphasis> lorsque

<literal>&amp;get_instance_ref()</literal> est appelé une seconde fois.

</simpara>

</sect2>

</sect1>

<sect1 xml:id="language.variables.variable">

<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 est affecté et utilisé

dynamiquement. Une variable classique est affectée avec

l'instruction suivante :

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<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>bonjour</emphasis> peut être utilisé comme le nom d'une

variable en utilisant le "$$" précédent la variable.

C'est-à-dire :

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

À ce niveau, deux variables ont été définies et

stockées dans l'arbre des symboles PHP : <varname>$a</varname> avec comme valeur

"bonjour" et <varname>$bonjour</varname> avec comme valeur "monde". Alors, l'instruction :

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

produira le même affichage que :

</simpara>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

<simpara>

c'est-à-dire : <computeroutput>bonjour monde</computeroutput>.

</simpara>

<simpara>

Afin d'utiliser des variables variables avec des tableaux,

un problème d'ambiguïté doit être résolu. En effet, si l'analyseur rencontre

<varname>$$a[1]</varname>, il doit déterminer si

<varname>$a[1]</varname> devait être utilisé comme une variable, ou si

<varname>$$a</varname> était attendu comme la variable, suivi de l'indice <literal>[1]</literal>

de cette variable. La syntaxe pour résoudre

cette ambiguïté est la suivante : <varname>${$a[1]}</varname> pour le premier

cas et <varname>${$a}[1]</varname> pour le deuxième.

</simpara>

<simpara>

On peut également accéder aux propriétés d'une classe

en utilisant les noms des variables. Le nom de la variable

sera résolu en utilisant la portée depuis laquelle l'appel

s'effectue. Par exemple, s'il y a une expression de la forme

<varname>$foo->$bar</varname>, alors la portée locale sera

examinée pour <varname>$bar</varname> et sa valeur sera utilisée

comme nom pour la propriété de <varname>$foo</varname>.

Ce comportement reste valide si <varname>$bar</varname>

est un tableau.

</simpara>

<simpara>

Les accolades peuvent aussi être utilisées pour clairement délimiter

le nom de la propriété. Ceci est utile lors de l'accès à des valeurs

d'une propriété qui contient un tableau, lorsque le nom de la propriété

est composé de plusieurs parties, ou lorsque le nom de la propriété

contient des caractères non valides (c.-à-d. depuis la fonction

<function>json_decode</function> ou <link linkend="book.simplexml">SimpleXML</link>).

</simpara>

<para>

<example>

<title>Exemple de propriété variable</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<warning>

<simpara>

Il est à noter que les variables dynamiques ne peuvent pas être utilisées

avec les

<link linkend="language.variables.superglobals">tableaux Superglobaux</link> dans

une fonction ou une classe. La variable <literal>$this</literal> est aussi

une variable spéciale qui ne peut être référencée dynamiquement.

</simpara>

</warning>

</sect1>

<sect1 xml:id="language.variables.external">

<title>Variables externes à PHP</title>

<sect2 xml:id="language.variables.external.form">

<title>Formulaires HTML (GET et POST)</title>

<simpara>

Lorsqu'un formulaire est envoyé à un script PHP,

toutes les variables du formulaire seront automatiquement disponibles

dans le script. Il y a peu de façons pour récupérer ces informations,

par exemple :

</simpara>

<para>

<example>

<title>Exemple avec un formulaire simple</title>

<programlisting role="html">

</programlisting>

</example>

</para>

<para>

Il n'y a que deux façons d'accéder aux données provenant d'un formulaire HTML.

Les méthodes disponibles actuellement sont décrites ci-dessous :

</para>

<para>

<example>

<title>Accéder simplement à des variables de formulaires POST</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

Utiliser un formulaire de type GET est similaire, hormis le fait que

les variables prédéfinies de GET peuvent être utilisées à la place.

GET s'applique aussi à la <literal>QUERY_STRING</literal>

(les informations disponibles après le '?' dans une URL).

De ce fait, par exemple,

<literal>http://www.example.com/test.php?id=3</literal>

contient les données de GET, qui sont accessibles via <varname>$_GET['id']</varname>.

Voir aussi <varname>$_REQUEST</varname>.

</para>

<note>

<para>

Les points et les espaces dans les noms de variables

sont convertis en underscores. Par exemple,

<literal>&lt;input name="a.b" /&gt;</literal> deviendra

<literal>$_REQUEST["a_b"]</literal>.

</para>

</note>

<simpara>

PHP comprend aussi les tableaux dans le contexte des formulaires.

(voir aussi <link linkend="faq.html">la FAQ</link>).

Par exemple, des variables peuvent être groupées ensemble ou cette

fonctionnalité peut être utilisée pour lire des valeurs multiples d'un menu déroulant.

Par exemple, voici un formulaire qui se poste lui-même des données,

et les affiche :

</simpara>

<para>

<example>

<title>Variables de formulaires complexes</title>

<programlisting role="php">

</programlisting>

</example>

</para>