代理模式（Proxy）

目的

代理模式（Proxy）为其他对象提供一种代理以控制对这个对象的访问。使用代理模式创建代理对象，让代理对象控制目标对象的访问（目标对象可以是远程的对象、创建开销大的对象或需要安全控制的对象），并且可以在不改变目标对象的情况下添加一些额外的功能。

在某些情况下，一个客户不想或者不能直接引用另一个对象，而代理对象可以在客户端和目标对象之间起到中介的作用，并且可以通过代理对象去掉客户不能看到的内容和服务或者添加客户需要的额外服务。

经典例子就是网络代理，你想访问 Facebook 或者 Twitter ，如何绕过 GFW？找个代理网站。

例子

  • Doctrine2 使用代理来实现框架的“魔术”（例如：延迟加载），而用户仍然使用他们自己的实体类且不会使用到代理。

UML 图

file

代码

源代码在这里： GitHub

Record.php

  2. <?php
  4. namespace DesignPatterns\Structural\Proxy;
  6. /**
  7.  * @property 用户名
  8.  */
  9. class Record
  10. {
  11.     /**
  12.      * @var string[]
  13.      */
  14.     private $data;
  16.     /**
  17.      * @param string[] $data
  18.      */
  19.     public function __construct(array $data = [])
  20.     {
  21.         $this->data = $data;
  22.     }
  24.     /**
  25.      * @param string $name
  26.      * @param string  $value
  27.      */
  28.     public function __set(string $name, string $value)
  29.     {
  30.         $this->data[$name] = $value;
  31.     }
  33.     public function __get(string $name): string
  34.     {
  35.         if (!isset($this->data[$name])) {
  36.             throw new \OutOfRangeException('Invalid name given');
  37.         }
  39.         return $this->data[$name];
  40.     }
  41. }

RecordProxy.php

  2. <?php
  4. namespace DesignPatterns\Structural\Proxy;
  6. class RecordProxy extends Record
  7. {
  8.     /**
  9.      * @var bool
  10.      */
  11.     private $isDirty = false;
  13.     /**
  14.      * @var bool
  15.      */
  16.     private $isInitialized = false;
  18.     /**
  19.      * @param array $data
  20.      */
  21.     public function __construct(array $data)
  22.     {
  23.         parent::__construct($data);
  24.         // 当记录有数据的时候，将 initialized 标记为 true ，
  25.         // 因为记录将保存我们的业务逻辑，我们不希望在 Record 类里面实现这个行为
  26.         // 而是在继承了 Record 的代理类中去实现。
  27.         if (count($data) > 0) {
  28.             $this->isInitialized = true;
  29.             $this->isDirty = true;
  30.         }
  31.     }
  33.     /**
  34.      * @param string $name
  35.      * @param string  $value
  36.      */
  37.     public function __set(string $name, string $value)
  38.     {
  39.         $this->isDirty = true;
  41.         parent::__set($name, $value);
  42.     }
  44.     public function isDirty(): bool
  45.     {
  46.         return $this->isDirty;
  47.     }
  48. }

测试代码

  1. <?php
  3.     namespace DesignPatterns\Structural\Proxy\Tests;
  5.     use DesignPatterns\Structural\Proxy\Record;
  6.     use DesignPatterns\Structural\Proxy\RecordProxy;
  8.     class ProxyTest extends \PHPUnit_Framework_TestCase
  9.     {
  10.         public function testSetAttribute(){
  11.             $data = [];
  12.             $proxy = new RecordProxy($data);
  13.             $proxy->xyz = false;
  14.             $this->assertTrue($proxy->xyz===false);
  15.         }
  16.     }