| この記事の要点 |
|
結論: まずはアンチパターンと知ること
「コントローラ A の中でコントローラ B のメソッドを呼びたい」という発想が出てきたら、設計を見直すサインです。Laravel/Symfony 系フレームワークでは、コントローラは「HTTP リクエストを受けて、レスポンスを返す薄い入口」として設計されており、コントローラ同士が呼び合う構造はテストが困難・依存が複雑・責務が肥大化します。
とはいえ、現実には「動いているものを今すぐ直したい」場面もあるので、まず実現方法を紹介し、その後で正しいリファクタリング方法を解説します。
方法1: app()->call() でコントローラを呼ぶ
Laravel のサービスコンテナ経由で別コントローラのアクションを呼び出せます:
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class OrderController extends Controller
{
public function store(Request $request)
{
// ユーザー登録処理を UserController に委譲
$userResponse = app()->call(
[UserController::class, 'store'],
['request' => $request]
);
// OrderController 固有の処理
// ...
return response()->json(['order_id' => 123]);
}
}
app()->call() はメソッドの型ヒントを自動解決してくれるので、Request も DI されます。
方法2: コンテナから解決して直接呼ぶ
class OrderController extends Controller
{
public function store(Request $request)
{
// インスタンス化(依存も自動注入)
$userController = app(UserController::class);
// メソッドを直接呼び出し
$result = $userController->store($request);
return $result;
}
}
方法3: コンストラクタインジェクション
class OrderController extends Controller
{
public function __construct(
private UserController $userController
) {}
public function store(Request $request)
{
$userResult = $this->userController->store($request);
// ...
}
}
なぜアンチパターンなのか
| 問題 | 具体的な症状 |
|---|---|
| 責務の肥大化 | コントローラがビジネスロジックを抱える「ファットコントローラ」化 |
| テストが困難 | コントローラ A をテストするのにコントローラ B もモック必要 |
| Request/Response 依存 | HTTP コンテキストがないと呼べないメソッドができる |
| 循環依存 | A→B→A と参照が回り、DI コンテナが破綻 |
| ルーティングと実装が乖離 | URL から到達不能なメソッドが増える |
正解: Service クラスに抽出する
コントローラ A と B で共通したい処理は、Service クラスとして独立させ、両方のコントローラから DI します。
Before: コントローラ呼び出し
// ❌ アンチパターン
class OrderController extends Controller
{
public function store(Request $r)
{
// ユーザー作成を UserController に依存
$user = app(UserController::class)->store($r);
// ...
}
}
After: Service 抽出
// app/Services/UserService.php
namespace App\Services;
use App\Models\User;
class UserService
{
public function create(array $data): User
{
return User::create([
'name' => $data['name'],
'email' => $data['email'],
'password' => bcrypt($data['password']),
]);
}
}
// app/Http/Controllers/UserController.php
class UserController extends Controller
{
public function __construct(private UserService $userService) {}
public function store(Request $request)
{
$user = $this->userService->create($request->validated());
return response()->json($user);
}
}
// app/Http/Controllers/OrderController.php
class OrderController extends Controller
{
public function __construct(private UserService $userService) {}
public function store(Request $request)
{
// ユーザー作成
$user = $this->userService->create($request->only(['name','email','password']));
// 注文作成
// ...
return response()->json(['user' => $user, 'order_id' => 123]);
}
}
これで両方のコントローラは UserService に依存するだけになり、HTTP コンテキストに縛られず、テストも書きやすくなります。
方法4: 内部 HTTP リクエスト
マイクロサービス的に「あくまで HTTP 経由で叩きたい」場合:
use Illuminate\Support\Facades\Http;
class OrderController extends Controller
{
public function store(Request $request)
{
$response = Http::post(url('/api/users'), $request->all());
$user = $response->json();
// ...
}
}
注意: 内部 HTTP は シリアライズ/デシリアライズ/ネットワークスタックのオーバーヘッドが乗ります。同一プロセス内なら絶対にやめましょう。
関連: FormRequest と Middleware の活用
「コントローラ間で同じバリデーションをしたい」「同じ認可をしたい」のなら、コントローラを呼び合わなくても解決できます:
- FormRequest: バリデーションルールを再利用可能なクラスに
- Middleware: 認証/認可/ログ等の横断処理
- Policy: モデル単位の認可ロジック
- Event/Listener: 副作用処理(メール送信等)の分離
FAQ
Q: 既存のレガシーコードで Service 化が大変
A: まずは app(OtherController::class)->method() でつないでおき、テストを書きながら徐々に Service へ抽出するのが現実解。
Q: Resource Controller の index 等を内部で呼びたい
A: API 内部呼び出しは Service 経由でデータ取得し、別途 JsonResource で整形するのが推奨。
Q: Symfony / Rails でも同じ?
A: はい。Rails では Service Object パターン、Symfony では Service コンテナ + Application Service が同等の考え方です。
子ページはありません
同階層のページはありません
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09