タイプヒンティング (クラスとオブジェクト) - PHPプロ！マニュアル
PHPマニュアル
タイプヒンティング
タイプヒンティング
PHP 5では、タイプヒンティング(Type Hinting)が導入されました。 これにより、関数は、 (クラスの名前を関数プロトタイプの中に指定することにより) パラメータをオブジェクトもしくは配列 (PHP5.1以降) が必ず指定されるようにすることができるようになりました。 しかし、デフォルトのパラメータの値として NULL を使用した場合は、後から任意の値を引数に指定できるようになります。
例1 タイプヒンティングの例
<?php
// とあるクラス
class MyClass
{
/**
* テスト関数
*
* 第 1 引数は OtherClass 型のオブジェクトでなければならない
*/
public function test(OtherClass $otherclass) {
echo $otherclass->var;
}
/**
* もう一つのテスト関数
*
* 第 1 引数は配列でなければならない
*/
public function test_array(array $input_array) {
print_r($input_array);
}
}
// もう一つのサンプルクラス
class OtherClass {
public $var = 'Hello World';
}
?>タイプヒントの指定を満たさないとキャッチ可能な致命的エラーとなります。
<?php
// それぞれのクラスのインスタンス
$myclass = new MyClass;
$otherclass = new OtherClass;
// Fatal Error: Argument 1 must be an object of class OtherClass
$myclass->test('hello');
// Fatal Error: Argument 1 must be an instance of OtherClass
$foo = new stdClass;
$myclass->test($foo);
// Fatal Error: Argument 1 must not be null
$myclass->test(null);
// Works: Prints Hello World
$myclass->test($otherclass);
// Fatal Error: Argument 1 must be an array
$myclass->test_array('a string');
// 動作する: 配列の内容を表示する
$myclass->test_array(array('a', 'b', 'c'));
?>タイプヒンティングは、関数でも使用できます。
<?php
// とあるクラス
class MyClass {
public $var = 'Hello World';
}
/**
* テスト関数
*
* 第 1 引数は MyClass 型のオブジェクトでなければならない
*/
function MyFunction(MyClass $foo) {
echo $foo->var;
}
// 動作する
$myclass = new MyClass;
MyFunction($myclass);
?>タイプヒントには NULL 値を使用することもできます。
<?php
/* NULL 値も使えます */
function test(stdClass $obj = NULL) {
}
test(NULL);
test(new stdClass);
?>タイプヒントは、object型やarray型 (PHP5.1以降) でのみ使用できます。 int および stringのような 通常の型でのタイプヒンティングはサポートされません。
ページのトップへ
一つの目安として、ECサイトの購入情報など絶対に消えてはいけないものはDBに、カートなどの一時的に使用する情報や、ユーザに任意のタイミングで消去されても構わないものはセッションにと使い分けるといいでしょう。