Downloads
Stars
Version
Eloquent Repositories is a light-weight solution to add the repository pattern (built on top of Eloquent) to your Laravel project.
This package requires Laravel 8 or higher and PHP 7.4 or higher.
Add this package to your project using Composer:
composer require joelbutcher/eloquent-repositories
The quickest way to create a repository is to use the make:repository
command.
This command accepts the name of the repository you with to create:
php artisan make:repository PostRepository
This command will create a new repository in the app/Repositories
directory in your Laravel application.
You may also optionally append the --model=
option to specify the repository should be created
for the given model. (The model needs to have been created prior to running this command.)
php artisan make:repository PostRepository --model=Post
php artisan make:repository PostRepository -m Post
You may also use the test
or pest
options to create PHPUnit or Pest test files for the repository.
Of course, you may also create a repository manually
use App\Models\Post;
use JoelButcher\EloquentRepositories\Repository;
use Illuminate\Database\Eloquent\Model;
class PostRepository extends Repository
{
protected static function model(): string
{
return Post::class;
}
public function firstForSlug(string $slug): ?Model
{
return $this->where('slug', '=', $slug)->first();
}
}
To use a repository, you may "inject" it into any class that requires it:
class UpdatePost
{
public function __construct(
private readonly PostValidator $validator,
private readonly PostRepository $repository
) {
}
public function update(array $data): void
{
$this->validator->validate($data);
$this->repository->upsert($data, ['slug'], ['slug']);
}
}
You may decide to bind a repository to an interface, you may do so by implementing this interface in your repository and then binding the concrete repository implementation to the service container:
class UserRepository extends Repository implements UserRepositoryContract
{
//
}
class MyServiceProvider extends ServiceProvider
{
public function boot():
{
$this->app->bind(UserRepositoryContract::class, UserRepository::::class)
}
}
Thank you for considering contributing to Eloquent Repositories! You can read the contribution guide here.
In order to ensure that the community is welcoming to all, please review and abide by the Code of Conduct.
This project is open-sourced software licensed under the MIT license.