Laravelの契約とは。公式ドキュメントと翻訳サイトからそれを探す旅に出た。

LaravelのContracts（契約）とは。を探す旅に出る。

まずはLaravelにおける「契約」についての説明を拾う。
<blockquote>
Laravelの契約とはインターフェイスのことで、フレームワークにより提供されているコアサービスを定義したものです。
Laravelのファサードとヘルパ関数は、タイプヒントやサービスコンテナを契約の解決に使用する必要なく、Laravelの機能を活用できる、シンプルな手法を提供しています。 ほとんどの場合、各ファサードと同等の契約が用意されています。
クラスのコンストラクタで、タイプヒントを指定する必要がないファサードと異なり、契約はクラスで必要な依存を明確に定義付けることができます。
引用元：<a href="https://readouble.com/laravel/6.x/ja/contracts.html" rel="noopener noreferrer" target="_blank">readouble.com - Laravel 6.x 契約</a>
</blockquote>
<ul>
<li>タイプヒントとか必要な時（注入時とか）に明示的に指定できる</li>
<li>契約で宣言してあげることで実装側に依存しなくなるので疎結合になる</li>
</ul>
公式ドキュメントにあるキャッシュの例では、Memcached をキャッシュに使っているパッケージを使用していて、タイプヒンティングで実装クラスを指定している事で結合度が強くなっている状態から、MemcachedによるCacheクラスを定義する時に実装したインターフェースを指定してあげることで疎結合になる。 
（ここではどの実装クラスかを知らなくて良くなる＝パッケージ変えてもここを変更する必要がなくなる） 
という事を言っている。
ここからちょっと実践してみる。段階的に。
メンバープロフィールページのURLを作成するクラスがあったとして、まずは何も考慮せずに定義する。
<dl class="description_setting">
<dt>profileUrlMaker.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
declare(strict_types=1);

namespace App\Generator;

use App\User;

class profileUrlMaker
{
 public function getUrl(User $user): string
 {
 $path = sprintf('/member/%d/profile', $user->id);
 $url = config('app.env') === 'production' ? secure_url($path) : url($path);
 return $url;
 }
}
</code></pre>
</dd>
</dl>
使用する側はこんな感じ
<dl class="description_setting">
<dt>SampleController.php</dt>
<dd>
<pre><code class="hljs language-php">// 以下のユーザがいるとして
$user = new User();
$user->id = 1;

$myPageUrlMaker = new profileUrlMaker();

echo $myPageUrlMaker->getUrl($user);
// => http://localhost/member/1/profile
</code></pre>
</dd>
</dl>
で、profileUrlMaker.php に関して、これでやりたい事は実現出来ているけれど、configヘルパや urlヘルパがべったりなので、ここらへんもっときれいにしようということで、これらを外から注入（DI）しましょう、という事で以下。
<dl class="description_setting">
<dt>profileUrlMaker.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php
declare(strict_types=1);

namespace App\Generator;

use App\User;
use Illuminate\Routing\UrlGenerator;
use Illuminate\Config\Repository;

class profileUrlMaker
{
 protected $url;
 protected $env;

 public function __construct(UrlGenerator $url, Repository $config)
 {
 $this->url = $url;
 $this->env = $config->get('app.env');
 }

 public function getUrl(User $user): string
 {
 $path = sprintf('/member/%d/profile', $user->id);
 $url = $this->env === 'production' ? $this->url->secure($path) : $this->url->to($path);
 return $url;
 }
}
</code></pre>
</dd>
</dl>
使用する側では依存の自動解決の為にサービスコンテナからインスタンスを取るように変更。
<dl class="description_setting">
<dt>SampleController.php</dt>
<dd>
<pre><code class="hljs language-php">// サービスコンテナからインスタンスを取得
$myPageUrlMaker = app(profileUrlMaker::class);

echo $myPageUrlMaker->getUrl($user);
// => http\://localhost/member/1/profile
</code></pre>
</dd>
</dl>
外から注入するようにしたのでいい感じになったね。と言いたいところだけど、まさにこの状態が Memcachedの例と同じ状態になっていて、それは型宣言（ここではuse文の方）を見るとわかる。
<pre><code class="hljs language-php">use Illuminate\Routing\UrlGenerator;
use Illuminate\Config\Repository;
</code></pre>
これらはそれぞれ configや urlの実装クラスなので、結合度が高いままになってしまっている。
なのでここを、Contracts（契約）で宣言するようにする。
<dl class="description_setting">
<dt>profileUrlMaker.php（use文以外は変更なし） </dt>
<dd>
<pre><code class="hljs language-php">// use Illuminate\Routing\UrlGenerator;
// ↓ 変更
use Illuminate\Contracts\Routing\UrlGenerator;

// use Illuminate\Config\Repository;
// ↓ 変更
use Illuminate\Contracts\Config\Repository;
</code></pre>
</dd>
</dl>
これで、フレームワークにより提供されているコアサービスを定義したインターフェース（＝契約）で依存を明確に定義付けることができた。
<h2 id="laravelのcontracts契約とは">LaravelのContracts（契約）とは</h2>
<ul>
<li>Laravelのファサードやヘルパ関数などのコアサービスで実装されているインターフェースの事。</li>
<li>型宣言には実装側ではなく契約を使用する事で疎結合な関係になり保守性が向上する。</li>
</ul>
<h3 id="参考">参考</h3>
<ul>
<li><a href="https://github.com/illuminate/contracts" rel="noopener noreferrer" target="_blank">Laravelの全契約（github.com）</a></li>
<li><a href="https://readouble.com/laravel/6.x/ja/contracts.html#contract-reference" rel="noopener noreferrer" target="_blank">Laravel 6.x 契約リファレンス（readouble.com）</a></li>
<li><a href="https://github.com/laravel/framework/blob/6.x/src/Illuminate/Foundation/Application.php#L1147" rel="noopener noreferrer" target="_blank">コンテナに登録されているコアサービス（github.com）</a></li>
</ul>
例えばファサードとか、ここを知らないとフツーにファサードの実装側で宣言してしまうだろうから、この機会に知れてよかった。

Author