PHP的重載-使用魔術方法實現

摘錄PHP官網對PHP重載的解釋：

PHP所提供的"重載"（overloading）是指動態地"建立"類屬性和方法。咱們是經過魔術方法（magic methods）來實現的。
當調用當前環境下未定義或不可見的類屬性或方法時，重載方法會被調用。本節後面將使用"不可訪問屬性（inaccessible properties）"和"不可訪問方法（inaccessible methods）"來稱呼這些未定義或不可見的類屬性或方法。
全部的重載方法都必須被聲明爲 public。

Note:
這些魔術方法的參數都不能經過引用傳遞。

Note:
PHP中的"重載"與其它絕大多數面嚮對象語言不一樣。傳統的"重載"是用於提供多個同名的類方法，但各方法的參數類型和個數不一樣。

屬性重載
public __set ( string $name , mixed $value ) : void
public __get ( string $name ) : mixed
public __isset ( string $name ) : bool
public __unset ( string $name ) : void

在給不可訪問屬性賦值時，__set() 會被調用。
讀取不可訪問屬性的值時，__get() 會被調用。
當對不可訪問屬性調用 isset() 或 empty() 時，__isset() 會被調用。
當對不可訪問屬性調用 unset() 時，__unset() 會被調用。
參數 $name 是指要操做的變量名稱。__set() 方法的 $value 參數指定了 $name 變量的值。
屬性重載只能在對象中進行。在靜態方法中，這些魔術方法將不會被調用。因此這些方法都不能被 聲明爲 static。

Note:
由於 PHP 處理賦值運算的方式，__set() 的返回值將被忽略。相似的, 在下面這樣的鏈式賦值中，__get() 不會被調用：
$a = $obj->b = 8;

Note:
在除 isset() 外的其它語言結構中沒法使用重載的屬性，這意味着當對一個重載的屬性使用 empty() 時，重載魔術方法將不會被調用。
爲避開此限制，必須將重載屬性賦值到本地變量再使用 empty()。

Example #1 使用 __get()，__set()，__isset() 和 __unset() 進行屬性重載

class PropertyTest
{
    /**  被重載的數據保存在此  */
    private $data = array();

    /**  重載不能被用在已經定義的屬性  */
    public $declared = 1;

    /**  只有從類外部訪問這個屬性時，重載纔會發生 */
    private $hidden = 2;

    public function __set ($name, $value)
    {
        $this->data[$name] = $value;
    }

    public function __get ($name)
    {
        if (isset($this->$name)) {
            return $this->$name;
        }
        if (array_key_exists($name, $this->data)) {
            return $this->data[$name];
        }
        //產生一條回溯跟蹤
        $trace = debug_backtrace();
        //拋出異常
        trigger_error('Undefined property via __get(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_NOTICE);
        return null;
    }

    public function __isset ($name)
    {
        return isset($this->data[$name]);
    }

    public function __unset ($name)
    {
        unset($this->data[$name]);
    }

    /**  非魔術方法  */
    public function getHidden ()
    {
        return $this->hidden;
    }
}

$obj = new PropertyTest;

//輸出不存在的a變量，走到__get()中，會拋出異常
echo $obj->a;

//對不存在的a變量賦值爲1，會走到__set()中
$obj->a = 1;

//再次輸出a變量，因爲上面已經對其__set()，因此這是能夠訪問到a的值爲1
echo $obj->a;

//此時使用isset()對不存在的a變量進行運算時，會走到__isset()中，因爲上面已經對其__set()，因此是true
var_dump(isset($obj->a));

//對a進行unset()時，會走到__unset()中
unset($obj->a);

//再對其進行isset()，此時已經不存在了
var_dump(isset($obj->a));

//訪問private 屬性的變量，會進入__get()中
echo $obj->hidden;

方法重載
public __call ( string $name , array $arguments ) : mixed
public static __callStatic ( string $name , array $arguments ) : mixed

在對象中調用一個不可訪問方法時，__call() 會被調用。
在靜態上下文中調用一個不可訪問方法時，__callStatic() 會被調用。
$name 參數是要調用的方法名稱。
$arguments 參數是一個枚舉數組，包含着要傳遞給方法 $name 的參數。

Example #2 使用 __call() 和 __callStatic() 對方法重載

class MethodTest
{
    /**
     * 調用不存在的方法時進入此處
     * @param $name
     * @param $arguments
     */
    public function __call ($name, $arguments)
    {
        // 注意: $name 的值區分大小寫
        $info = [
            'name' => $name,
            'arguments' => $arguments,
        ];
        print_r($info);
    }

    /**
     * PHP 5.3.0以後版本
     * 調用不存在的靜態方法時，進入此處
     */
    public static function __callStatic ($name, $arguments)
    {
        // 注意: $name 的值區分大小寫
        $info = [
            'name' => $name,
            'arguments' => $arguments,
        ];
        print_r($info);
    }
}

$arguments = ['A', 'B', 'C'];

$obj = new MethodTest;
$obj->test(...$arguments);

MethodTest::test(...$arguments);  // PHP 5.3.0以後版本

/*
 *  以上兩個都輸出：
 *  Array
    (
        [name] => test
        [arguments] => Array
            (
                [0] => A
                [1] => B
                [2] => C
            )

    )
 */