session_register

説明

bool session_register ( mixed name [, mixed ...])

session_register() の引数の数は可変であり、各引数は変数名を保持する文字列または変数名からなる配列とすることが可能です。各変数名が処理される毎に、session_register() は、その変数名のグローバル変数を現在のセッションに登録します。

注意

register_globalsを考慮することなくスクリプトを書きたい場合には、 $_SESSION配列を代わりに使用する必要があります。 $_SESSIONのエントリーは自動的に登録されます。スクリプトでsession_register()を使用している場合には、それは register_globalsを不可としている環境下では動作しません。

register_globals: 重要な注意: PHP 4.2.0以降、PHPディレクティブ register_globalsのデフォルト値はoffとなっています。PHPコミュニティは、ユーザがこのディレクティブの設定に依存せず、superglobalsのような他の手段を使用することを推奨します。

注意

この関数は、global変数を登録します。セッション変数を関数の内部で登録したい場合、global() を用いてその変数をグローバルとするか、下記のようにsession配列を使用して下さい。

注意

$HTTP_SESSION_VARS（または$_SESSION）を使用する場合、 session_register(), session_is_registered(), session_unregister()を使用しないで下さい。

この関数は全ての変数のセッションへの登録に成功した場合にTRUEを返します。

この関数をコールする前にsession_start()をコールしていない場合、暗黙のうちに引数を付けずに session_start()がコールされます。 $_SESSION を使う場合はこの動作とは違い、使用前に必ずsession_start()をコールする必要があります。

配列$HTTP_SESSION_VARSまたは$_SESSION (PHP >= 4.1.0)の適当なメンバに設定をするだけでもセッション変数を作成することが可能です。


<?php
// session_register() の使用は推奨されません。
$barney = "A big purple dinosaur.";
session_register("barney");

// PHP 4.1.0以降では$_SESSIONの使用が推奨されます。
$_SESSION["zim"] = "An invader from another planet.";

// 古い手法としては $HTTP_SESSION_VARS があります。
$HTTP_SESSION_VARS["spongebob"] = "He's got square pants.";
?>

注意: セッションにリソース変数を登録することは現在できません。例えば、データベースへの接続を生成し、接続IDをセッション変数として登録し、セッションが回復された時点で、接続が有効であることを期待することはできません。リソースを返すPHP関数は、その関数定義に resource型の返り値を有することが示されている。リソースを返す関数のリストは、付録 resource typesで見ることができます。
$_SESSION (またはPHP 4.0.6以前は$HTTP_SESSION_VARS)が使用されている場合、$_SESSIONに変数を代入して下さい。すなわち、$_SESSION['var'] = 'ABC';

session_is_registered(), session_unregister(), $_SESSION も参照して下さい。