Download the PHP package abivia/criteria without Composer
On this page you can find all versions of the php package abivia/criteria. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download abivia/criteria
More information about abivia/criteria
Files in abivia/criteria
Package criteria
Short Description A simple logical expression processor with regex capability.
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 criteria
Abivia\Criteria
This is a simple package for evaluating boolean logic in a data structure.
The entry point is Criteria::evaluate(array $criteria, callable $accessor).
$criteria is an array of terms. If any of the terms evaluates as true, evaluate returns.
This is an implicit "or" operation.
Terms
A term is an array with these elements:
arg- the name of a value to be retrieved via the accessor callback.op- A comparison operator, see below.valueorvar- Required for binary operators (i.e. those other than null, !null), the value to be compared or the regular expression to be matched. Thevaluecan be an array. If an array value is provided for a binary operator (other than "in" or "includes"), each value is compared and the firsttrueresult causes the expression to be true. Ifvaris provided, it must be a string. This is passed to the accessor callback to retrieve a value from the application.name- An optional name, used when reporting errors.invert- An optional boolean. When true, the result of the current (sub-)criteria is inverted.and- An optional list of sub-criteria. The list is evaluated as a series of logical "or" conjunctions, then a logical "and" is performed against the result of the argument/value operation.xor- Similar to theandelement instead the result is exclusive or-ed with the result.
Element names are configurable to suit the application. See "property configuration" below.
Operators
The operator is one of ==, ===, !=, !==, >, >=, <, <=, contains, !contains, in, !in, includes, !includes, null, !null, regex, !regex. If no operator is specified, then == is assumed.
- The "contains" operator is true if
var/valueis a substring ofarg. This test is case-sensitive. - The "in" operator is true if
argcan be found invar/value, which normally is an array. If bothargandvar/valueare scalar, "in" is equivalent to ==. Ifargis an array, then the expression is true if all elements inargcan be found invar/value. - The "includes" operator is true if
var/valuecan be found inarg, which normally is an array. If bothargandvar/valueare scalar, "in" is equivalent to ==. If bothargandvar/valueare arrays, then the expression is true if all elements invar/valuecan be found inarg. - The "null" operator is unary, any
var/valueis ignored. - The "regex" operator expects a PHP regular expression.
- A ! in front of "contains", "in", "includes", and "regex" will invert the result of the test.
Examples
Criteria are specified in JSON for readability.
Will evaluate true if the value of acessor('language') is "en".
This assumes the operator is == and Will evaluate true
if acessor('firstName') is equal to acessor('lastName').
Will evaluate true if acessor('firstName') is equal to acessor('lastName')
or if acessor('firstName') is an empty string.
Will evaluate true if acessor('province') is "ON"
and accessor('areaCode') matches one of the values in the list.
Operator Access Control
If your application is processing user-generated data and you want to
restrict access to some operators, this is possible with the
operatorState option.
This will disable use of the regular expression operators.
Property Configuration
Property names used in the criteria can be changed at instantiation by passing an array of replacements. Only the passed in properties will be modified.
Would change a valid input to:
