Proxyパターン（プロキシ・パターン）は、構造に関するデザインパターン手法の１つで、主クラスの代理クラスを同一インターフェイスで実装する事で処理を委譲し、省リソース化や処理の取り回しを調整できる処理モデルです。

Proxyパターン - PHPデザインパターン

Proxy パターン（プロキシ・パターン）は、構造に関するデザインパターン手法の１つで、主クラスの代理クラスを同一インターフェイスで実装する事で処理を委譲し、省リソース化や処理の取り回しを調整できる処理モデルです。
Proxy パターンの基本的なクラス図は以下になります。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/142/c10cCIOQpyul00BCEcXG.png" width="600" height="315" alt="Proxy パターンクラス図"></div>
<h2 id="実装例">実装例</h2>
今回は、画像の読み込みと表示についてを Proxy パターンで実装します。 Proxy パターンにはいくつかのパターンがあり、その中でも VirtualProxy パターンと言われる手法になります。
画像を取り扱う機能を作成する際に最低限必要なものとして「画像名」「画像パス」「画像データ」あたりを操作する機能にします。
まずは画像情報を保有する Item クラスを作成します。
<dl class="description_setting">
<dt>App/Item/Image.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Item;

class Image
{
 private $name;
 private $path;

 public function __construct($name, $path)
 {
 $this->name = $name;
 $this->path = $path;
 }

 public function getName()
 {
 return $this->name;
 }

 public function getPath()
 {
 return $this->path;
 }
}
</code></pre>
</dd>
</dl>
画像名（題名）と画像パスを持つシンプルなものになっています。
次に Subject クラスです。インターフェイスを定義します。
<dl class="description_setting">
<dt>App/Interfaces/ImageInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Interfaces;

interface ImageInterface
{
 public function ImageInfo();
 public function ImageDisplay();
}
</code></pre>
</dd>
</dl>
<ul>
<li>ImageInfo() メソッドは、画像情報を出力します。</li>
<li>ImageDisplay() メソッドは、画像を表示します。</li>
</ul>
次は RealSubject クラスです。「本人」の役割を持つクラスです。
<dl class="description_setting">
<dt>App/Subject/RealImage.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Subject;

use App\Interfaces\ImageInterface;
use App\Item\Image;

class RealImage implements ImageInterface
{
 private $image;
 private $content;

 public function __construct(Image $image)
 {
 $this->image = $image;
 $this->content = base64_encode(file_get_contents($image->getPath()));
 }

 public function ImageInfo()
 {
 echo sprintf("画像名：%s&#x3C;br>画像パス：%s", $this->image->getName(), $this->image->getPath());
 }

 public function ImageDisplay()
 {
&#x3C;div class="img_wrap">&#x3C;img src='data:image/png;base64,%s' width='300' height='auto'>&#x3C;/div>", $this->content);
 }
}
</code></pre>
</dd>
</dl>
ここでは、コンストラクタで画像オブジェクトを受け取り、画像情報と、画像の実態の読み込みを行っています。
そして、インターフェイスを実装しています。 ImageInfo() メソッドでは画像情報の出力を、ImageDisplay() メソッドでは画像自体の表示を行っています。
最後に、Proxy クラスです。「代理人」の役割を持つクラスになります。
<dl class="description_setting">
<dt>App/Proxy/ProxyImage.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Proxy;

use App\Interfaces\ImageInterface;
use App\Item\Image;
use App\Subject\RealImage;

class ProxyImage implements ImageInterface
{
 private $image;

 public function __construct(Image $image)
 {
 $this->image = $image;
 }

 public function ImageInfo()
 {
 echo sprintf("画像名：%s&#x3C;br>画像パス：%s", $this->image->getName(), $this->image->getPath());
 }

 public function ImageDisplay()
 {
 $real = new RealImage($this->image);
 $real->ImageDisplay();
 }
}
</code></pre>
</dd>
</dl>
ここでのポイントは ImageDisplay() メソッドです。 RealImage オブジェクトをインスタンス化し、そこの ImageDisplay() メソッドを用いて画像表示を行っています。
実装が完了したので、クライアントから利用してみます。
<dl class="description_setting">
<dt>index.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

use App\Item\Image;
use App\Proxy\ProxyImage;

$image = new ProxyImage(new Image('サンプル画像', 'images/sample.jpg'));

// 画像情報の出力
$image->ImageInfo();

echo '&#x3C;hr>';

// 画像の表示
$image->ImageDisplay();
</code></pre>
</dd>
</dl>
結果は以下になります。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/142/Zb5JzQLVSvlXIKjq1Ai5.png" width="400" height="356" alt="PHP での Proxy パターン結果画面"></div>
これらが結局何なのかというと、結果で写っている画像は実は 12MB 弱ある大きな画像を読み込んでいます。
この時に RealSubject クラスでは、インスタンス化を行う際に画像データを読み込み表示に対応するので、大きなリソースを読み込む事で処理に時間がかかる事になり、それなりのサーバリソースも消費します。
これが、必ず画像を表示するような場面であれば Proxy パターンは不要ですが、もし画像の情報は必要だが画像の表示自体は不要である場面もある場合はどうでしょうか。その時は読み込む必要はありません。
その場合は VirtualProxy パターンを用いる事で、Proxy クラスでは画像データは読み込まずに処理する事ができ、処理にかかる時間やリソースを大幅に短縮できます。
実際に、クライアントコードの中の以下の部分
<pre><code class="hljs language-php">// 画像の表示
$image->ImageDisplay();
</code></pre>
これがある場合は処理完了までに２秒弱かかりますが、これが無い場合は一瞬で完了します。つまり画像表示が不要な場面であれば ProxyImage クラスで取り回した方が圧倒的に処理時間や消費リソースが少なくて済むのです。
<h2 id="まとめ">まとめ</h2>
実装例はつまりは遅延ロードであり、本人役のコア処理が「不要」な時こそ力を発揮するパターンですが、本当に必要になった時にそのリソースを読み込む事で処理を省力化する事が出来ます。 Proxy パターンはまさしくこういった手法も思想の１つとして持っています。「Proxy = 代理人」を用いる利点の１つです。
Proxy パターンには他にも「remote proxy パターン」「Protection Proxy パターン」「smart reference パターン」などがあるので是非試してみてください。

Proxy パターン（プロキシ・パターン）は、構造に関するデザインパターン手法の１つで、主クラスの代理クラスを同一インターフェイスで実装する事で処理を委譲し、省リソース化や処理の取り回しを調整できる処理モデルです。
Proxy パターンの基本的なクラス図は以下になります。
<div class="img_wrap"><img src="/images/posts/142/c10cCIOQpyul00BCEcXG.png" width="600" height="315" alt="Proxy パターンクラス図"></div>
<h2 id="実装例">実装例</h2>
今回は、画像の読み込みと表示についてを Proxy パターンで実装します。 Proxy パターンにはいくつかのパターンがあり、その中でも VirtualProxy パターンと言われる手法になります。
画像を取り扱う機能を作成する際に最低限必要なものとして「画像名」「画像パス」「画像データ」あたりを操作する機能にします。
まずは画像情報を保有する Item クラスを作成します。
<dl class="description_setting">
<dt>App/Item/Image.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Item;

class Image
{
 private $name;
 private $path;

 public function __construct($name, $path)
 {
 $this->name = $name;
 $this->path = $path;
 }

 public function getName()
 {
 return $this->name;
 }

 public function getPath()
 {
 return $this->path;
 }
}
</code></pre>
</dd>
</dl>
画像名（題名）と画像パスを持つシンプルなものになっています。
次に Subject クラスです。インターフェイスを定義します。
<dl class="description_setting">
<dt>App/Interfaces/ImageInterface.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Interfaces;

interface ImageInterface
{
 public function ImageInfo();
 public function ImageDisplay();
}
</code></pre>
</dd>
</dl>
<ul>
<li>ImageInfo() メソッドは、画像情報を出力します。</li>
<li>ImageDisplay() メソッドは、画像を表示します。</li>
</ul>
次は RealSubject クラスです。「本人」の役割を持つクラスです。
<dl class="description_setting">
<dt>App/Subject/RealImage.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Subject;

use App\Interfaces\ImageInterface;
use App\Item\Image;

