TemplateMethodパターンは、スーパー（基底）クラスとして定義されたメソッドをサブクラスで継承し、1つの処理モデルを構築するパターンです。パターン名からきている通り、テンプレート＝共通の処理を定義したスーパークラスをそれぞれのサブクラスたちが継承し、継承元から与えられたそれぞれの機能を実装し、さらにそのクラス独自の処理を実装することで、それぞれが１つの完成形となります。

TemplateMethodパターン | PHPデザインパターン

TemplateMethod パターンは、スーパー（基底）クラスとして定義されたメソッドをサブクラスで継承し、1 つの処理モデルを構築するパターンです。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/117/YzXXbHpUBOVbHflMkQad.png" width="600" height="315" alt="TemplateMethod パターンクラス図"></div>
パターン名からきている通り、テンプレート＝共通の処理を定義したスーパークラスをそれぞれのサブクラスたちが継承し、継承元から与えられたそれぞれの機能を実装し、さらにそのクラス独自の処理を実装することで、それぞれが１つの完成形となります。
<h2 id="実装例">実装例</h2>
例として車で考えてみます。
車にはたくさんの車種がありますが、「ハンドル（左右・クラクション）」「アクセル（進む）」「ブレーキ（止まる）」の機能に関してはどの車も持っている共通のものです。
また、「エンジン」「ボディ」「内装」というのももちろん全ての車にあるものですが、これらは車種によってスペックや材質が違ったりします。
そして、車種によって、その車にしかない装備や機能などもあったありします。
これらを TemplateMethod パターンで実装してみます。
<h2 id="スーパー基底クラス">スーパー（基底）クラス</h2>
まずはスーパークラスです。ここには、全車種に共通の機能や、車種によって中身が違うけれど、共通のものとして持っておくべき機能を定義します。
<pre><code class="hljs language-php">&#x3C;?php

abstract class Car
{
 /**
 * ハンドル
 * @return array
 */
 public function handle()
 {
 return ['right', 'left', 'horn'];
 }

 /**
 * アクセル
 * @return string
 */
 public function accelerator()
 {
 return 'move on!';
 }

 /**
 * ブレーキ
 * @return string
 */
 public function brake()
 {
 return 'stop';
 }

 // タイプ
 protected abstract function type();
 // エンジン
 protected abstract function engine();
 // ボディ
 protected abstract function body();
 // 内装
 protected abstract function interior();
}
</code></pre>
ハンドル・アクセス・ブレーキに関しては、全車種で同じ機能なので、ここで処理を定義しています。
一方、共通で持っている機能だけれど、車種によって違うものはサブクラスで定義するものとしてメソッドの宣言のみを行っています。
ちなみに、abstract で宣言されたメソッドは、継承先であるサブクラスでは必ず実装しなければいけないメソッドになります。（実装しなければエラーになります）
これで車の基底クラスが出来ました。
<h2 id="サブクラス">サブクラス</h2>
次に、これらを継承してサブクラスを定義していきます。
<pre><code class="hljs language-php">&#x3C;?php

class MyCarNomal extends Car
{
 public function type()
 {
 return 'ノーマル';
 }

 public function engine()
 {
 return '直列4気筒DOHC';
 }

 public function body()
 {
 return 'Basic';
 }

 public function interior()
 {
 return 'white';
 }
}

class MyCarSports extends Car
{
 public function type()
 {
 return 'スポーツ';
 }

 public function engine()
 {
 return 'V8ターボ';
 }

 public function body()
 {
 return 'carbon';
 }

 public function interior()
 {
 return 'red';
 }

 public function wing()
 {
 return 'GTウイング';
 }
}

class MyCarLuxury extends Car
{
 public function type()
 {
 return 'ラグジュアリー';
 }

 public function engine()
 {
 return '3.0L直列6気筒ターボ';
 }

 public function body()
 {
 return 'Fiber reinforced plastic'; // 繊維強化プラスチック
 }

 public function interior()
 {
 return 'black';
 }

 public function sunroof()
 {
 return 'サンルーフ';
 }
}
</code></pre>
ここでは、３つのサブクラスを定義しています。それぞれ「ノーマルカー」「スポーツカー」「ラグジュアリーカー」の３つです。
最初に定義したスーパークラスをそれぞれのサブクラスが継承（extends）しています。
サブクラスでは、基底クラスで宣言したメソッドをそれぞれのサブクラスで定義し、それ以外に、各々のクラス独自の機能（メソッド）を実装しています。
<h2 id="動作確認">動作確認</h2>
これで一連の実装が完了したので、インスタンス化を行い、出力を行います。
<pre><code class="hljs language-php">&#x3C;?php

