session_name
(PHP 4, PHP 5, PHP 7)
session_name — 現在のセッション名を取得または設定する
説明
string session_name
([ string $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 />";
?>