Chris@0: [![Build Status](https://travis-ci.org/sebastianbergmann/comparator.svg?branch=master)](https://travis-ci.org/sebastianbergmann/comparator)
Chris@0: 
Chris@0: # Comparator
Chris@0: 
Chris@0: This component provides the functionality to compare PHP values for equality.
Chris@0: 
Chris@0: ## Installation
Chris@0: 
Chris@0: You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
Chris@0: 
Chris@0:     composer require sebastian/comparator
Chris@0: 
Chris@0: If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
Chris@0: 
Chris@0:     composer require --dev sebastian/comparator
Chris@0: 
Chris@0: ## Usage
Chris@0: 
Chris@0: ```php
Chris@0: <?php
Chris@0: use SebastianBergmann\Comparator\Factory;
Chris@0: use SebastianBergmann\Comparator\ComparisonFailure;
Chris@0: 
Chris@0: $date1 = new DateTime('2013-03-29 04:13:35', new DateTimeZone('America/New_York'));
Chris@0: $date2 = new DateTime('2013-03-29 03:13:35', new DateTimeZone('America/Chicago'));
Chris@0: 
Chris@0: $factory = new Factory;
Chris@0: $comparator = $factory->getComparatorFor($date1, $date2);
Chris@0: 
Chris@0: try {
Chris@0:     $comparator->assertEquals($date1, $date2);
Chris@0:     print "Dates match";
Chris@14: } catch (ComparisonFailure $failure) {
Chris@0:     print "Dates don't match";
Chris@0: }
Chris@0: ```
Chris@0: