Download the PHP package saritasa/laravel-repositories without Composer

Laravel Repositories

Implementation of Repository pattern for Laravel (on top of Eloquent)

Laravel 5.5+

Install the package:

Configuration

• Publish configuration file:

• Register custom repositories implementation:

Note: Your custom repository must implement IRepository contract.

Getting repository inside your code

To get specific repository in your code you can just build with DI container repositories factory and then build needed for your repository in this factory.
Example:

Filtering results with repository

Methods findWhere/getWhere/getWith/getPage/getCursorPage/count/ can receive criteria as params Here the examples of available syntax:

• Criterion without operator:

In this case = operator and and boolean between them will be used.
Example: ... 'field1 = 'value1' and 'field2' = 1 ...

• Criterion with operator:

Important: arrays and collection can be used only with in and not in operators.
Note: As 4th parameter you can pass boolean or/and (and uses by default). But you should remember that boolean used between current and previous criterion
Example: ... 'field1 <> 'value1' or 'field2' > 1 and 'field3' in (1, 2) and 'field4' not in (1, 2) ...

• Criterion as DTO:

Result will be the same as in previous example.

• Nested criteria:
  You can group different conditions that gives flexibility in getting data from repository

Note: you can add nesting level in any depth what you want. To use or condition between one group and other(group and non-group condition) you can pass 'boolean' parameter in the same level as other conditions.

Example:... ('field1 <> 'value1' or 'field2' > 1) or ('field3' in (1, 2) and 'field4' not in (1, 2)) ...

• Relation existence criterion:
  You can build queries to check on existence any model relations

Preload model relations

Method getWith() method allows to retrieve list of entities with
eager loaded related models and related models counts. Also allows to filter this list by given criteria
and sort in requested order.

Example:

• Each user will be retrieved with pre-loaded role and supervisors models.
• Each user will be retrieved with pre-loaded phones relation count.
• List of users will be ordered by requested sort options.

Exceptions

Repository Exception

Base exception for repository layer.

Repository register exception

Throws when can not register custom repository.

Model not found Exception

Throws in case when some model not exists in storage.

Bad Criteria Exception

Throws when provided criteria has incorrect format at least in one criterion inside.

Contributing

1. Create fork, checkout it
2. Develop locally as usual. Code must follow PSR-1, PSR-2 -
   run PHP_CodeSniffer to ensure, that code follows style guides
3. Cover added functionality with unit tests and run PHPUnit to make sure, that all tests pass
4. Update README.md to describe new or changed functionality
5. Add changes description to Semantic Versioning convention to determine next version number.
6. When ready, create pull request

Make shortcuts

If you have GNU Make installed, you can use following shortcuts:

• (instead of ) -
  run static code analysis with PHP_CodeSniffer
  to check code style
• (instead of ) -
  fix code style violations with PHP_CodeSniffer
  automatically, where possible (ex. PSR-2 code formatting violations)
• (instead of ) -
  run tests with PHPUnit
• • instead of
• or just without parameters -
  invokes described above install, cs, test tasks sequentially -
  project will be assembled, checked with linter and tested with one single command

Resources

• Bug Tracker
• Code
• Changes History
• Authors