session_register

(PHP 4, PHP 5 < 5.4.0)

session_register現在のセッションに1つ以上の変数を登録する

説明

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

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

配列 $_SESSION の適当なメンバに設定をするだけでもセッション変数を作成することが可能です。

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

// $_SESSIONの使用が推奨されます。
$_SESSION["zim"] = "An invader from another planet.";
?>

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

警告

この関数は PHP 5.3.0 で 非推奨となり、 PHP 5.4.0 で削除されました。

パラメータ

name

変数名を含む文字列、 あるいは変数名や配列を含む配列。

...

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

注意

警告

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

注意: register_globals: 重要な注意

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

警告

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

警告

$_SESSION を使用する場合は session_register()session_is_registered() および session_unregister() を使用しないでください。

注意:

セッションにリソース変数を登録することは現在できません。例えば、 データベースへの接続を生成し、接続IDをセッション変数として登録し、 セッションが回復された時点で、接続が有効であることを期待することはできません。 リソースを返すPHP関数は、その関数定義に resource型の返り値を有することが示されている。 リソースを返す関数のリストは、付録 リソース型の一覧 で見ることができます。

$_SESSION を使用する場合は、値を $_SESSION に代入します。 たとえば $_SESSION['var'] = 'ABC'; などのようにします。

参考