ProLaboもくもく会#10

1. 中・大規模でLaravel導入するTips
KenjiroKubota@ProLaboもくもく会#10

2. Profile.
久保田 賢二朗
● PHP(Laravel/Phalcon)
● JavaScript(Vue.js,/Svelte)
● Golang(Echo/Goa)
● HHVM/Hack
kenjiro kubota

3. 2019/2/16(sat)

4. 弊社istyleでLaravel/Lumenを利用したアプリケーション
（GitHub調べ）
30-40くらい
そんな弊社でLaravelを利用する上で実践していることを紹介

5. View Composer

6. View Composerとは
プレゼンターやビューモデルのような振る舞いをする
テンプレートと値を紐付けるLaravelの機能

7. class ViewComposerServiceProvider extends ServiceProvider
{
public function register()
{
$view = $this->app->make('view');
$view->composer('welcome', AppHttpViewComposerUserComposer::class);
}
}
使い方
独自のServiceProviderを作成してconfig/app.phpに登録

8. use IlluminateViewView;
use IlluminateAuthAuthManager;
class UserComposer
{
private $auth;
public function __construct(AuthManager $authManager)
{
$this->auth = $authManager->guard('web');
}
public function compose(View $view)
{
$view->with([
'authUser' => $this->auth->user()
]);
}
}
AppHttpViewComposerUserComposer

9. {{ $userAuth->id }}
welcome.blade.php
※ 特定のテンプレートがレンダリングされる際にViewComposerが実行される
※ Composerの他にもViewインスタンス生成時に起動するView::Creatorもあるよ

10. Facade, Eloquentの禁止

11. 「Facade, Eloquent禁止」でググるとこの人が一番上に出てきます。（上司）
※中・大規模での話なので個人で作るアプリケーションなら自分も別にいいんじゃないかなという気持ち

