README

Laravel Model Repositories

Generic repository pattern for Laravel Eloquent models.

• Changelog
• Usage
  • Install package
  • Setup service provider
  • Generate a repository
  • Add repository binding
• Example usage
• Namespace configuration
  • Assumptions
  • Default configuration
  • Multiple configurations
  • Specificity
• Available methods
• Stub customization

Changelog

View the changelog.

Usage

Install package

composer require wimski/laravel-model-repositories

Setup service provider

This package is NOT loaded using package discovery. You should create your own service provider that extends the one from this package and add it to your config manually.

app/Providers/RepositoryServiceProvider.php

<?php

namespace App\Providers;

use Wimski\ModelRepositories\Providers\ModelRepositoryServiceProvider;

class RepositoryServiceProvider extends ModelRepositoryServiceProvider
{
    protected array $repositories = [
        // add your repository bindings here
    ];
}

config/app.php

<?php

return [
    'providers' => [
        /*
         * Application Service Providers...
         */
         App\Providers\RepositoryServiceProvider::class,
    ],
];

Generate a repository

php artisan make:repository App\\Models\\MyModel

This will create the following files:

• MyModelRepositoryInterface.php
• MyModelRepository.php

The namespace and file location depend on the namespace configuration.

Alternatively you can completely override the contract and repository FQN by using the command options. The namespace matching and class name suffixing will be skipped.

php artisan make:repository App\\Models\\MyModel --contract=Foo\\Bar --repository=Lorem\\Ipsum

Add repository binding

Set up the binding of your new repository in the service provider.

protected array $repositories = [
    MyModelRespositoryInterface::class => MyModelRespository::class,
];

Example usage

class SomeService
{
    protected MyModelRespositoryInterface $repository;
    
    public function __construct(MyModelRespositoryInterface $repository)
    {
        $this->repository = $repository;    
    }
    
    public function doSomething($id): void
    {
        $myModel = $this->repository->findOrFail($id);
    }
}

Publishing configuration file

Because this package does not register its own service provider, your own service provider should be referenced when publishing this package's configuration file.

php artisan vendor:publish --provider=App\Providers\RepositoryServiceProvider

Namespace configuration

The namespaces configuration is used to determine what the namespaces of your repository classes - and locations of the subsequent files - should be. Each configuration exists of three parts:

• models
• contracts
• repositories

When generating a repository for a model the command will look for a namespace configuration which has a models part that matches the supplied model. The contracts and repositories parts of that configuration are then used as the namespaces for the repository classes.

Assumptions

• The namespaces follow the PSR-4 file location convention.
• The namespaces are within the Laravel app directory.

Default configuration

'namespaces' => [
    [
        'models'       => 'App\\Models',
        'contracts'    => 'App\\Contracts\\Repositories',
        'repositories' => 'App\\Repositories',
    ],
],

When generating a repository for App\Models\MyModel, the following two classes will be created:

• App\Contracts\Repositories\MyModelRepositoryInterface
• App\Repositories\MyModelRepository

Multiple configurations

You can have multiple namespace configurations, for example when using domains.

'namespaces' => [
    [
        'models'       => 'App\\DomainA\\Models',
        'contracts'    => 'App\\DomainA\\Contracts\\Repositories',
        'repositories' => 'App\\DomainA\\Repositories',
    ],
    [
        'models'       => 'App\\DomainB\\Models',
        'contracts'    => 'App\\DomainB\\Contracts\\Repositories',
        'repositories' => 'App\\DomainB\\Repositories',
    ],
],

Specificity

The first match will be used so if you have overlapping namespace configurations, make sure to have the more specific ones on top.

'namespaces' => [
    [
        'models' => 'App\\Models\\SpecificModels',
        ...
    ],
    [
        'models' => 'App\\Models',
        ...
    ],
],

Available methods

See interface.

Stub customization

See Laravel's documentation about stub customization. This package adds the following stub files:

• model.repository.interface.stub
• model.repository.stub

PHPUnit

composer test

PHPStan

composer analyze

Credits

• wimski
• All Contributors

License

The MIT License (MIT). Please see License File for more information.