为什么要在 Laravel 中实现存储库模式？-php教程-PHP中文网

Why Implement the Repository Pattern in Laravel?

Laravel 中的存储库模式简介

存储库模式是一种设计模式，用于管理数据访问逻辑并将其集中在一个地方。这种模式有助于将检索和保存数据的逻辑与业务逻辑分开，使代码库更加模块化、可重用和可测试。

在 Laravel 中，存储库模式可用于抽象与数据模型（如 Eloquent 模型）的交互，使您的代码随着应用程序的增长而变得更加灵活和可维护。

为什么使用存储库模式？

关注点分离：它将业务逻辑与数据访问逻辑分离，使代码更干净，更易于管理。
松耦合：通过抽象数据库访问逻辑，可以减少对特定 ORM（例如 Eloquent）的直接依赖，如果需要切换到不同的数据库，可以在将来更轻松地进行修改或存储引擎。
更好的测试：它使单元测试更容易，因为您可以在测试中模拟存储库，而不必担心数据库或 ORM。
DRY 原则：公共数据库查询可以在应用程序的不同部分重复使用，防止代码重复。

存储库模式的基本结构

存储库模式通常涉及三个组件：

存储库接口：定义如何访问数据的契约。
存储库实现：实现具有检索和操作数据逻辑的接口。
模型：你的数据模型，在 Laravel 中通常是 Eloquent 模型。

Laravel 中存储库模式的逐步实现

1.创建存储库接口

首先，定义接口，指定与数据交互的方法。

// app/Repositories/Contracts/UserRepositoryInterface.php
namespace App\Repositories\Contracts;

interface UserRepositoryInterface
{
    public function all();
    public function find($id);
    public function create(array $data);
    public function update($id, array $data);
    public function delete($id);
}

登录后复制

在此示例中，接口定义了用于操作用户数据的方法，如 all()、find()、create()、update() 和 delete()。

2.创建存储库实施

接下来，创建一个实现存储库接口的具体类。此类将包含与数据库交互的实际逻辑，通常使用 Eloquent 模型。

// app/Repositories/Eloquent/UserRepository.php
namespace App\Repositories\Eloquent;

use App\Models\User;
use App\Repositories\Contracts\UserRepositoryInterface;

class UserRepository implements UserRepositoryInterface
{
    protected $user;

    public function __construct(User $user)
    {
        $this->user = $user;
    }

    public function all()
    {
        return $this->user->all();
    }

    public function find($id)
    {
        return $this->user->findOrFail($id);
    }

    public function create(array $data)
    {
        return $this->user->create($data);
    }

    public function update($id, array $data)
    {
        $user = $this->find($id);
        $user->update($data);
        return $user;
    }

    public function delete($id)
    {
        $user = $this->find($id);
        return $user->delete();
    }
}

登录后复制

此实现使用 Eloquent 方法（all()、findOrFail()、create()、update()、delete()）与数据库交互。但是，使用此存储库的代码并不了解有关 Eloquent 的任何信息，这使得将来在必要时更容易更改底层数据源。

3.将存储库绑定到接口

Laravel 允许我们将接口绑定到具体类，这对于依赖注入很有用。您通常会在服务提供商处执行此操作。

// app/Providers/RepositoryServiceProvider.php
namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use App\Repositories\Contracts\UserRepositoryInterface;
use App\Repositories\Eloquent\UserRepository;

class RepositoryServiceProvider extends ServiceProvider
{
    public function register()
    {
        $this->app->bind(UserRepositoryInterface::class, UserRepository::class);
    }
}

登录后复制

在此示例中，每当请求 UserRepositoryInterface 时，Laravel 都会自动将其解析为 UserRepository 实现。

最后，在config/app.php文件中注册这个服务提供者：

'providers' => [
    // Other service providers...
    App\Providers\RepositoryServiceProvider::class,
],

登录后复制

4.在控制器中使用存储库

完成所有设置后，您现在可以将 UserRepositoryInterface 注入控制器并使用它来访问用户数据，而无需将代码与 Eloquent 紧密耦合。

// app/Http/Controllers/UserController.php
namespace App\Http\Controllers;

use App\Repositories\Contracts\UserRepositoryInterface;
use Illuminate\Http\Request;

class UserController extends Controller
{
    protected $userRepository;

    public function __construct(UserRepositoryInterface $userRepository)
    {
        $this->userRepository = $userRepository;
    }

    public function index()
    {
        $users = $this->userRepository->all();
        return response()->json($users);
    }

    public function show($id)
    {
        $user = $this->userRepository->find($id);
        return response()->json($user);
    }

    public function store(Request $request)
    {
        $user = $this->userRepository->create($request->all());
        return response()->json($user);
    }

    public function update(Request $request, $id)
    {
        $user = $this->userRepository->update($id, $request->all());
        return response()->json($user);
    }

    public function destroy($id)
    {
        $this->userRepository->delete($id);
        return response()->json(['message' => 'User deleted']);
    }
}

登录后复制

在这里，控制器现在只知道 UserRepositoryInterface，并不关心如何获取数据，从而提供了清晰的关注点分离。