A Simple Specification Library for PHP
PHP
Latest commit 2f32a6d Oct 21, 2015 @greydnls Update composer.json
update package name
Permalink
Failed to load latest commit information.
spec/Kayladnls/Spec
src
.gitignore
.travis.yml
README.md
composer.json
phpspec.yml

README.md

Spec

A Simple Specification library for PHP

Build Status Code Climate

Installation

composer require kayladnls/spec

What is it?

"the specification pattern is a particular software design pattern, whereby business rules can be recombined by chaining the business rules together using boolean logic. The pattern is frequently used in the context of domain-driven design." -- wikipedia

How do I use it?

Use the builder

$all_spec = Kayladnls/Spec/Builder::all(new MustHaveFourLegs(), new MustHaveStripesSpec());

$all_spec->isSatisfiedBy($elephpant) //False 
$all_spec->isSatisfiedBy($zebra)     // True

$any_spec = Kayladnls/Spec/Builder::any($all_spec, new IsLizardSpec());
$any_spec->isSatisfiedBy($iguana) // True

Or, you can use functions if that's what tickles your fancy.

Function Based

$all_spec = Kayladnls/Spec/all([new MustHaveFourLegs(), new MustHaveStripesSpec()]);

Kayladnls/Spec/satisfies($elephpant, $all_spec) //False 
Kayladnls/Spec/satisfies($zebra, $all_spec) //True 

$any_spec = Kayladnls/Spec/any([$all_spec, new IsLizardSpec()]);
Kayladnls/Spec/satisfies($iguana, $any_spec) // True

$none_spec = Kayladnls/Spec/none([new MustHaveFourLegs(), new MustHaveSpotsSpec()]);
Kayladnls/Spec/satisfies($kangaroo, $none_spec) // true
Kayladnls/Spec/satisfies($cheetah, $none_spec) // false

Example

if ($all_spec->isSatisfiedBy($zebra)){
    // Do Some cool Zebra Stuff here. 
}

// Function Based
if (satisfies($iguana, $any_spec)){
    // do some cool lizard-based stuff here. 
}