sebastian/comparator

Provides the functionality to compare PHP values for equality

8.3.0 2026-06-05 03:06 UTC

Requires

• php: >=8.4
• ext-dom: *
• ext-mbstring: *
• sebastian/diff: ^9.0
• sebastian/exporter: ^8.1.0

Requires (Dev)

• phpunit/phpunit: ^13.2

Suggests

• ext-bcmath: For comparing BcMath\Number objects

BSD-3-Clause

• Sebastian Bergmann
• Jeff Welch
• Volker Dusch
• Bernhard Schussek

• equality
• compare
• comparator

README

sebastian/comparator

This component provides the functionality to compare PHP values for equality.

Installation

You can add this library as a local, per-project dependency to your project using Composer:

composer require sebastian/comparator

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:

composer require --dev sebastian/comparator

Usage

<?php
use SebastianBergmann\Comparator\Factory;
use SebastianBergmann\Comparator\ComparisonFailure;

$date1 = new DateTime('2013-03-29 04:13:35', new DateTimeZone('America/New_York'));
$date2 = new DateTime('2013-03-29 03:13:35', new DateTimeZone('America/Chicago'));

$factory = new Factory;
$comparator = $factory->getComparatorFor($date1, $date2);

try {
    $comparator->assertEquals($date1, $date2);
    print "Dates match";
} catch (ComparisonFailure $failure) {
    print "Dates don't match";
}