7.94 Sessions
7 Index des fonctions
Manuel PHP
. Introduction . Sessions et sécurité . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes prédefinies . Exemples . Passer l'identifiant de session (session ID) . Gestion personnalisée des sessions . session_cache_expire . session_cache_limiter . session_decode . session_destroy . session_encode . session_get_cookie_params . session_id . session_is_registered . session_module_name . session_name . session_regenerate_id ->session_register . session_save_path . session_set_cookie_params . session_set_save_handler . session_start . session_unregister . session_unset . session_write_close
|
7.94.22 session_register()
Enregistre une variable dans une session
[ Exemples avec session_register ] PHP 4
bool
session_register (
mixed
name
,
mixed
...
)
session_register
enregistre toutes les
variables de nom
name
dans la session courante.
Le nombre de variables enregistré est libre. Les noms peuvent être
passé 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
$_SESSION
.
Tous les éléments de
$_SESSION
sont automatiquement
enregistrée. Si votre script utilise
session_register
, il ne fonctionnera pas
dans les environnements où
register_globals
est désactivée.
|
Note | register_globals : note importante
Depuis PHP 4.2.0, la valeur par défaut de la directive de configuration PHP register_globals vaut
off
. 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 enregistrer une variable globale dans une fonction, vous
devez vous assurer de la rendre
globale
,
avec
global
,
ou bien le tableau
$GLOBALS[]
,
ou bien utiliser un des tableaux de session ci-dessous.
|
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 ne 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
.
Exemple avec session_register |
<?php $barney = "Un gros dinosaure violet."; session_register("barney");
$_SESSION["zim"] = "Un envahisseur d'un autre planète.";
// L'ancienne méthode avec $HTTP_SESSION_VARS $HTTP_SESSION_VARS["spongebob"] = "Il a un caleçon carré!"; ?>
|
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
leur définitions. Une liste de fonction qui retournent de3s
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
et
session_unregister
.
|