PHP中利用虚代理（Virtual Proxy）实现延迟加载

Ryan

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

原创

在PHP开发中，利用虚代理（Virtual Proxy）结合语言的动态特性，可以优雅地实现对象的延迟加载。本文将展示如何通过`VirtualProxy`类拦截成员访问，确保目标对象仅在真正被需要时才实例化。

结果与目标

通过本方案，您可以在创建大型对象（如领域实体、数据库映射结果集）时，不立即执行昂贵的初始化操作（如SQL查询、文件读取）。只有当代码首次尝试获取属性或调用方法时，后台才会自动触发加载逻辑。这种机制是“按需加载”的典型实现，有助于优化应用启动速度和内存使用。

准备条件

PHP运行时环境（支持闭包/Closure）。
理解PHP的魔术方法：__get（属性读取）、__set（属性赋值）、__call（方法调用）。
知道虚代理仅能代理对象类型，无法直接代理标量基本类型（如int, string）。

真实操作顺序

第1步：定义虚拟代理核心类

目的：创建一个占位符类，该类的唯一职责是在第一次被访问时调用传入的Loader回调来生成真实的内部对象。

关键逻辑： 1. 构造函数接收一个 Closure $loader，用于存储加载真实对象的逻辑。 2. 使用私有变量 $holder 缓存已生成的真实对象。
3. 实现 check() 私有方法，判断 $holder 是否为空，若为空则执行 $loader 并赋值。

class VirtualProxy
{
    private $holder = null;
    private $loader = null;

    /**
     * 构造器接收加载闭包
     */
    public function __construct(Closure $loader)
    {
        $this->loader = $loader;
    }

    /**
     * 检查是否已加载真实对象，未加载则触发加载
     */
    private function check()
    {
        if (null == $this->holder) {
            $loader = $this->loader;
            $this->holder = $loader();
        }
    }
}

第2步：实现魔术方法以拦截外部访问

目的：让外界对虚拟代理对象的任何属性读写或方法调用，都先经过 `check()` 确认真实对象存在，再转发给真实对象。

动作： 1. __call($method, $arguments)：拦截方法调用。校验真实对象是否存在该方法，通过后使用 `call_user_func_array` 转发调用。 2. __get($property)：拦截属性读取。校验真实对象是否包含该属性，通过后返回对应值。 3. __set($property, $value)：拦截属性写入。直接转发到真实对象。

    /**
     * 代理成员方法的调用
     */
    public function __call($method, array $arguments = null)
    {
        $this->check();
        if (!method_exists($this->holder, $method)) {
            throw new BadMethodCallException('Method not exists');
        }
        return call_user_func_array(
            array(&$this->holder, $method),
            $arguments
        );
    }

    /**
     * 代理成员属性的读取
     */
    public function __get($property)
    {
        $this->check();
        if (!isset($this->holder->$property)) {
            throw new ErrorException('Property not exists');
        }
        return $this->holder->$property;
    }

    /**
     * 代理成员属性的赋值
     */
    public function __set($property, $value)
    {
        $this->check();
        $this->holder->$property = $value;
    }

第3步：编写测试用例验证延迟效果

目的：演示如何使用闭包模拟耗时加载，并验证只有在访问属性/方法时才触发加载。

入口：新建一个实例，传入打印日志并返回数据的闭包。

// 测试：构建虚拟代理
$v = new VirtualProxy(function(){
    echo 'Now, Loading' . "\n"; // 只有此时才输出
    $a = new ArrayObject(range(1,100));
    $a->abc = 'a';
    // 实际使用中，这里通常是 DataMapper::findXXX()
    return $a;
});

// 此时尚未加载，不会输出 'Now, Loading'
echo 'Init Done.' . "\n";

// 访问属性，触发加载
echo $v->abc . $v->offsetGet(50);