Wiki¶

コーディング規約¶

基本的に下記に書かれている一般的なベストプラクティスを適用する

https://github.com/alexeymezenin/laravel-best-practices/blob/master/japanese.md

• アーキテクチャは一般的なRESTで実装する
  ただし、Auth配下はLaravel Breezeによって自動生成されたもののため、このルールの適用外とする

• 外部APIサービスを利用するようなものなどはServiceクラスを作る

• 型定義を引数、プロパティ、戻り値に全て必ず記述する

• PHPDocにServiceクラスなどを作る際はメソッドなどはわかりやすいように説明を記述する

• テーブルに区分値がある場合はapp/Enums配下にEnumを作る

  • 例に既にいくつか作っているため参考にしてください
  • boolean型などの真偽値は定数を作らなくて良いです

• フロントエンドはスタイリングにtailwindcssを使う

  • Laravel Breezeに既に使われているため、統一する

• フロントエンドで動的な操作が必要になった場合、Alpine.js、複雑な操作はLivewireを利用する

  • jQueryは使わないこと、Alpine.js、またはLivewireで同等のことがより簡単な記述で実現ができます

• 共通のスタイルのみ外に出し、基本は直接bladeファイルにtailwindでスタイルを書いていく