session_name
(PHP 4, PHP 5, PHP 7)
session_name — Lit et/ou modifie le nom de la session
Description
$name
] ) : string
session_name() retourne le nom de la session
courante. Si le paramètre name est fourni,
session_name() modifiera le nom de la session
et retournera l'ancien nom de la session.
Si un nouveau nom de session name est
fourni, session_name() modifie le cookie HTTP
(et le contenue de sortie quand session.transid est
activé). Une fois que le cookie HTTP est
envoyé, session_name() émet une erreur.
session_name() doit être appelé
avant session_start() pour que la session fonctionne
correctement.
Le nom de la session est réinitialisé à la valeur par défaut, stockée dans session.name lors du démarrage. Ainsi, vous devez appeler session_name() pour chaque demande (et avant que session_start() soit appelé).
Liste de paramètres
-
name -
Le nom de session est utilisé comme nom pour les cookies et les URLs (i.e. PHPSESSID). Il ne doit contenir que des caractères alphanumériques ; il doit être court et descriptif (surtout pour les utilisateurs ayant activé l'alerte cookie). Si
nameest fourni, le nom de la session courante sera remplacé par cette valeur.AvertissementLes noms de session ne peuvent pas contenir uniquement des chiffres, au moins une lettre doit être présente. Sinon, un identifiant de session sera généré à chaque fois.
Valeurs de retour
Retourne le nom de la session courante. Si le paramètre name
est fourni et que la fonction met à jour le nom de la session, alors
l'ancien nom de session sera retourné.
Exemples
Exemple #1 Exemple avec session_name()
<?php
/* choisi le nom de session : WebsiteID */
$previous_name = session_name("WebsiteID");
echo "L'ancien nom de la session était $previous_name<br />";
?>
Historique
| Version | Description |
|---|---|
| 7.2.0 | session_name() vérifie l'état de la session, auparavant elle vérifiait uniquement l'état du cookie. Par conséquent, les versions plus anciennes de session_name() autorise l'appel de session_name() après session_start() ce qui peut causer le plantage de PHP et peut donner lieu à des comportements étranges. |
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-session-name.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
