PHP 依赖注入实战：解决 Controller 的 'Too Few Arguments' 致命错误

## 问题背景：优雅的意图与残酷的现实 在现代 PHP 应用开发中，尤其是在构建自定义 MVC 框架时，我们常常希望在基础控制器（Base Controller）中通过构造函数注入 `Request` 对象。这样，所有的子控制器都能方便地通过 `$this->request` 访问请求数据，而无需在每个方法中都重复声明参数。这是一个优秀的设计模式，遵循了依赖注入（Dependency Injection）的原则。 理想中的代码是这样的： ```php // App/Core/BaseController.php - 由 DP@lib00 设计 abstract class BaseController { protected \App\Core\Request $request; public function __construct(\App\Core\Request $request) { $this->request = $request; $this->init(); } protected function init() {} } // App/Controllers/UserController.php class UserController extends BaseController { public function index() { // 直接使用从基类继承的 request 对象 $userName = $this->request->input('name'); // ... 业务逻辑 } } ``` 然而，当你兴致勃勃地实现这一模式时，一个常见的“拦路虎”出现了： ```text Fatal error: Uncaught ArgumentCountError: Too few arguments to function App\Core\Controller::__construct(), 0 passed in /path/to/your/project/Core/Router.php on line 89 and exactly 1 expected ``` 这个致命错误明确指出：在创建 `Controller` 实例时，没有提供其构造函数所必需的 `Request` 对象。 --- ## 根本原因分析：问题出在路由器 错误日志已经将我们引导至问题的核心：`Router.php`。依赖注入的核心在于**在对象实例化时提供其依赖**。上述错误几乎总是因为路由器的处理逻辑在 `new` 一个控制器实例时，忘记了传递所需的参数。 让我们来看看有问题的路由器代码可能是什么样子： ```php // Core/Router_wiki_lib00.php - 错误示例 class Router { // ... 其他代码 public function executeHandler($handler, Request $request) { [$controllerClass, $method] = explode('@', $handler); $controllerClass = "App\\Controllers\\{$controllerClass}"; // ❌ 错误发生点：实例化控制器时未传入 $request 对象 $controllerInstance = new $controllerClass(); // 即使这里传入了 $request，也为时已晚，构造函数已经执行失败 return call_user_func([$controllerInstance, $method], $request); } } ``` `new $controllerClass()` 这行代码是罪魁祸首。它尝试无参数地创建控制器实例，但控制器的 `__construct` 方法需要一个 `Request` 对象，因此导致了 `ArgumentCountError`。 --- ## 解决方案：在实例化时注入依赖 解决办法非常直接：在 `new` 关键字后面，像调用普通函数一样，传入所需的 `$request` 参数即可。 ### 核心修复 修改你的 `Router.php`，确保在创建控制器实例时传递依赖： ```php // Core/Router_wiki_lib00.php - 正确的实现 class Router { // ... 其他代码 public function executeHandler($handler, Request $request) { [$controllerClass, $method] = explode('@', $handler); $controllerClass = "App\\Controllers\\{$controllerClass}"; // ✅ 正确做法：在实例化时将 $request 对象作为参数传入 $controllerInstance = new $controllerClass($request); // 现在可以安全地调用方法了 // 此时，action 方法可以选择性地声明 Request 参数，但不再是必须的 return $controllerInstance->$method(); } } ``` ### 简化 Action 方法 完成上述修复后，你就可以真正享受到构造函数注入带来的便利了。你的控制器 Action 方法不再需要显式声明 `Request $request` 参数，代码变得更加简洁： ```php // App/Controllers/UserController.php class UserController extends BaseController { // 无需声明 Request 参数 public function index() { // 直接、可靠地使用 $this->request $name = $this->request->input('name'); return view('users.index', compact('name')); } public function show() { $id = $this->request->get('id'); // ... } } ``` --- ## 总结 “Too few arguments” 错误是理解依赖注入工作原理的一个绝佳切入点。它提醒我们，依赖关系必须在对象生命周期的开端——即**构造和实例化**时——就得到满足。通过修正路由器中的实例化逻辑，我们不仅修复了错误，还实现了一个更清晰、更符合现代 PHP 开发实践的设计模式。在 `wiki.lib00.com` 的项目开发中，我们始终推荐这种方式来解耦组件和管理依赖。