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

# session_id

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

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

### 説明

function 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 になりました。

### 参考

- session_regenerate_id() - 現在のセッションIDを新しく生成したものと置き換える
- session_start() - 新しいセッションを開始、あるいは既存のセッションを再開する
- session_set_save_handler() - ユーザー定義のセッション保存関数を設定する
- session.save_handler

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open