tomcan/dkimvalidator

A DKIM signature validator in PHP.

v0.4.1 2025-01-29 23:01 UTC

Requires

• php: >=7.2.0
• ext-hash: *
• ext-mbstring: *
• ext-openssl: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.15
• nunomaduro/phpinsights: ^v1.9.0
• phpunit/phpunit: 8.4.1
• roave/security-advisories: dev-master

MIT

• angrychimp
• Teon d.o.o. - Bostjan Skufca
• Marcus Bointon
• Tom Cannaerts

README

A straightforward validation class for checking DKIM signatures and header settings. Requires PHP 7.2 or later.

Installation

composer require tomcan/dkimvalidator

Usage

use TomCan\DKIMValidator\Validator;
use TomCan\DKIMValidator\DKIMException;
require 'vendor/autoload.php';
//Put a whole raw email message in here
//Load the message directly from disk -
//don't copy & paste it as that will likely affect line breaks & charsets
$message  = file_get_contents('message.eml');
$dkimValidator = new Validator($message);
try {
    if ($dkimValidator->validateBoolean()) {
        echo "Cool, it's valid";
    } else {
        echo 'Uh oh, dodgy email!';
    }
} catch (DKIMException $e) {
    echo $e->getMessage();
}

Changelog

• Original package angrychimp/php-dkim;
• Forked by teon/dkimvalidator.
• Forked into phpmailer/dkimvalidator by Marcus Bointon (Synchro) in October 2019:
  • Restructuring
  • Cleanup for PSR-12 and PHP 7.2
  • Various bug fixes and new features.
• Forked into tomcan/dkimvalidator by Tom Cannaerts (TomCan) in Januari 2025:
  • Return more details in the result