README

Equatable objects and collections in PHP.

We reach a limitation in PHP when we want to compare objects in such a way that == yields incorrect results. We often overcome this limitation by implementing a method like equals($other) encapsulating our specialized behaviour. This library provides an interface for this.

We hit secondary problems when we try to work with these objects, especially when dealing with arrays of them. Functions like in_array() and array_search() don't use our specialized equals() method, so they in turn yield incorrect results. To overcome these problems, this library provides a map (ordered dictionary-style collection) and a vector (stack-like collection). These are immutable and final, meant to replace normal arrays.

Authored by Jasper N. Brouwer.

Under the collective flag of Future500 B.V.

Installation

composer.phar require f500/equatable

License

The MIT License (MIT)