はじめに

「コントローラとは？」という問いから、実際のコードをもとに、コントローラの役割とデータベース処理の分離について整理する。

コントローラとは何か？

結論から言えば、「リクエストに応じて実行する処理」のこと。
以下のコードで言えば、app/Routing/routes.php に定義された匿名関数がそれにあたる。

'path_1' => function (): HTMLRenderer {
  return new HTMLRenderer('view_1');
}

この匿名関数が、特定のリクエスト（例: /path_1）に対して、どのようなレスポンスを返すかを定義している。
つまり、「何をするか」を決める処理＝コントローラ。

コードに潜む問題点

次のように、ルート定義の中で直接SQLを扱う場合の問題点について考える。

'api/images/upload' => function (): JSONRenderer {
  $db = new MySQLWrapper();
  $stmt = $db->prepare("INSERT INTO images (image_name, unique_string) VALUES (?, ?)");
  $stmt->bind_param("ss", $imageName, $uniqueString);
  $stmt->execute();
  $stmt->close();
  $db->close();

  return new JSONRenderer([
    'uniqueString' => $uniqueString,
  ]);
}

このようにコントローラ内にデータベース処理が書かれている場合、データベースの種類や構造が変わったときに、すべてのコントローラを修正する必要がある。
この状態は、「密結合」と呼ばれ、保守性・再利用性が低くなる要因となる。

解決策：ヘルパー関数による責務の分離

データベースとのやり取りは、コントローラの外に切り出して、データアクセス層に委譲すべき。

メリット

コントローラは「何をしたいか」だけを書ける
データベースの種類が変わっても、データアクセス層の中だけを修正すればよい
テストがしやすくなる（モックによる差し替えが可能）

まとめ

コントローラとは「リクエストに対して実行する処理」を定義する場所
コントローラ内でデータベースを直接操作するのは密結合につながる
データアクセス処理はヘルパー関数や Repository に分離すべき
これにより、保守性・拡張性・テスト性の高い設計になる

おわりに

明日以降はDAOのコードを0から構築し、データアクセス層についての理解を深める。