class RealImage implements ImageInterface
{
 private $image;
 private $content;

 public function __construct(Image $image)
 {
 $this->image = $image;
 $this->content = base64_encode(file_get_contents($image->getPath()));
 }

 public function ImageInfo()
 {
 echo sprintf("画像名：%s&#x3C;br>画像パス：%s", $this->image->getName(), $this->image->getPath());
 }

 public function ImageDisplay()
 {
&#x3C;div class="img_wrap">&#x3C;img src='data:image/png;base64,%s' width='300' height='auto'>&#x3C;/div>", $this->content);
 }
}
</code></pre>
</dd>
</dl>
ここでは、コンストラクタで画像オブジェクトを受け取り、画像情報と、画像の実態の読み込みを行っています。
そして、インターフェイスを実装しています。 ImageInfo() メソッドでは画像情報の出力を、ImageDisplay() メソッドでは画像自体の表示を行っています。
最後に、Proxy クラスです。「代理人」の役割を持つクラスになります。
<dl class="description_setting">
<dt>App/Proxy/ProxyImage.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Proxy;

use App\Interfaces\ImageInterface;
use App\Item\Image;
use App\Subject\RealImage;

class ProxyImage implements ImageInterface
{
 private $image;

 public function __construct(Image $image)
 {
 $this->image = $image;
 }

 public function ImageInfo()
 {
 echo sprintf("画像名：%s&#x3C;br>画像パス：%s", $this->image->getName(), $this->image->getPath());
 }

 public function ImageDisplay()
 {
 $real = new RealImage($this->image);
 $real->ImageDisplay();
 }
}
</code></pre>
</dd>
</dl>
ここでのポイントは ImageDisplay() メソッドです。 RealImage オブジェクトをインスタンス化し、そこの ImageDisplay() メソッドを用いて画像表示を行っています。
実装が完了したので、クライアントから利用してみます。
<dl class="description_setting">
<dt>index.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

use App\Item\Image;
use App\Proxy\ProxyImage;

$image = new ProxyImage(new Image('サンプル画像', 'images/sample.jpg'));

// 画像情報の出力
$image->ImageInfo();

echo '&#x3C;hr>';

// 画像の表示
$image->ImageDisplay();
</code></pre>
</dd>
</dl>
結果は以下になります。
<div class="img_wrap"><img src="/images/posts/142/Zb5JzQLVSvlXIKjq1Ai5.png" width="400" height="356" alt="PHP での Proxy パターン結果画面"></div>
これらが結局何なのかというと、結果で写っている画像は実は 12MB 弱ある大きな画像を読み込んでいます。
この時に RealSubject クラスでは、インスタンス化を行う際に画像データを読み込み表示に対応するので、大きなリソースを読み込む事で処理に時間がかかる事になり、それなりのサーバリソースも消費します。
これが、必ず画像を表示するような場面であれば Proxy パターンは不要ですが、もし画像の情報は必要だが画像の表示自体は不要である場面もある場合はどうでしょうか。その時は読み込む必要はありません。
その場合は VirtualProxy パターンを用いる事で、Proxy クラスでは画像データは読み込まずに処理する事ができ、処理にかかる時間やリソースを大幅に短縮できます。
実際に、クライアントコードの中の以下の部分
<pre><code class="hljs language-php">// 画像の表示
$image->ImageDisplay();
</code></pre>
これがある場合は処理完了までに２秒弱かかりますが、これが無い場合は一瞬で完了します。つまり画像表示が不要な場面であれば ProxyImage クラスで取り回した方が圧倒的に処理時間や消費リソースが少なくて済むのです。
<h2 id="まとめ">まとめ</h2>
実装例はつまりは遅延ロードであり、本人役のコア処理が「不要」な時こそ力を発揮するパターンですが、本当に必要になった時にそのリソースを読み込む事で処理を省力化する事が出来ます。 Proxy パターンはまさしくこういった手法も思想の１つとして持っています。「Proxy = 代理人」を用いる利点の１つです。
Proxy パターンには他にも「remote proxy パターン」「Protection Proxy パターン」「smart reference パターン」などがあるので是非試してみてください。

Author