Я заканчиваю большой проект с использованием Laravel 4 и должен отвечать на все вопросы, которые вы задаете прямо сейчас. Прочитав все доступные книги Laravel в Leanpub и тонны Googling, я придумал следующую структуру.

• Один класс Eloquent Model для каждой доступной таблицы
• Один класс репозитория для Eloquent Model
• Класс службы, который может связываться между несколькими классами репозитория.

Итак, скажем, я создаю базу данных фильмов. У меня были бы, по крайней мере, следующие классы класса Eloquent Model:

• Фильм
• Студия
• директор
• Actor
• Обзор

Класс репозитория будет инкапсулировать каждый класс Eloquent Model и отвечать за операции CRUD в базе данных. Классы репозитория могут выглядеть следующим образом:

• MovieRepository
• StudioRepository
• DirectorRepository
• ActorRepository
• ReviewRepository

Каждый класс репозитория расширяет класс BaseRepository, который реализует следующий интерфейс:

interface BaseRepositoryInterface
{
    public function errors();

    public function all(array $related = null);

    public function get($id, array $related = null);

    public function getWhere($column, $value, array $related = null);

    public function getRecent($limit, array $related = null);

    public function create(array $data);

    public function update(array $data);

    public function delete($id);

    public function deleteWhere($column, $value);
}

Класс службы используется для склеивания нескольких репозиториев и содержит реальную "бизнес-логику" приложения. Контроллеры только взаимодействуют с классами Service для создания, обновления и удаления.

Поэтому, когда я хочу создать новую запись Movie в базе данных, мой класс MovieController может иметь следующие методы:

public function __construct(MovieRepositoryInterface $movieRepository, MovieServiceInterface $movieService)
{
    $this->movieRepository = $movieRepository;
    $this->movieService = $movieService;
}

public function postCreate()
{
    if( ! $this->movieService->create(Input::all()))
    {
        return Redirect::back()->withErrors($this->movieService->errors())->withInput();
    }

    // New movie was saved successfully. Do whatever you need to do here.
}

Это зависит от вас, чтобы определить, как вы используете POST-данные для своих контроллеров, но пусть говорят, что данные, возвращаемые Input:: all() в методе postCreate(), выглядят примерно так:

$data = array(
    'movie' => array(
        'title'    => 'Iron Eagle',
        'year'     => '1986',
        'synopsis' => 'When Doug\ father, an Air Force Pilot, is shot down by MiGs belonging to a radical Middle Eastern state, no one seems able to get him out. Doug finds Chappy, an Air Force Colonel who is intrigued by the idea of sending in two fighters piloted by himself and Doug to rescue Doug\ father after bombing the MiG base.'
    ),
    'actors' => array(
        0 => 'Louis Gossett Jr.',
        1 => 'Jason Gedrick',
        2 => 'Larry B. Scott'
    ),
    'director' => 'Sidney J. Furie',
    'studio' => 'TriStar Pictures'
)

Поскольку MovieRepository не должен знать, как создавать записи Actor, Director или Studio в базе данных, мы будем использовать наш класс MovieService, который может выглядеть примерно так:

public function __construct(MovieRepositoryInterface $movieRepository, ActorRepositoryInterface $actorRepository, DirectorRepositoryInterface $directorRepository, StudioRepositoryInterface $studioRepository)
{
    $this->movieRepository = $movieRepository;
    $this->actorRepository = $actorRepository;
    $this->directorRepository = $directorRepository;
    $this->studioRepository = $studioRepository;
}

public function create(array $input)
{
    $movieData    = $input['movie'];
    $actorsData   = $input['actors'];
    $directorData = $input['director'];
    $studioData   = $input['studio'];

    // In a more complete example you would probably want to implement database transactions and perform input validation using the Laravel Validator class here.

    // Create the new movie record
    $movie = $this->movieRepository->create($movieData);

    // Create the new actor records and associate them with the movie record
    foreach($actors as $actor)
    {
        $actorModel = $this->actorRepository->create($actor);
        $movie->actors()->save($actorModel);
    }

    // Create the director record and associate it with the movie record
    $director = $this->directorRepository->create($directorData);
    $director->movies()->associate($movie);

    // Create the studio record and associate it with the movie record
    $studio = $this->studioRepository->create($studioData);
    $studio->movies()->associate($movie);

    // Assume everything worked. In the real world you'll need to implement checks.
    return true;
}

Итак, с нами осталось хорошее, разумное разделение проблем. Репозитории знают только о модели Eloquent, которую они вставляют и извлекают из базы данных. Контроллерам не нужны репозитории, они просто передают данные, которые они собирают у пользователя, и передают их в соответствующую службу. Службе все равно, как данные, которые он получает, сохраняются в базе данных, он просто передает данные, которые он дал контроллеру, в соответствующие репозитории.

Мне нравится думать об этом с точки зрения того, что мой код делает и за что он несет ответственность, а не "правильно или неправильно". Вот как я нарушаю свои обязанности:

• Контроллеры - это уровень HTTP и запросы маршрута к базовому apis (он управляет потоком)
• Модели представляют схему базы данных и сообщают приложению, как выглядят данные, какими отношениями они могут обладать, а также любые глобальные атрибуты, которые могут быть необходимы (например, метод имени для возврата конкатенированного имени и фамилии)
• Репозитории представляют собой более сложные запросы и взаимодействия с моделями (я не делаю никаких запросов в методах модели).
• Поисковые системы - классы, которые помогают мне создавать сложные поисковые запросы.

Имея это в виду, каждый раз смысл использовать репозиторий (независимо от того, создаете ли вы interface.etc) - это целая другая тема). Мне нравится этот подход, потому что это означает, что я точно знаю, куда идти, когда мне нужно выполнить определенную работу.

Я также склонен создавать базовый репозиторий, обычно это абстрактный класс, который определяет основные значения по умолчанию - в основном CRUD-операции, а затем каждый ребенок может просто расширять и добавлять методы по мере необходимости или перегружать значения по умолчанию. Внедрение вашей модели также помогает этому шаблону быть достаточно надежным.

Подумайте о Хранилищах как о едином картотеке ваших данных (а не только о ORM). Идея состоит в том, что вы хотите захватить данные в последовательном простом использовании API.

Если вы обнаружите, что просто делаете Model:: all(), Model:: find(), Model:: create(), вы, вероятно, не сильно выиграете от абстрагирования от репозитория. С другой стороны, если вы хотите сделать немного больше бизнес-логики для своих запросов или действий, вы можете захотеть создать репозиторий, чтобы упростить использование API для обработки данных.

Я думаю, вы спрашивали, будет ли репозиторий лучшим способом справиться с некоторым более подробным синтаксисом, необходимым для подключения связанных моделей. В зависимости от ситуации есть несколько вещей, которые я могу сделать:

• Подвешивая новую дочернюю модель от родительской модели (один-один или один-много), я бы добавил метод к репозиторию для детей как-то вроде createWithParent($attributes, $parentModelInstance), и это просто добавит $parentModelInstance->id в поле parent_id атрибутов и вызов create.

• Прикрепляя отношения многих-многих, я фактически создаю функции на моделях, чтобы я мог запускать $instance- > attachChild ($ childInstance). Обратите внимание, что для этого требуются существующие элементы с обеих сторон.

• Создание связанных моделей за один проход, я создаю что-то, что я называю шлюзом (это может быть немного от определений Fowler). Я могу вызвать $gateway- > createParentAndChild ($ parentAttributes, $childAttributes) вместо связки логики, которая может измениться или что усложнит логику, которая у меня есть в контроллере или команде.