12. Facadeとは
'aliases' => [
'App' => IlluminateSupportFacadesApp::class,
'Artisan' => IlluminateSupportFacadesArtisan::class,
'Auth' => IlluminateSupportFacadesAuth::class,
'Blade' => IlluminateSupportFacadesBlade::class,
'Broadcast' => IlluminateSupportFacadesBroadcast::class,
'Bus' => IlluminateSupportFacadesBus::class,
'Cache' => IlluminateSupportFacadesCache::class,
'Config' => IlluminateSupportFacadesConfig::class,
'Cookie' => IlluminateSupportFacadesCookie::class,
'Crypt' => IlluminateSupportFacadesCrypt::class,
'DB' => IlluminateSupportFacadesDB::class,
'Eloquent' => IlluminateDatabaseEloquentModel::class,
'Event' => IlluminateSupportFacadesEvent::class,
'File' => IlluminateSupportFacadesFile::class,
'Gate' => IlluminateSupportFacadesGate::class,
'Hash' => IlluminateSupportFacadesHash::class,
'Lang' => IlluminateSupportFacadesLang::class,
'Log' => IlluminateSupportFacadesLog::class,
'Mail' => IlluminateSupportFacadesMail::class,
'Notification' => IlluminateSupportFacadesNotification::class,
'Password' => IlluminateSupportFacadesPassword::class,
'Queue' => IlluminateSupportFacadesQueue::class,
'Redirect' => IlluminateSupportFacadesRedirect::class,
'Redis' => IlluminateSupportFacadesRedis::class,
'Request' => IlluminateSupportFacadesRequest::class,
'Response' => IlluminateSupportFacadesResponse::class,
config/app.php

13. ズラァ～～と並ぶエイリアスを、
どこからでもスタティックに飛び出しが可能な便利な機能
Request::input("name");
とか
Cache::get("user");
とかとか、

14. ファサードにはたくさんの利点があります。自分で取り込んだり、設定したりする必要があり、長くて覚えにくいクラス名を使わずに、
Laravelの機能を簡素で覚えやすい文法で使ってもらえます。
その上に、PHPの動的メソッドのユニークな使用方法のおかげで、簡単にテストができます。
しかしながら、ファサードの使用にはいくつか気をつけるべき点も存在します。ファサードの一番の危険性は、クラスの責任範囲の暴
走です。
ファサードはとても簡単に使用でき、依存注入も必要ないため、簡単にクラスが成長し続ける結果、一つのクラスで多くのファサード
が使われます。
依存注入を使用すれば、クラスが大きくなりすぎることに伴う、大きなコンストラクタの視覚的なフィードバックにより、この危険性は抑
制されます。
ですから、ファサードを使用するときは、クラスの責任範囲を小さくとどめるため、クラスサイズに特に注意をはらいましょう。
出典:https://readouble.com

15. protected $bootstrappers = [
IlluminateFoundationBootstrapLoadEnvironmentVariables::class,
IlluminateFoundationBootstrapLoadConfiguration::class,
IlluminateFoundationBootstrapHandleExceptions::class,
// IlluminateFoundationBootstrapRegisterFacades::class,
IlluminateFoundationBootstrapRegisterProviders::class,
IlluminateFoundationBootstrapBootProviders::class,
];
IlluminateFoundationHttpKernel
Facadeを呼べないアプリケーションになります。

16. Eloquentの禁止
これは単純に処理される SQLが追いにくいので、弊社では QueryBuilderやAura.Sqlを使って
素に近いSQLで書いてます。

17. LaravelAspect

18. LaravelAspectとは
https://github.com/ytake/Laravel-Aspect
導入方法はリポジトリ参照
これも先程登場した上司作のライブラリです。ぜひ使ってください。

19. use YtakeLaravelAspectAnnotationCacheable;
/**
* @Cacheable(cacheName="testing1",key={"#id","#value"})
* @param $id
* @param $value
* @return mixed
*/
public function namedMultipleKey($id, $value)
{
return $id;
}
アノテーションを利用して Cache！

20. use YtakeLaravelAspectAnnotationTransactional;
/**
* @Transactional("master")
*/
public function save(array $params)
{
return $this->eloquent->save($params);
}
トランザクションもアノテーションで！

21. ADR

22. ADRとは
Action Domain Responedrの頭文字からとった、 UIアーキテクチャパターンです。
MVC（Model View Controller）の派生パターンです。

23. ADRとは
この書籍でも紹介されている設計パターンです。
ご参考にどうぞ（宣伝）
好評発売中！

24. Model / Domain
View / Responder
Controller / Action

25. namespace AppHttpAction;
use AppHttpResponderIndexResponder;
final class IndexAction
{
public function __invoke(IndexResponder $responder): IndexResponder
{
return $responder;
}
}
チームのルールとして Controllerのメソッドを一個に制限してもよいですが、 Laravelなら以下のように制
約することができます。

26. /** @var Router $router */
$router = $this->app['router'];
$router->get('/', AppHttpActionIndexAction::class);
__invokeというマジックメソッドだけで表現するのでこれ以上メソッドを増やすことはできません。
また、Routerからの呼び出しは以下のようになります。

27. namespace AppHttpResponder;
use IlluminateViewFactory;
use IlluminateHttpResponse;
use IlluminateContractsSupportResponsable;
class IndexResponder implements Responsable
{
public function __construct( Factory $view)
{
$this->view = $view;
}
public function toResponse($request): Response
{
return new Response(
$this->view->make( 'welcome' ), 200
);
}
}
Responderの実装はLaravel5.5から追加されたResponsable Interfaceを実装することでスッキリか
けます。

28. if ($response instanceof Responsable) {
$response = $response->toResponse($request);
}
Responsable InterfaceのtoResponseメソッドはLaravelのRouterでコールされます。
ですので、toResponseメソッドでviewやjsonを返却することでResponderとして機能させることが可能
です。
IlluminateRoutingRouter

29. まとめ
中・大規模開発では制約や見通しの良さが重要です。
FacadeやEloquentを使わないことで記述が増えたり、 ADRで設計することでクラスは膨大にな
ります。
しかし、責務を分離することで細かくなったクラスはテストがしやすくなり、
なによりリーダブルになることと思います。
ご参考になれば！

30. スピーカー募集中！

31. thanks:)