PHP Academy · 课时

魔术方法概览

Q: 「魔术方法概览」这节课中我会学到什么？

学习 __toString、__get、__set 及其他 PHP 魔术方法。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 __toString、__get、__set 及其他 PHP 魔术方法。

魔术方法概览 是 CoddyKit 上的免费 PHP Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

简介：PHP 魔术方法

魔术方法是带有双下划线前缀的特殊 PHP 方法，会在特定情况下由 PHP 引擎自动触发。它们为对象行为提供了可插入的处理点。

核心概念

PHP 魔术方法的核心概念：

__toString() — 将对象转换为字符串
__get/__set/__isset/__unset — 拦截属性访问
__call/__callStatic — 拦截方法调用
__invoke() — 使对象可调用

__toString

示例：

<?php
class Money {
    public function __construct(
        private float  $amount,
        private string $currency
    ) {}

    public function __toString(): string {
        return number_format($this->amount, 2) . ' ' . $this->currency;
    }
}

$price = new Money(9.99, 'USD');
echo $price;            // 9.99 USD
echo 'Price: ' . $price; // Price: 9.99 USD

get 与 set

继续：

<?php
class DynamicObject {
    private array $data = [];

    public function __get(string $name): mixed {
        return $this->data[$name] ?? null;
    }

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

$obj = new DynamicObject();
$obj->name = 'Alice';
echo $obj->name;  // Alice

isset 与 unset

练习：

<?php
class Model {
    private array $attributes = [];

    public function __set(string $k, mixed $v): void { $this->attributes[$k] = $v; }
    public function __get(string $k): mixed { return $this->attributes[$k] ?? null; }
    public function __isset(string $k): bool { return isset($this->attributes[$k]); }
    public function __unset(string $k): void { unset($this->attributes[$k]); }
}

$m = new Model();
$m->email = 'a@b.com';
var_dump(isset($m->email));  // true
unset($m->email);
var_dump(isset($m->email));  // false

call 与 callStatic

深入理解：

<?php
class FluentQuery {
    private array $clauses = [];

    public function __call(string $name, array $args): static {
        $this->clauses[$name] = $args[0] ?? null;
        return $this;
    }

    public function toSql(): string {
        return 'SELECT * FROM '
            . ($this->clauses['from'] ?? 'unknown');
    }
}

echo (new FluentQuery())->from('users')->toSql();
// SELECT * FROM users

__invoke

高级用法：

<?php
class Multiplier {
    public function __construct(private float $factor) {}

    public function __invoke(float $value): float {
        return $value * $this->factor;
    }
}

$double = new Multiplier(2);
echo $double(5);   // 10
echo $double(21);  // 42

$funcs = [new Multiplier(2), new Multiplier(3)];
foreach ($funcs as $fn) echo $fn(4) . ' '; // 8 12

__clone

实际应用模式：

<?php
class Config {
    private array $data = [];

    public function set(string $k, mixed $v): self {
        $this->data[$k] = $v;
        return $this;
    }

    public function __clone() {
        // deep clone nested objects if needed
    }
}

$original = (new Config())->set('theme', 'dark');
$copy = clone $original;  // triggers __clone

__debugInfo

最佳实践：

<?php
class ApiClient {
    public function __construct(
        private string $baseUrl,
        private string $apiKey  // sensitive!
    ) {}

    public function __debugInfo(): array {
        return [
            'baseUrl' => $this->baseUrl,
            'apiKey'  => '***' . substr($this->apiKey, -4),  // mask key
        ];
    }
}

var_dump(new ApiClient('https://api.example.com', 'secret123'));
// Shows masked key

实用模式

通过一个实用模式，将 PHP 魔术方法的知识融会贯通。

常见问题

请避免在使用 PHP 魔术方法时犯以下常见错误：

使用 __toString()，让对象能够以有意义的形式输出
__get/__set 支持代理和装饰器模式
__invoke 使对象可以作为可调用对象使用（与 array_map 配合时很有用）
__debugInfo 可防止敏感数据出现在 var_dump 中

快速检查

哪个魔术方法可以让 PHP 对象像函数一样被调用？

回顾：PHP 魔术方法

您已经学习了 PHP 魔术方法。请记住以下要点：

使用 __toString()，让对象能够以有意义的形式输出
__get/__set 支持代理和装饰器模式
__invoke 使对象可以作为可调用对象使用（与 array_map 配合时很有用）
__debugInfo 可防止敏感数据出现在 var_dump 中

常见问题解答