&reftitle.examples;
Depuis PHP 4.1.0, $_SESSION est disponible comme
variable globale, au même titre que $_POST,
$_GET, $_REQUEST, etc.
Contrairement à $HTTP_SESSION_VARS,
$_SESSION est toujours globale. Par conséquent, vous
n'avez pas besoin d'utiliser le mot réservé
global
avec $_SESSION. Notez que cette documentation
a été modifiée pour utiliser $_SESSION.
Vous pouvez toujours le remplacer par
$HTTP_SESSION_VARS si vous préférez l'ancienne version.
Notez également que vous devez démarrer votre session en utilisant la fonction
session_start avant d'utiliser
la variable super-globale $_SESSION.
Les clés du tableau $_SESSION sont sujettes
aux mêmes limitations que les variables PHP habituelles, c'est-à-dire
qu'elles ne peuvent pas commencer par un nombre, mais commencer par
une lettre ou un souligné '_'. Pour plus de détails, reportez-vous à
la section sur les variables.
Si register_globals
est désactivé, seuls les éléments du tableau global
$_SESSION contiendront les variables
enregistrées dans la session. Les variables de sessions relues seront
uniquement disponibles dans $_SESSION.
L'utilisation de $_SESSION (ou
$HTTP_SESSION_VARS avec PHP 4.0.6 et plus ancien) est
recommandé pour une meilleure sécurité et un code plus facilement
entretenu. Avec $_SESSION, il n'y a pas besoin
d'utiliser les fonctions session_register,
session_unregister et
session_is_registered. Les variables de sessions
sont accessibles comme toute autre variable.
Enregistrer une variable avec $_SESSION.
]]>
Retirer une variable de session avec $_SESSION et inactif.
]]>
N'utilisez PAS la fonction unset
avec $_SESSION sous la forme
unset($_SESSION) sinon, cela rendra impossible
l'enregistrement de données dans la session en utilisant la super-globale
$_SESSION.
Vous ne pouvez pas utiliser les références sur des variables de session
car il n'y a aucune manière faisable de restaurer une référence vers une
autre variable.
Si register_globals
est activé, alors toutes les variables globales peuvent être
enregistrées comme variables de session, et toutes les variables de
sessions seront reconstituées comme variables globales. Comme PHP doit
savoir quels variables globales sont enregistrées comme variables
de sessions, l'utilisateur doit enregistrer les variables avec
session_register tandis que
$HTTP_SESSION_VARS et $_SESSION
ne nécessitent pas session_register.
Avant PHP 4.3.0, si vous utilisez $_SESSION et que
vous avez désactivé ,
n'utilisez pas session_register,
session_is_registered ou
session_unregister.
Désactiver
register_globals
est recommandé pour des raisons de sécurité et de performances.
Si register_globals
est activé, alors les variables globales et les entrées dans le tableau
$_SESSION seront des références sur la même valeur pour
les valeurs qui auront été enregistrées avant le démarrage de la session
(donc, dans les page précédentes). Cependant, si la variable a été enregistrée
avec $_SESSION, alors, la variable globale est disponible
jusqu'à la prochaine requête.
De plus, si vous enregistrez une nouvelle variable avec la fonction
session_register, l'entrée dans l'environnement
global et $_SESSION ne fera pas de référence vers la
même valeur jusqu'à la prochaine utilisation de
session_start (ceci s'applique à PHP 4.2.3 et
avant seulement). C'est à dire qu'une modification dans les variables
globales ne sera pas répercutée dans les entrées de
$_SESSION. Il est peu probable que cela ait un impact en
pratique et, de plus, cela a été corrigé en PHP 4.3.0.
Passer l'identifiant de session (session ID)
Il y a deux méthodes de propagation de l'identifiant de session :
Cookies
Par URL
Le module de session supporte les deux méthodes. Les cookies sont
optimaux, mais comme ils ne sont pas sûrs (tous les internautes
ne les acceptent pas), ils ne sont pas fiables. La seconde
méthode place l'identifiant de session directement dans les URL.
PHP est capable de faire cela de manière transparente, lorsqu'il est
compilé avec l'option
--enable-trans-sid. Si vous activez
cette option, les URL relatives seront modifiées pour contenir
l'identifiant de session automatiquement. Alternativement,
vous pouvez utiliser la constante SID, qui est
définie, si le client n'a pas envoyé le cookie approprié.
SID est soit de la forme
session_name=session_id ou une chaîne vide.
L'option arg_separator.output
de &php.ini; vous permet de personnaliser le séparateur d'arguments.
Pour être complètement en accord avec les spécifications XHTML, spécifiez
& ici.
Alternativement, vous pouvez utiliser la constante SID
qui est définie si la session a commencé. Si le client n'envoie pas un cookie de session
approprié, il aura la forme session_name=session_id.
Sinon, il vaudra une chaîne vide. Ainsi, vous pouvez dans tous les cas
l'inclure dans l'URL.
L'exemple suivant vous montre comment enregistrer une variable et comment
réaliser un lien correct avec une autre page, avec
SID.
Compter le nombre de passages d'un utilisateur sur une page
]]>
La fonction htmlspecialchars est utilisée lors de l'affichage
du SID dans le but de contrer les attaques XSS.
L'affichage du SID, comme montré dans l'exemple
ci-dessus, n'est pas nécessaire si
--enable-trans-sid a été utilisé pour compiler
PHP.
Les URL non-relatives sont considérées comme externes au site, et ne
recevront pas le SID, car c'est une fuite
d'informations vers un autre site (envoi d'informations importantes).
Gestion personnalisée des sessions
Pour implémenter un stockage en base de données, ou toute autre méthode,
vous aurez besoin de la fonction
session_set_save_handler pour
paramétrer vos propres fonctions de stockage.