Laravel 控制器基础与高级用法

在 Laravel 开发中，控制器（Controller） 是用于处理 HTTP 请求的重要部分，它将路由与业务逻辑分离，使代码更加清晰、可维护。通过控制器，我们可以高效地管理应用程序中的各种请求，提高开发效率。本文将详细介绍 Laravel 控制器的基础知识，并深入探讨高级用法，包括依赖注入、中间件、资源控制器以及 API 控制器等内容。

一、Laravel 控制器的作用与概念

在 Laravel 中，控制器的主要作用是 接收 HTTP 请求、处理业务逻辑，并返回响应。如果不使用控制器，我们需要在 routes/web.php 文件中编写大量闭包函数来处理请求，导致代码混乱且难以维护。控制器可以帮助我们将逻辑拆分到不同的类中，使代码更加模块化和清晰。

二、创建与使用控制器

2.1 创建控制器

Laravel 提供了 Artisan 命令行工具，可以通过以下命令创建控制器：

php artisan make:controller UserController

此命令将在 app/Http/Controllers/ 目录下生成 UserController.php 文件。打开该文件，我们可以看到控制器的基本结构：

namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller{    //}

此时，UserController 还没有具体的方法，我们需要手动添加。

2.2 定义控制器方法并绑定路由

控制器中的方法通常对应不同的 HTTP 请求。例如，我们可以在 UserController.php 中定义 index() 和 show() 方法：

namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller{    // 获取所有用户
    public function index()
    {        return "这是用户列表页面";
    }    // 根据 ID 显示用户信息
    public function show($id)
    {        return "查看用户 ID: " . $id;
    }
}

接着，我们需要在 routes/web.php 文件中定义路由，将请求映射到控制器方法：

use App\Http\Controllers\UserController;
Route::get('/users', [UserController::class, 'index']);
Route::get('/users/{id}', [UserController::class, 'show']);

这样，访问 /users 时，将调用 index() 方法，访问 /users/{id} 时，将调用 show() 方法。

三、高级控制器用法

3.1 控制器中的依赖注入

Laravel 允许在控制器方法中使用 依赖注入（Dependency Injection），可以直接注入 Request 对象或 Model 实例。例如：

use Illuminate\Http\Request;
use App\Models\User;
class UserController extends Controller{    
        public function store(Request $request)
    {        $name = $request->input('name');        
            return "接收到的用户名：" . $name;
    }    public function show(User $user)
    {        return response()->json($user);
    }
}

在 show(User $user) 方法中，Laravel 会根据传递的 ID 自动查找 User 模型并注入，无需手动查询数据库。

3.2 使用中间件

Laravel 的 中间件（Middleware） 允许在请求处理前后执行额外的操作，例如身份验证、日志记录等。可以在控制器中应用中间件：

public function __construct()
{    $this->middleware('auth');
}

这样，该控制器的所有方法都会受到 auth 中间件的保护，只有已认证的用户才能访问。

也可以为特定方法应用中间件：

public function profile()
{    $this->middleware('auth');    return "用户个人资料";
}

在 routes/web.php 中，我们需要确保使用了 auth 相关的路由中间件：

Route::get('/profile', [UserController::class, 'profile'])->middleware('auth');

3.3 资源控制器

如果我们的控制器用于 CRUD（创建、读取、更新、删除）操作，可以使用 Laravel 资源控制器（Resource Controller），它会自动生成标准的 RESTful 方法：

php artisan make:controller PostController --resource

生成的 PostController.php 具有以下 7 个方法：

public function index()      // 获取所有资源
public function create()     // 显示创建表单
public function store()      // 处理新建数据
public function show($id)    // 显示单个资源
public function edit($id)    // 显示编辑表单
public function update($id)  // 处理更新数据
public function destroy($id) // 删除资源

然后，我们可以在 routes/web.php 中使用 resource() 方法快速注册所有 RESTful 路由：

Route::resource('posts', PostController::class);

这样，访问 /posts 会自动调用 index() 方法，访问 /posts/{id} 会调用 show() 方法，极大简化了代码编写。

3.4 API 控制器

如果我们的应用是 API 服务，可以使用 --api 选项创建 API 控制器：

php artisan make:controller Api/UserController --api

与普通资源控制器不同，API 控制器不会生成 create() 和 edit() 方法，因为 API 通常不需要返回 HTML 表单。我们可以在 routes/api.php 中定义 API 路由：

Route::apiResource('users', Api\UserController::class);

此时，API 端点将以 JSON 格式返回数据，而不会渲染视图。

四、总结

通过控制器，我们可以将 Laravel 项目的路由逻辑与业务逻辑分离，使代码结构更加清晰。本文详细介绍了 Laravel 控制器的基础知识和高级用法，包括：

• 控制器的创建与使用

• 依赖注入的应用

• 控制器中使用中间件

• 资源控制器和 API 控制器的实现

掌握 Laravel 控制器的用法，可以让我们更高效地开发 Web 应用程序，提高代码的可维护性和可读性。在实际项目中，结合 服务提供者（Service Provider）、仓库模式（Repository Pattern） 等技术，可以进一步提升 Laravel 项目的结构和扩展性。