Download the PHP package manchenkoff/laravel-repositories without Composer
On this page you can find all versions of the php package manchenkoff/laravel-repositories. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download manchenkoff/laravel-repositories
More information about manchenkoff/laravel-repositories
Files in manchenkoff/laravel-repositories
Package laravel-repositories
Short Description Repository pattern implementation for your Laravel application
License MIT
Informations about the package laravel-repositories
Laravel Repositories
Package provides a basic implementation of Repository pattern with artisan command to generate classes.
Features:
Repositoryclass with basic methods likeall,find,create,update,delete- Generic type comments to pass
PHPStanchecks - Artisan
make:repositorycommand to generate repository class with model and interface
Installation
To install this package, you need to install Composer first, and then run:
or add this line to composer.json:
and run composer update in the terminal.
Package should automatically register its service provider in your application, but you can do it manually in config/app.php:
Usage
First of all, you need to create a model class for your repository. You can do it manually or use artisan command:
Then you can create a repository class for your model:
This command will create a repository class in app/Repositories directory and PostRepositoryInterface contract class in app/Contracts/Repositories.
Now you can use existing methods in your services or extend with custom functionality:
Implementation
All repository methods use protected query() method to get Eloquent\Builder instance. You can override this method in your repository class to add custom logic, e.g. when you always need some relations to be loaded or custom sorting applied.
Here is a list of available methods with a quick description:
| Method | Description |
|---|---|
paginated(): LengthAwarePaginator |
returns paginated collection |
all(): Collection |
returns all entities |
find(mixed $id): ?Model |
returns entity by id or null |
get(mixed $id): Model |
returns entity by id or throws ModelNotFoundException |
create(array $data): Model |
creates new entity with given data |
update(Model $entity, array $data): Model |
updates existing entity with given data |
updateMany(array $ids, array $data): void |
updates many entities with given data by ids |
delete(Model $entity): Model |
deletes existing entity |
deleteMany(array $ids): void |
deletes many entities by ids |
Also you might want to adjust class template for your needs. You can do it by publishing package views:
Configuration
By default, repositories are created in app/Repositories and interfaces in app/Contracts/Repositories. You can customize these paths by publishing and modifying the config file:
Then edit config/repositories.php:
Now running php artisan make:repository PostRepository Post will create:
app/Domain/Users/Repositories/PostRepository.phpapp/Domain/Users/Contracts/PostRepositoryInterface.php
Development
This package is completely open-source, so any contributions are welcome!
Clone this repository to your local machine, install dependencies and run tests:
There are some useful composer scripts:
| Script | Description |
|---|---|
composer fmt |
Apply Laravel Pint code style rules |
composer test |
Run tests with Testbench package |
composer lint |
Run PHP Stan analysis against package codebase |
composer rector |
Run Rector analysis against package codebase |
composer rector:fix |
Apply available Rector suggestions |
All versions of laravel-repositories with dependencies
illuminate/console Version ^11.0|^12.0
illuminate/support Version ^11.0|^12.0
illuminate/database Version ^11.0|^12.0
illuminate/contracts Version ^11.0|^12.0