session_id

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

session_id — 現在のセッション ID を取得または設定する

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

session_id() は現在のセッション ID を取得または設定するために使用されます。

現在の名前とセッション ID を、URL に追加可能な文字列として取得するために定数 SID も使用できます。セッションハンドリングも参照ください。

id: id が指定され、null でない場合、現在のセッション ID を置換します。その際、この関数は session_start() より前にコールされている必要があります。セッションハンドラによっては、セッション ID として使用できる文字に制限がある場合があります。例えば、ファイルによるセッションハンドラではセッション ID として使える文字は [a-zA-Z0-9,-] に限られます!

注意: セッション保持にクッキーを使用している場合、 session_id() において id 引数を指定すると、現在のセッション ID がセットされるものとまったく同一であるかどうかに関わらず、 session_start() が呼び出される際に常に新しいクッキーが送信されます。

session_id() は現在のセッションのセッション ID を返します。現在のセッションが存在しない (現在のセッション ID が存在しない) 場合は空文字列 ("") を返します。失敗時には、false を返します。

バージョン	説明
8.0.0	`id` は、nullable になりました。