11 Laravel控制器之控制器方法

在上一篇中，我们讨论了如何创建控制器，了解了控制器在Laravel中的基本框架和结构。这一篇我们将深入探讨控制器的方法，如何定义和使用它们，让我们的应用更具功能性。

控制器方法的定义

在 Laravel 中，控制器方法是处理请求的具体操作。每个控制器都可以包含多个方法，这些方法对应着执行特定的任务，比如返回视图、处理表单提交等。

创建控制器方法

假设我们已经创建了一个名为 UserController 的控制器，如下所示：

php artisan make:controller UserController

在这个控制器中，我们可以定义一些用来处理用户相关请求的方法。例如，我们可以创建一个 index 方法来显示所有用户：

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;

class UserController extends Controller
{
    public function index()
    {
        $users = User::all(); // 获取所有用户
        return view('users.index', compact('users')); // 返回视图
    }
}

这里的 index 方法从 User 模型获取所有用户并返回一个视图。compact('users') 函数将变量传递给视图。

处理请求与响应

除了简单的返回视图外，我们还可以处理不同类型的 HTTP 请求，使用 Request 类来接收和处理数据。例如，我们可以创建一个 store 方法来处理用户表单的提交：

public function store(Request $request)
{
    // 验证请求数据
    $validatedData = $request->validate([
        'name' => 'required|max:255',
        'email' => 'required|email|unique:users,email',
    ]);

    // 创建新用户
    $user = User::create($validatedData);

    // 重定向到用户列表页面
    return redirect()->route('users.index')->with('success', 'User created successfully.');
}

在此示例中，我们首先验证请求数据，如果验证通过，我们将创建新的用户。最后，通过 redirect 方法将用户重定向到列表页面，并带上成功消息。

方法的命名约定

Laravel 鼓励你使用适当的命名约定来命名控制器方法。以下是一些常见的方法命名约定：

• index：显示资源的列表。
• create：返回创建资源的表单。
• store：处理创建资源的表单提交。
• show：显示单个资源的详细信息。
• edit：返回编辑资源的表单。
• update：处理更新资源的表单提交。
• destroy：处理删除资源的请求。

这些命名约定可以帮助你更好地管理和理解代码结构。

示例：创建用户控制器完整代码

为了更好地理解控制器方法的用法，下面是一个简单的用户控制器示例，包含所有基本方法：

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;

class UserController extends Controller
{
    public function index()
    {
        $users = User::all();
        return view('users.index', compact('users'));
    }

    public function create()
    {
        return view('users.create');
    }

    public function store(Request $request)
    {
        $validatedData = $request->validate([
            'name' => 'required|max:255',
            'email' => 'required|email|unique:users,email',
        ]);

        User::create($validatedData);

        return redirect()->route('users.index')->with('success', 'User created successfully.');
    }

    public function show($id)
    {
        $user = User::findOrFail($id);
        return view('users.show', compact('user'));
    }

    public function edit($id)
    {
        $user = User::findOrFail($id);
        return view('users.edit', compact('user'));
    }

    public function update(Request $request, $id)
    {
        $validatedData = $request->validate([
            'name' => 'required|max:255',
            'email' => 'required|email|unique:users,email,'.$id,
        ]);

        User::where('id', $id)->update($validatedData);

        return redirect()->route('users.index')->with('success', 'User updated successfully.');
    }

    public function destroy($id)
    {
        User::destroy($id);

        return redirect()->route('users.index')->with('success', 'User deleted successfully.');
    }
}

在这个示例中，包含了创建、存储、显示、编辑、更新和删除用户的所有基本功能，展示了如何构建一个完整的控制器。

小结

通过控制器方法，Laravel 让我们可以很方便地处理请求和响应。我们可以根据不同的业务需求定义不同的控制器方法。控制器使得应用中的逻辑更加清晰和模块化。

在下一篇中，我们将探讨如何创建 资源控制器，它将进一步简化CRUD操作，减少代码重复，让我们的控制器更加简洁高效。