Репозиторий в Laravel — зачем и когда?

Question

Репозиторий в Laravel используется для абстракции доступа к данным, инкапсулируя логику запросов к базе данных. Он полезен когда нужно отделить бизнес-логику от способа хранения данных или когда сложные запросы повторяются в разных местах приложения. Репозиторий упрощает тестирование, позволяя подменять реальную базу данных моками.

YeaHub · Accepted Answer

Паттерн Repository предоставляет уровень абстракции между бизнес-логикой и слоем данных, инкапсулируя всю логику работы с хранилищем данных.Зачем использовать репозиторииАбстракция доступа к даннымСкрывает детали реализации хранения данныхПозволяет легко менять источник данных (БД, API, файлы)Централизация логики запросовПовторное использование сложных запросовЕдиное место для модификации запросовclass UserRepository {
    public function findActiveUsers(): Collection {
        return User::where('active', true)
                   ->with('profile')
                   ->orderBy('created_at', 'desc')
                   ->get();
    }
    
    public function findUsersWithRecentActivity(int $days = 7): Collection {
        return User::whereHas('activities', function ($query) use ($days) {
            $query->where('created_at', '>=', now()->subDays($days));
        })->get();
    }
}Упрощение тестированияЛегко мокать репозитории в тестахИзоляция бизнес-логики от базы данных// Тестирование сервиса с моком репозитория
public function test_user_creation() {
    $userRepository = Mockery::mock(UserRepository::class);
    $userRepository->shouldReceive('create')
                   ->once()
                   ->andReturn(new User());
    
    $service = new UserService($userRepository);
    $result = $service->createUser(['name' => 'John']);
    
    $this->assertInstanceOf(User::class, $result);
}Когда использовать репозиторииСложные приложенияКогда запросы к базе данных сложные и повторяютсяПри необходимости легко менять реализацию храненияТестированиеКогда важна простота unit-тестированияДля изоляции тестов от базы данныхMultiple источники данныхКогда данные приходят из разных источниковПри интеграции с внешними APIРеализация репозитория в Laravelinterface UserRepositoryInterface {
    public function find(int $id): ?User;
    public function create(array $data): User;
    public function update(User $user, array $data): bool;
    public function delete(User $user): bool;
    public function findByEmail(string $email): ?User;
}

class EloquentUserRepository implements UserRepositoryInterface {
    public function find(int $id): ?User {
        return User::find($id);
    }
    
    public function create(array $data): User {
        return User::create($data);
    }
    
    // ... остальные методы
}

// Регистрация в Service Provider
$this->app->bind(UserRepositoryInterface::class, EloquentUserRepository::class);Когда репозитории не нужныПростые CRUD приложенияКогда запросы простые и не повторяютсяДля маленьких проектов с минимальной бизнес-логикойОграниченное время разработкиКогда overhead от создания репозиториев не оправданВыводРепозитории стоит использовать в сложных приложениях с насыщенной бизнес-логикой, где важны тестируемость и возможность легкой смены реализации доступа к данным.