Download the PHP package ngmy/specification without Composer
On this page you can find all versions of the php package ngmy/specification. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ngmy/specification
More information about ngmy/specification
Files in ngmy/specification
Package specification
Short Description This is a library to help implement the specification pattern in PHP. It provides on-memory validation, on-memory and ORM selection, and specification composite.
License MIT
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 specification
日本語
PHP Specification
This is a library to help implement the specification pattern in PHP.
It provides on-memory validation, on-memory and ORM selection, and specification composite.
Installation
Usage
Specification creation and on-memory validation and selection
Create your specification class by inheriting from the AbstractSpecification class.
Then implement the isSatisfiedBy method.
In this method, write the criteria that satisfy the specification.
In addition, use the @extends annotation to write the object type expected by the isSatisfiedBy method
to facilitate static analysis.
By calling the isSatisfiedBy method with the object to be verified,
you can verify that the object satisfies the specification.
Of course, it can also be used for selection.
ORM selection
Eloquent
Implement the applyToEloquent method.
Write the selection criteria in this method using the where method, etc.
By calling the applyToEloquent method passing the Eloquent builder, you can add selection criteria to the query.
Doctrine
Implement the applyToDoctrine method.
Write the selection criteria in this method using the andWhere method, etc.
By calling the applyToDoctrine method passing the query builder, you can add selection criteria to the query.
Composite
You can compose specifications with AND, OR, and NOT.
When composing a specification, the criteria writed in the isSatisfiedBy, applyToEloquent and applyToDoctrine
methods are also composited.
AND
By passing an instance of another specification to the specification's and method and calling it,
you can generate a new specification that is an AND composite of the two specifications.
OR
By passing an instance of another specification to the specification's or method and calling it,
you can generate a new specification that is an OR composite of the two specifications.
NOT
By calling the not method of the specification, you can generate a new specification that is NOT composite of itself.
Example of use
- ngmy/php-specification-example
- This project is a code example of using the PHP Specification to implement a specification pattern.
It is written following Domain-Driven Design approach and has a code example of combining a specification and a repository.
It uses Eloquent and Doctrine for the ORM.
- This project is a code example of using the PHP Specification to implement a specification pattern.
License
PHP Specification is open-sourced software licensed under the MIT license.
