session_register() enregistre toutes les
variables de nom name
dans la session courante.
Le nombre de variables enregistrées est libre. Les noms peuvent être
passés comme des chaînes, ou comme des tableaux contenant des chaînes
ou des tableaux. Pour chaque nom, session_register()
place la variable dans la session courante, pour la sauvegarde de fin
de script.
Attention |
Si vous voulez que votre script fonctionne indépendamment de
la configuration de la directive
register_globals,
vous devez utiliser la variable |
register_globals : note importante : Depuis PHP 4.2.0, la valeur par défaut de la directive de configuration PHP register_globals vaut off et est complètement retirée depuis PHP 6.0.0. La communauté PHP vous recommande de ne pas dépendre de cette directive, mais de trouver d'autres moyens pour accéder aux données, tels que les superglobals.
Attention |
Cette fonction enregistre une variable global.
Si vous enregistrez une variable globale dans une fonction, vous
devez vous assurer de la rendre globale,
avec global
ou le tableau |
Attention |
Si vous utilisez |
session_register() retourne TRUE si toutes les variables ont été enregistrées correctement dans la session.
Si session_start() n'a pas été appelé avant cette fonction, un appel implicite à session_start() sans aucun paramètre sera fait.
Vous pouvez aussi créer une variable de session, simplement
en ajoutant l'index approprié dans la variable
$_SESSION
ou $HTTP_SESSION_VARS
(PHP < 4.1.0).
Note : Il n'est actuellement pas possible d'enregistrer des ressources dans les sessions. Par exemple, vous ne pouvez pas créer de connexion à une base de données, et stocker la connexion dans une variable de session. Elle ne sera pas valide lors de la prochaine page. Les fonctions PHP qui retournent des ressources sont identifiées avec le type resource dans leurs définitions. Une liste de fonctions qui retournent des ressources sont disponible dans l'annexe types de ressources.
Si
$_SESSION
(ou$HTTP_SESSION_VARS
pour les versions antérieures à PHP 4.0.6) est utilisé, assignez les variables à$_SESSION
: i.e. $_SESSION['var'] = 'ABC';
Voir aussi
session_is_registered(),
session_unregister() et
$_SESSION
.
Précédent | Sommaire | Suivant |
session_regenerate_id | Niveau supérieur | session_save_path |