Download the PHP package nilportugues/filesystem-repository without Composer
On this page you can find all versions of the php package nilportugues/filesystem-repository. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nilportugues/filesystem-repository
More information about nilportugues/filesystem-repository
Files in nilportugues/filesystem-repository
Package filesystem-repository
Short Description FileSystem Repository implementation
License MIT
Homepage http://nilportugues.com
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package filesystem-repository
FileSystem Repository
FileSystem Repository using nilportugues/repository as foundation.
FileSystem Repository allows you to fetch, paginate and operate with data easily without adding overhead and following good practices.
Table of Contents
- Features
- Installation
- Usage
- Repository
- Data Operations
- Fields
- Filtering
- Pagination
- Pageable
- Page object
- Sorting
- Ordering
Features
- Repository pattern right from the start.
- All operations available from the beginning:
- Search the repository using PHP objects
- Filtering is available using the Filter object.
- Fetching certaing fields is available using the Fields Object.
- Pagination is solved available using the Page and Pageable objects.
- Want to change persistence layer? Provided repository alternatives are:
- InMemoryRepository: for testing purposes
- SQL Repository: migration to SQL databases is possible.
- MongoDBRepository: because your schema keeps changing
- Caching layer required? Easily to add!
- Require the Repository Cache package from Composer to add consistent caching to all operations.
Installation
Use Composer to install the package:
Usage
Repository
The repository class implements all the methods required to interact and filter your data.
public function add($value)public function addAll(array $values)public function remove(Identity $id)public function removeAll(Filter $filter = null)public function transactional(callable $transaction)public function find(Identity $id, Fields $fields = null)public function findBy(Filter $filter = null, Sort $sort = null, Fields $fields = null)public function findByDistinct(Fields $distinctFields, Filter $filter = null, Sort $sort = null, Fields $fields = null)public function findAll(Pageable $pageable = null)public function count(Filter $filter = null)public function exists(Identity $id)
Data Operations
All data can be extracted by fields name, using filters, applying ordering and pages, capable of applying fields, filters and ordering criteria.
Fields
Selecting by field will make hydratation fail. Currently partial object hydratation is not supported.
Class: NilPortugues\Foundation\Domain\Model\Repository\Fields
Methods:
public function __construct(array $fields = [])public function add($field)public function get()
Filtering
Class: NilPortugues\Foundation\Domain\Model\Repository\Filter
Methods:
public function filters()public function must()public function mustNot()public function should()public function clear()
For must(), mustNot() and should(), the methods available are:
public function notStartsWith($filterName, $value)public function notEndsWith($filterName, $value)public function notEmpty($filterName)public function empty($filterName)public function startsWith($filterName, $value)public function endsWith($filterName, $value)public function equal($filterName, $value)public function notEqual($filterName, $value)public function includeGroup($filterName, array $value)public function notIncludeGroup($filterName, array $value)public function range($filterName, $firstValue, $secondValue)public function notRange($filterName, $firstValue, $secondValue)public function notContain($filterName, $value)public function contain($filterName, $value)public function beGreaterThanOrEqual($filterName, $value)public function beGreaterThan($filterName, $value)public function beLessThanOrEqual($filterName, $value)public function beLessThan($filterName, $value)public function clear()public function get()public function hasEmpty($filterName)
Pagination
Pagination is handled by two objects, Pageable that has the requirements to paginate, and Page that it's actually the page with the page data, such as page number, total number, and the data.
Pageable
Class: NilPortugues\Foundation\Domain\Model\Repository\Pageable
Methods:
public function __construct($pageNumber, $pageSize, Sort $sort = null, Filter $filter = null, Fieldse $fields = null)public function offset()public function pageNumber()public function sortings()public function next()public function pageSize()public function previousOrFirst()public function hasPrevious()public function first()public function filters()public function fields()
Page object
Class: NilPortugues\Foundation\Domain\Model\Repository\Page
Methods:
public function __construct(array $elements, $totalElements, $pageNumber, $totalPages, Sort $sort = null, Filter $filter = null, Fields $fields = null)public function content()public function hasPrevious()public function isFirst()public function isLast()public function hasNext()public function pageSize()public function pageNumber()public function totalPages()public function nextPageable()public function sortings()public function filters()public function fields()public function previousPageable()public function totalElements()public function map(callable $converter)
Sorting
Class: NilPortugues\Foundation\Domain\Model\Repository\Sort
Methods:
public function __construct(array $properties = [], Order $order = null)public function andSort(SortInterface $sort)public function orders()public function equals(SortInterface $sort)public function orderFor($propertyName)public function setOrderFor($propertyName, Order $order)public function property($propertyName)
Ordering
Sometimes you want to sort by multiple fields, this is where Order comes in play.
Class: NilPortugues\Foundation\Domain\Model\Repository\Order
Methods:
public function __construct($direction)public function isDescending()public function isAscending()public function __toString()public function equals($object)public function direction()
Quality
To run the PHPUnit tests at the command line, go to the tests directory and issue phpunit.
This library attempts to comply with PSR-1, PSR-2, PSR-4.
If you notice compliance oversights, please send a patch via Pull Request.
Contribute
Contributions to the package are always welcome!
- Report any bugs or issues you find on the issue tracker.
- You can grab the source code at the package's Git repository.
Support
Get in touch with me using one of the following means:
- Emailing me at [email protected]
- Opening an Issue
Authors
License
The code base is licensed under the MIT license.
