Download the PHP package eloquent/equality without Composer
On this page you can find all versions of the php package eloquent/equality. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eloquent/equality
More information about eloquent/equality
Files in eloquent/equality
Package equality
Short Description A better strict comparison for PHP.
License MIT
Homepage https://github.com/eloquent/equality
Informations about the package equality
Equality
A better strict comparison for PHP.
Deprecated
Equality is deprecated. Please use Parity instead.
Installation and documentation
- Available as Composer package eloquent/equality.
- API documentation available.
The problem
Sometimes it is necessary to compare two objects to determine whether they are considered equal.
If the ==
operator is used, there is no strictness about the equality. For
instance, this snippet outputs 'equal':
Conversely, if the ===
operator is used, objects are not equal unless they are
the same instance. The following snippet outputs 'not equal':
Unfortunately PHP does not have an inbuilt method to compare objects strictly without requiring that they be the same instance. This is where Equality comes in. This snippet correctly outputs 'equal':
Usage
Equality is very simple to use. Simply instantiate a Comparator
and use its
equals()
method:
Equality can work with any PHP data type, not just objects.
Custom equality logic
In some cases it may be desirable to customize how equality is determined.
The interface EqualityComparable
can be used to provide a custom equality
implementation for any class:
When Equality encounters an object that implements EqualityComparable
, it
will return the result of the isEqualTo()
method instead of using the default
equality logic. The comparator itself will be passed as the second parameter.
How does Equality work?
Equality uses reflection to recurse over the values it is passed and ensure that they are deeply, and strictly, equal.
In addition, it implements special protections to avoid infinite recursion issues, such as objects that contain themselves, or objects that contain the object that they are being compared to.