# session_id

(PHP 4, PHP 5, PHP 7, PHP 8)

session_id — Lit et/ou modifie l'identifiant courant de session

### Description

session_id(?string `$id` = `null`): string|false

session_id() est utilisé pour récupérer ou définir l'identifiant de session pour la session courante.

La constante `SID` peut également être utilisée pour lire le nom de la session courante et l'identifiant de session à fournir dans les URL. Voyez aussi Gestion de session.

### Liste de paramètres

`id`

  Si `id` est fourni et non `null`, il remplacera l'identifiant courant de session. session_id() doit alors être appelé avant session_start(). Suivant le gestionnaire de sessions que vous utilisez, tous les caractères ne seront pas acceptés dans cette valeur. Par exemple, le gestionnaire de sessions par défaut, basé sur les fichiers, n'accepte que les caractères compris dans l'intervalle `[a-zA-Z0-9,-]`!

  > Note: Lorsque vous utilisez les sessions avec les cookies, le fait de spécifier un `id` pour session_id() fera qu'un nouveau cookie sera toujours envoyé lors de l'appel à session_start(), sans se soucier si l'identifiant de session courant est identique à celui qui vient d'être défini.

### Valeurs de retour

session_id() retourne l'identifiant de session pour la session courante ou une chaîne vide (`""`) s'il n'y a pas de session courante (aucun identifiant de session n'existe). En cas d'échec, `false` est retourné.

### Historique

Version | Description
--- | ---
8.0.0 | `id` est désormais nullable.

### Voir aussi

- session_regenerate_id() - Remplace l'identifiant de session courant par un nouveau
- session_start() - Démarre une nouvelle session ou reprend une session existante
- session_set_save_handler() - Configure les fonctions de stockage de sessions
- session.save_handler