PHP マニュアル
前のページ		次のページ

CVI. オブジェクトプロパティとメソッドコールのオーバーロード

導入

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

警告

この拡張モジュールは、 実験的 なものです。この拡張モジュールの動作・関数名・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。このモジュールは自己責任で使用してください。

警告

この拡張モジュールは PHP 5 には含まれていません。PHP 5 では __get()、__set() および __call() をネイティブにサポートしています。詳細は PHP 5 のオーバーロードのページを参照ください。

要件

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

インストール手順

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

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

注意: オーバーロードの組み込みサポートは PHP 4.3.0 で利用可能となりました。

実行時設定

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

リソース型

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

定義済み定数

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

例

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);

?>

目次
overload -- クラスのプロパティおよびメソッドに関してオーバーロードを可能にする

前のページ	ホーム	次のページ
deaggregate	上に戻る	overload