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

# session_name

(PHP 4, PHP 5, PHP 7)

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

### 説明

session_name ([ string `$name` ] ) : string

session_name() は、現在のセッション名を返します。 `name` を渡すと、 session_name() はセッション名を上書きして元のセッション名を返します。

リクエストが開始された際にセッション名はリセットされ、 session.name に保存されたデフォルト値に戻ります。 よって、各リクエスト毎に(そして session_start() または session_register() をコールする前に) session_name() をコールする必要があります。

### パラメータ

`name`

  セッションの名前を参照します。これは、クッキーや URL (例: PHPSESSID) で使われます。 セッション名は英数字のみで構成されている必要があり、また、 短く、その内容が分かるようなものである必要があります (これは、クッキー警告を有効にしているユーザー用です)。

  警告

  セッション名は数字だけで構成することはできません。 少なくとも文字がひとつ以上現れる必要があります。そうでない場合、 新規セッション ID が毎回生成されます。

### 返り値

現在のセッションの名前を返します。 `name` を渡すと、 session_name() はセッション名を上書きして元のセッション名を返します。

### 例

例1 session_name() の例

`<?php
/* セッション名をWebsiteIDに設定する */
$previous_name = session_name("WebsiteID");
echo "前回のセッション名は、$previous_name です。<br />";
?>`

### 参考

- 設定ディレクティブ session.name