PHP常用魔术方法详解与示例

凌晨两点半

发布时间：2026-10-13| 5人浏览过

原创

详细解析PHP中的核心魔术方法，涵盖属性与方法重载、对象序列化、克隆及字符串转换等关键场景，并提供完整代码示例以辅助理解。

魔术方法与PHP重载机制

PHP提供了丰富的“魔术方法”（Magic Methods），所有以双下划线 __ 开头的方法均被系统视为魔术方法。自定义方法应避免以此命名。这些方法实现了PHP的动态重载特性，允许在访问不存在的属性或方法时执行自定义逻辑。

第1步：属性重载 (get/set/isset/unset)

当访问类中不可访问（如私有变量在类外访问）或不存在的属性时，触发以下机制：

__set($name, $value): 给不可访问属性赋值时调用。
__get($name): 读取不可访问属性时调用。
__isset($name): 对不可访问属性使用 isset() 或 empty() 时调用。
__unset($name): 对不可访问属性使用 unset() 时调用。

注意：
1. 这四个方法不能定义为 static 静态方法，否则在 PHP 5.3.0+ 会触发 warning。
2. 参数禁止引用传递。

第2步：方法重载 (call/callStatic)

调用类中不存在或不可见的方法时触发：

__call($name, $arguments): 调用实例化对象的不存在方法时触发。
__callStatic($name, $arguments): 调用静态方法不存在的方法时触发（仅在 PHP 5.3.0+ 可用）。

第3步：对象生命周期管理

__construct(): 构造函数，用于初始化对象。
__destruct(): 析构函数，当所有引用删除或脚本结束时运行。
警告：析构函数中抛出异常会导致 fatal error，且此时 HTTP header 已发送。
__clone(): 对象克隆回调。必须通过 clone 关键字显式调用，不可直接作为普通方法调用。

第4步：序列化与类型转换

__sleep(): 调用 serialize() 时检查并执行。返回需序列化的变量名数组。若不返回值，则序列化 null 并产生 notice 错误。
__wakeup(): 调用 unserialize() 时逆向恢复对象状态。
__toString(): 将对象转换为字符串。PHP 5.2.0 前仅支持 echo/print；5.2.0+ 支持 printf()，但不得使用非字符修饰符（如 %d）。
__invoke(): 尝试以函数方式调用对象时触发（PHP 5.3.0+）。
__set_state(array $arr): 调用 var_export() 时的静态反演方法，接收一个表示属性状态的数组。

完整代码示例

以下代码演示了上述魔术方法的综合应用。观察控制台输出即可验证各方法的触发时机。


class Object {
    protected $array = array();

    // __construct: 实例化对象时调用
    function __construct() {
        echo __METHOD__." 你正在实例化对象<br>";
    }

    // __set: 给不存在的属性赋值时调用
    function __set($name, $value) {
        $this->array[$name] = $value;
    }

    // __get: 读取不存在的属性时调用
    function __get($name) {
        return $this->array[$name];
    }

    // __call: 调用不存在的方法时调用
    function __call($name, $arguments) {
        var_dump($name, $arguments);
        return "magic function\n";
    }

    // __callStatic: 调用不存在的静态方法时调用
    static function __callStatic($name, $arguments) {
        var_dump($name, $arguments);
        return "magic static function";
    }

    // __toString: 对象被当作字符串使用时调用
    function __toString() {
        return __CLASS__.'<br>';
    }

    // __invoke: 对象被当作函数调用时触发
    function __invoke($arguments) {
        var_dump($arguments);
        return __METHOD__.'<br>';
    }

    // __clone: 对象被克隆时调用
    function __clone() {
        echo __METHOD__." 你正在克隆对象<br>";
    }

    // __isset: 判断属性是否存在时调用
    function __isset($name) {
        echo __METHOD__." 你想判断有没有属性".$name."<br>";
        return 1;
    }

    // __unset: 销毁属性时调用
    function __unset($name) {
        echo __METHOD__." 你想删除属性".$name."<br>";
    }

    // __destruct: 对象销毁时调用
    function __destruct() {
        echo __METHOD__." 你正在注销对象<br>";
    }
}

// --- 测试用例 ---

// 1. 实例化
$obj = new Object();

// 2. 属性赋值 (触发 __set)
$obj->title = "hello";

// 3. 属性读取 (触发 __get)
echo $obj->title . "<br>";

// 4. 方法调用 (触发 __call)
$obj->test("hello", 123, 567);

// 5. 静态方法调用 (触发 __callStatic)
Object::staticMethod("static", "not found method");

// 6. 隐式字符串转换 (触发 __toString)
echo $obj . "<br>";

// 7. 函数式调用 (触发 __invoke)
echo $obj("test") . "<br>";

// 8. 克隆 (触发 __clone)
$obj2 = clone $obj;

// 9. 判断存在性 (触发 __isset)
var_dump(isset($obj->aaa));

// 10. 删除属性 (触发 __unset)
unset($obj->aaa);