session_regenerate_id
<<<		 session_register session_save_path
>>>
6.34 Sessions
6 Référence des fonctions
 Manuel PHP
. Introduction
. Sessions et sécurité
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Exemples
. Passer l'identifiant de session (session ID)
. Gestion personnalisée des sessions
. session_cache_expire
. session_cache_limiter
. session_commit
. 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

6.34.23 session_register() Enregistre une variable dans une session

[ Exemples avec session_register ]   PHP 4, PHP 5

bool  session_register ( mixed   name , mixed   ... )

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 $_SESSION . Tous les éléments de $_SESSION sont automatiquement enregistrés. 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 enregistrez une variable globale dans une fonction, vous devez vous assurer de la rendre globale , avec global ou le tableau $GLOBALS[] , ou bien utiliser un des tableaux de session ci-dessous.

Attention

Si vous utilisez $_SESSION (ou $HTTP_SESSION_VARS ), n'utilisez pas session_register , session_is_registered et session_unregister .

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).
Exemple avec session_register

<?php
// L'utilisation de session_register() est déconseillée
$barney = "Un gros dinosaure violet.";
session_register("barney");

// L'utilisation de $_SESSION est encouragée depuis PHP 4.1.0
$_SESSION["zim"] = "Un envahisseur d'une 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 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 .

<< session_register >>
session_regenerate_id Sessions session_save_path