Web aym.pekori.to

session_name

(PHP 4, PHP 5)

session_name -- カレントのセッション名を取得または設定する

説明

string session_name ( [string name] )

session_name() は、カレントのセッション名を 返します。name を指定した場合、カレントの セッション名は、その値に変更されます。

セッション名は、クッキーおよび URL のセッション ID を参照します。 セッション名は英数字のみで構成されている必要があり、また、短かく、 その内容が分かるようなものである必要があります (これは、クッキー警告を 有効にしているユーザ用です)。セッション名は、リクエストが開始された際に セッション名に保存された session.name の デフォルト値にリセットされます。よって、各リクエスト毎に(そして session_start() または session_register() をコールする前に) session_name() をコールする必要があります。

警告

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

例 1. session_name() の例

<?php

// セッション名をWebsiteIDに設定する

$previous_name = session_name("WebsiteID");

echo
"前回のセッション名は、$previous_name です。<br />";
?>

session.name 設定ディレクティブも参照してください。