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 />";
?>

参考