フレームワークとの付き合い方 / how-to-use-framework

by shin1x1

Slide 1

Slide 1 text

フレームワークとの付き合い方 2019/02/16 Laravel JP Conference @shin1x1

Slide 2

Slide 2 text

なぜフレームワークを使うのか？ 2

Slide 3

Slide 3 text

楽をするため 3

Slide 4

Slide 4 text

楽をするために全力を尽くす [ 全体の労力を減らすために手間を惜しまない] プログラマーの三大美徳「怠惰」 4

Slide 5

Slide 5 text

楽をするために理解しやすく変更しやすいシステムにする利用できるものは使うテストを書く自動化するノウハウの共有 5

Slide 6

Slide 6 text

フレームワークで楽したい Web アプリケーション開発で便利なものが揃ってるベースとなる処理フロー HTTP の扱い、RDBMS 等のミドルウェア操作開発支援（テスト、データベースマイグレーション、デバッグ）適度な制約カスタマイズ無しで、そのままで使えるユーザが多いフレームワークは情報も多い 6

Slide 7

Slide 7 text

フレームワークとは 7

Slide 8

Slide 8 text

フレームワークとは How である汎用的であるライフタイムがある 8

Slide 9

Slide 9 text

フレームワークは How である What = アプリケーションとして実装すべきものドメイン、関心事、仕様 How = What をどの技術でどう実装するか HTTP 、RDBMS 、メール、KVS 等アプリケーションが主、フレームワークは従 9

Slide 10

Slide 10 text

フレームワークは汎用的である OSS フレームワークは、汎用のフレームワーク自分たちのアプリケーション専用のものではない要件に合うところは使い、合わないところは使わない 10

Slide 11

Slide 11 text

[ 例1] SQL を書くか問題複雑なクエリを Eloquent や QueryBuilder で書くのが大変 SQL を書いて、それを Eloquent のコードに書き戻す不毛感必要なら SQL 文を書く selectRaw() 、whereRaw() 、DB::statement() 等 Eloquent のメソッドに閉じて、局所化しておく 11

Slide 12

Slide 12 text

[ 例1] SQL 文を記述 Eloquent のメソッドに実装呼び出す側は、SQL 文が書かれているかは知らなくて良い public function findTargetOrders(array $itemIds): iterable { $sql = <<?) EOT; return $this->newQuery()->selectRaw($sql, $itemIds)->get(); } 12

Slide 13

Slide 13 text

[ 例2] 1 API だけを速度改善フレームワーク上で動く Web アプリケーションキャンペーンで、1 API のみアクセスが急増するオンプレミス環境で、スケールアウトが容易ではないチューニングは行ったが、フレームワークのボトルネック 13

Slide 14

Slide 14 text

[ 例2] API を Plain PHP で再実装フレームワークのボトルネックが解消されたのでアクセスを捌けた他の API や機能はフレームワークを利用したまま基本はフレームワーク実装、事情があれば外す 14

Slide 15

Slide 15 text

フレームワークはライフタイムがあるメジャーバージョンアップ対応に大きな工数がかかる問題アプリケーション仕様は変わってないのに！アプリケーションは意外に長生きするサービスは終わっても、コードが流用されることも要素技術は時代によって変わっていくフレームワーク、言語、アーキテクチャ（サーバーレスとかも） 15

Slide 16

Slide 16 text

フレームワークのアップグレードメジャーバージョンのアップグレードは意外に大変国内では、早くに流行した CakePHP で多く見られる Laravel も数年後には同じことが起こりうるインハウスフレームワークでも同様できる範囲で考えておきたい 16

Slide 17

Slide 17 text

1 から再実装すれば良いんじゃない？小さなアプリケーションなら良いが、実際はそんなに単純ではないリライトへの反論（レガシーソフトウェア改善ガイド）最初に明らかにしておくが、完全な書き直しは、ほとんど常によくないアイデアだと私は信じている。ビッグ・リライト（レガシーソフトウェア改善ガイド）ビッグ・リライトに挑戦するなら、他の選択肢をすべて試した後のことだと思いたい。 17

Slide 18

Slide 18 text

フレームワークと適切な距離を取る 18

Slide 19

Slide 19 text

フレームワークと適切な距離を取る利用するが過度に依存しないフレームワークに一蓮托生しないように主体的にフレームワークをコントロールする選択肢を残しておく [Clean Architecture 達人に学ぶソフトウェアの構造と設計] 19

Slide 20

Slide 20 text

[ 例3] 独自ディレクトリに実装アプリケーションを独自ディレクトリに実装 namespace も独自に定める app ディレクトリには必要最低限のみ記述設定ルーティングサービスコンテナエラーハンドラ 20

Slide 21

Slide 21 text

[ 例3] 独自ディレクトリに実装 app/ # <--- Laravel アプリケーションディレクトリ（必要最低限のみ） packages/ # <--- 独自ディレクトリ Acme/ Point/ Controller/ Model/ Service/ Test/ 21

Slide 22

Slide 22 text

[ 例3] 独自 namespace composer.json に設定ルーティングで独自 namespace を見るように設定 app/Providers/RouteServiceProvider.php //protected $namespace = 'App\Http\Controllers'; protected $namespace = ''; // 空文字にする routes/(api|web).php use App\Http\Actions\AddPoint\AddPointAction; $router->put('/customers/add_point', AddPointAction::class); 22

Slide 23

Slide 23 text

[ 例4] アプリケーションのレイヤを分けるコントローラ（Action 等）とアプリケーションロジックを分離コントローラはフレームワークと密結合になりがちアプリケーションロジックは、別レイヤで実装サービスレイヤ、ドメインレイヤ等コントローラは、このレイヤの処理を呼ぶのみレイヤによる責務（役割）を抑える 23

Slide 24

Slide 24 text

[ 例4] レイヤ分けのバリエーション MVC + サービスレイヤ DDD スタイルアーキテクチャレイヤードアーキテクチャクリーンアーキテクチャ独立したコアレイヤパターン 24

Slide 25

Slide 25 text

サービスレイヤ https://www.slideshare.net/shin1x1/php-ver2-52828655 25

Slide 26

Slide 26 text

DDD スタイルレイヤードアーキテクチャ https://speakerdeck.com/shin1x1/201703-ddd-with-laravel 26

Slide 27

Slide 27 text

独立したコアレイヤパターン https://speakerdeck.com/shin1x1/independent-core-layer-pattern- phpconsen2019 27

Slide 28

Slide 28 text

事例: Laravel アップグレード Laravel 4.2 + PHP 5.6 から Laravel 5.5 + PHP 7.2 業務アプリケーション（SPA ）入力フォーム、集計、帳票独自ディレクトリ構成サービスレイヤを追加し、アプリケーションロジックを実装サービスレイヤは、Eloquent と密結合 28

Slide 29

Slide 29 text

事例: Laravel アップグレード独自ディレクトリは、そのままコピー設定やコントローラ周りは大きく変更サービスレイヤは、Eloquent に起因する箇所のみ変更 Eloquent の変更も少なめだったので助かった分離していたおかげで、スムーズに進んだテスト万歳！ 29

Slide 30

Slide 30 text

さいごに 30

Slide 31

Slide 31 text

フレームワークとの付き合い方楽するためにフレームワークを使うフレームワークをコントロールする主体的に技術を選ぶ、使う 31

Slide 32

Slide 32 text

Q? @shin1x1 32