導入

この拡張モジュールの用途は、オブジェクトのプロパティへのアクセスと メソッドのコールのオーバーロードを可能にすることです。この 拡張モジュールで定義されている関数は 1 つだけです。この関数、 overload() は、この機能を有効にするクラスの名前を 引数とします。名前を指定されたクラスでこの機能を使用したい場合は 以下の適当なメソッドを定義する必要があります。これらは、 __get()、__set()、 __call() で、それぞれプロパティを取得、 プロパティを設定、メソッドをコールするためのものです。 オーバーロード機能は選択可能です。これらのハンドラ関数の中で オーバーロードを無効とすることができ、 この場合、オブジェクトのプロパティに普通にアクセスできます。

要件

外部ライブラリを必要としません。

インストール手順

以下の関数を使用するには、オプション --enable-overload を指定して PHP を コンパイルする必要があります。この拡張モジュールは、 PHP 4.3.0 ではデフォルトで有効になっています。 --disable--overload により オーバーロードのサポートを無効とすることができます。

Windows 版の PHP には この拡張モジュールのサポートが組み込まれています。これらの関数を使用 するために拡張モジュールを追加でロードする必要はありません。

実行時設定

設定ディレクティブは定義されていません。

リソース型

リソース型は定義されていません。

定義済み定数

定数は定義されていません。

例

overload() 関数の簡単な使用例をいくつか示します。

例 1. PHP クラスのオーバーロード <?php class OO {     var $a = 111;     var $elem = array('b' => 9, 'c' => 42);     // プロパティを取得するためのコールバックメソッド     function __get($prop_name, &$prop_value)     {         if (isset($this->elem[$prop_name])) {             $prop_value = $this->elem[$prop_name];             return true;         } else {             return false;         }     }     // プロパティを設定するためのコールバックメソッド     function __set($prop_name, $prop_value)     {         $this->elem[$prop_name] = $prop_value;         return true;     } } // OO オブジェクトをオーバーロードします。 overload('OO'); $o = new OO; echo "\$o->a: $o->a\n"; // 出力: $o->a: 111 echo "\$o->b: $o->b\n"; // 出力: $o->b: 9 echo "\$o->c: $o->c\n"; // 出力: $o->c: 42 echo "\$o->d: $o->d\n"; // 出力: $o->d: // OO の $elem 配列に新規アイテムを追加します。 $o->x = 56; // (PHP 4 に組み込まれている) stdclass のインスタンスを生成します。 // $val はオーバーロードされていません! $val = new stdclass; $val->prop = 555; // $val オブジェクトを有する配列として "a" を設定します。 // しかし、__set() はこれを $elem 配列に代入します。 $o->a = array($val); var_dump($o->a[0]->prop); ?>