$normal = new MyCarNomal();
echo "タイプ：" . $normal->type() . "&#x3C;br>";
echo "エンジン：" . $normal->engine() . "&#x3C;br>";
echo "アクセル：" . $normal->accelerator() . "&#x3C;br>&#x3C;br>";

$sports = new MyCarSports();
echo "タイプ：" . $sports->type() . "&#x3C;br>";
echo "エンジン：" . $sports->engine() . "&#x3C;br>";
echo "アクセル：" . $sports->accelerator() . "&#x3C;br>";
echo "独自装備：" . $sports->wing() . "&#x3C;br>&#x3C;br>";

$luxury = new MyCarLuxury();
echo "タイプ：" . $luxury->type() . "&#x3C;br>";
echo "エンジン：" . $luxury->engine() . "&#x3C;br>";
echo "アクセル：" . $luxury->accelerator() . "&#x3C;br>";
echo "独自装備：" . $luxury->sunroof() . "&#x3C;br>&#x3C;br>";
</code></pre>
実際にブラウザで確認すると、以下のように表示されます。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/117/lXlP3e8I22zF98gqVjW5.png" width="381" height="494" alt="ブラウザから TemplateMethod パターンの出力表示"></div>
<ul>
<li>スーパークラスで定義した、共通機能である「アクセル」</li>
<li>スーパークラスで宣言しサブクラスで定義した、共通要素である「タイプ」「エンジン」</li>
<li>サブクラスで定義した、独自要素である「独自機能」</li>
</ul>
TemplateMethod パターンによって、これらの処理を実装できました。
<h2 id="まとめ">まとめ</h2>
TemplateMethod パターンを用いれば、共通処理をまとめる事ができ、それを使ってサブクラスで複数の処理モデルを作成する事が出来ます。機能の変更や追加の際も最少の記述で済むので、効率良く開発を進めていく事が出来ます。
Laravel や CakePHP などの PHP フレームワークでも、自身で作成するコントローラには AppController が継承されていたりと、結構目に触れるところでも使われているので見てみてください。

TemplateMethod パターンは、スーパー（基底）クラスとして定義されたメソッドをサブクラスで継承し、1 つの処理モデルを構築するパターンです。
<div class="img_wrap"><img src="/images/posts/117/YzXXbHpUBOVbHflMkQad.png" width="600" height="315" alt="TemplateMethod パターンクラス図"></div>
パターン名からきている通り、テンプレート＝共通の処理を定義したスーパークラスをそれぞれのサブクラスたちが継承し、継承元から与えられたそれぞれの機能を実装し、さらにそのクラス独自の処理を実装することで、それぞれが１つの完成形となります。
<h2 id="実装例">実装例</h2>
例として車で考えてみます。
車にはたくさんの車種がありますが、「ハンドル（左右・クラクション）」「アクセル（進む）」「ブレーキ（止まる）」の機能に関してはどの車も持っている共通のものです。
また、「エンジン」「ボディ」「内装」というのももちろん全ての車にあるものですが、これらは車種によってスペックや材質が違ったりします。
そして、車種によって、その車にしかない装備や機能などもあったありします。
これらを TemplateMethod パターンで実装してみます。
<h2 id="スーパー基底クラス">スーパー（基底）クラス</h2>
まずはスーパークラスです。ここには、全車種に共通の機能や、車種によって中身が違うけれど、共通のものとして持っておくべき機能を定義します。
<pre><code class="hljs language-php">&#x3C;?php

abstract class Car
{
 /**
 * ハンドル
 * @return array
 */
 public function handle()
 {
 return ['right', 'left', 'horn'];
 }

 /**
 * アクセル
 * @return string
 */
 public function accelerator()
 {
 return 'move on!';
 }

 /**
 * ブレーキ
 * @return string
 */
 public function brake()
 {
 return 'stop';
 }

