主要ディレクトリの役割と「どこに何を書くか」

ディレクトリ構造は「地図」である

Laravelプロジェクトを開くと、たくさんのフォルダが並んでいます。これは散らかっているのではなく、「どんなコードをどこに置くか」を決めた地図です。この地図を覚えておくと、初めてのプロジェクトでも「認証処理ならこの辺」「DB定義ならここ」と当たりをつけられます。まさに前日に学んだ「規約」の実体です。

• app/ … アプリ本体のPHPコード。Model、Controller、業務ロジックなど。最もよく触る場所。
• routes/ … URLと処理の対応表。web.php(画面用)や api.php(API用)がある。
• database/ … DB関連。migrations(スキーマ定義)、seeders(初期データ)、factories(テスト用ダミー)。
• config/ … アプリの設定値。DB接続やメールなどの設定をまとめる。
• resources/ … ビューのテンプレート(views)や、コンパイル前のCSS・JS。
• public/ … 外部から直接アクセスされる入口。index.phpや画像などの公開ファイル。
• storage/ … ログ・アップロードファイル・キャッシュなど、アプリが書き出すファイル。
• tests/ … 自動テストのコード。

app/ の中はさらに役割で分かれる

最もよく触る app/ の中も、役割ごとにフォルダが分かれています。Modelは app/Models、Controllerは app/Http/Controllers、ミドルウェアは app/Http/Middleware に置く、というように、Day1で学んだMVCの各層がフォルダとして表現されています。

# 代表的な配置(抜粋)
app/
  Http/
    Controllers/   # コントローラ(司令塔)
    Middleware/    # ミドルウェア(関所)
    Requests/      # フォーム入力のバリデーション
  Models/          # モデル(データと業務ルール)
  Providers/       # アプリ起動時の初期設定
routes/
  web.php          # 画面用のルート
  api.php          # API用のルート
database/
  migrations/      # DBスキーマの定義(版管理される)
  seeders/         # 初期データ投入
config/            # 各種設定値
resources/views/   # Bladeテンプレート