exs/bulk-email-checker-bundle

此包通过 'Bulk Email Checker' API 提供电子邮件验证。

v3.0.2 2020-11-04 16:14 UTC

This package is auto-updated.

Last update: 2024-09-05 00:45:32 UTC


README

Build Status

安装

使用 composer 下载此包

$ composer require exs/bulk-email-checker-bundle

启用此包

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new EXS\BulkEmailCheckerBundle\EXSBulkEmailCheckerBundle(),
        // ...
    );
}

配置

最小必要配置

exs_bulk_email_checker:
    api_key: 'YourApiKey'

完整配置(显示默认值)

exs_bulk_email_checker:
    enabled: true
    pass_on_error: true
    check_mx: false
    api_key: 'YourApiKey'
    api_url: 'https://api-v4.bulkemailchecker.com/?key=#api_key#&email=#email#'
    whitelisted_domains: ['mycompany.tld']
    blacklisted_domains: ['thebadguyscompany.tld']

使用方法

使用 "BulkEmailChecker" 约束。

<?php
// On any entity or model class.

use EXS\BulkEmailCheckerBundle\Validator\Constraints as ExsAssert;
// ...

class SomeClass
{
    // ...

    /**
     * @var string
     *
     * @ExsAssert\BulkEmailChecker()
     */
    private $email;
    
    // ...
}

您还可以直接使用名为 "exs_bulk_email_checker.bulk_email_checker_manager" 的服务及其 "validate()" 方法。

// Dummy example

$email = 'foo@bar.baz';
$manager = $this->container->get('exs_bulk_email_checker.bulk_email_checker_manager');
$valid = $manager->validate($email); // boolean value