 // タイプ
 protected abstract function type();
 // エンジン
 protected abstract function engine();
 // ボディ
 protected abstract function body();
 // 内装
 protected abstract function interior();
}
</code></pre>
ハンドル・アクセス・ブレーキに関しては、全車種で同じ機能なので、ここで処理を定義しています。
一方、共通で持っている機能だけれど、車種によって違うものはサブクラスで定義するものとしてメソッドの宣言のみを行っています。
ちなみに、abstract で宣言されたメソッドは、継承先であるサブクラスでは必ず実装しなければいけないメソッドになります。（実装しなければエラーになります）
これで車の基底クラスが出来ました。
<h2 id="サブクラス">サブクラス</h2>
次に、これらを継承してサブクラスを定義していきます。
<pre><code class="hljs language-php">&#x3C;?php

class MyCarNomal extends Car
{
 public function type()
 {
 return 'ノーマル';
 }

 public function engine()
 {
 return '直列4気筒DOHC';
 }

 public function body()
 {
 return 'Basic';
 }

 public function interior()
 {
 return 'white';
 }
}

class MyCarSports extends Car
{
 public function type()
 {
 return 'スポーツ';
 }

 public function engine()
 {
 return 'V8ターボ';
 }

 public function body()
 {
 return 'carbon';
 }

 public function interior()
 {
 return 'red';
 }

 public function wing()
 {
 return 'GTウイング';
 }
}

class MyCarLuxury extends Car
{
 public function type()
 {
 return 'ラグジュアリー';
 }

 public function engine()
 {
 return '3.0L直列6気筒ターボ';
 }

 public function body()
 {
 return 'Fiber reinforced plastic'; // 繊維強化プラスチック
 }

 public function interior()
 {
 return 'black';
 }

 public function sunroof()
 {
 return 'サンルーフ';
 }
}
</code></pre>
ここでは、３つのサブクラスを定義しています。それぞれ「ノーマルカー」「スポーツカー」「ラグジュアリーカー」の３つです。
最初に定義したスーパークラスをそれぞれのサブクラスが継承（extends）しています。
サブクラスでは、基底クラスで宣言したメソッドをそれぞれのサブクラスで定義し、それ以外に、各々のクラス独自の機能（メソッド）を実装しています。
<h2 id="動作確認">動作確認</h2>
これで一連の実装が完了したので、インスタンス化を行い、出力を行います。
<pre><code class="hljs language-php">&#x3C;?php

$normal = new MyCarNomal();
echo "タイプ：" . $normal->type() . "&#x3C;br>";
echo "エンジン：" . $normal->engine() . "&#x3C;br>";
echo "アクセル：" . $normal->accelerator() . "&#x3C;br>&#x3C;br>";

$sports = new MyCarSports();
echo "タイプ：" . $sports->type() . "&#x3C;br>";
echo "エンジン：" . $sports->engine() . "&#x3C;br>";
echo "アクセル：" . $sports->accelerator() . "&#x3C;br>";
echo "独自装備：" . $sports->wing() . "&#x3C;br>&#x3C;br>";

$luxury = new MyCarLuxury();
echo "タイプ：" . $luxury->type() . "&#x3C;br>";
echo "エンジン：" . $luxury->engine() . "&#x3C;br>";
echo "アクセル：" . $luxury->accelerator() . "&#x3C;br>";
echo "独自装備：" . $luxury->sunroof() . "&#x3C;br>&#x3C;br>";
</code></pre>
実際にブラウザで確認すると、以下のように表示されます。
<div class="img_wrap"><img src="/images/posts/117/lXlP3e8I22zF98gqVjW5.png" width="381" height="494" alt="ブラウザから TemplateMethod パターンの出力表示"></div>
<ul>
<li>スーパークラスで定義した、共通機能である「アクセル」</li>
<li>スーパークラスで宣言しサブクラスで定義した、共通要素である「タイプ」「エンジン」</li>
<li>サブクラスで定義した、独自要素である「独自機能」</li>
</ul>
TemplateMethod パターンによって、これらの処理を実装できました。
<h2 id="まとめ">まとめ</h2>
TemplateMethod パターンを用いれば、共通処理をまとめる事ができ、それを使ってサブクラスで複数の処理モデルを作成する事が出来ます。機能の変更や追加の際も最少の記述で済むので、効率良く開発を進めていく事が出来ます。
Laravel や CakePHP などの PHP フレームワークでも、自身で作成するコントローラには AppController が継承されていたりと、結構目に触れるところでも使われているので見てみてください。

Author