# メールアドレス

`Zend_Validate_EmailAddress` は、メールアドレスの検証を行います。 このバリデータは、まずメールアドレスを local-part @ hostname に分割し、メールアドレスやホスト名の仕様にあわせて検証します。

## 基本的な使用法

基本的な使用法は、以下のようになります。

    $validator = new Zend_Validate_EmailAddress();
    if ($validator->isValid($email)) {
        // メールアドレスは正しい形式のようです
    } else {
        // 不正な形式なので、理由を表示します
        foreach ($validator->getMessages() as $message) {
            echo "$message\n";
        }
    }

これは、メールアドレス `$email` を検証し、失敗した場合は その原因を表す便利なエラーメッセージを `$validator->getMessages()` で取得します。

## メールアドレス検証のオプション

`Zend_Validate_EmailAddress` supports several options which can eighter be set at initiation, by giving an array with the related options, or afterwards, by using `setOptions()`. The following options are supported:

- allow: Defines which type of domain names are accepted. This option is used in conjunction with the hostname option to set the hostname validator. For more informations about possible values of this option look at and possible `ALLOW`* constants. This option defaults to `ALLOW_DNS`.

- hostname: Sets the hostname validator with which the domain part of the email address will be validated.

- mx: Defines if the MX records from the server should be detected. If this option is defined to `TRUE` then the MX records are used to verify if the server accepts emails. This option defaults to `FALSE`.

- deep: Defines if the servers MX records should be verified by a deep check. When this option is set to `TRUE` then additionally to MX records also the A, A6 and `AAAA` records are used to verify if the server accepts emails. This option defaults to `FALSE`.

- domain: Defines if the domain part should be checked. When this option is set to `FALSE`, then only the local part of the email address will be checked. In this case the hostname validator will not be called. This option defaults to `TRUE`.

    $validator = new Zend_Validate_EmailAddress();
    $validator->setOptions(array('domain' => false));

## 複雑なローカルパート

`Zend_Validate_EmailAddress` は、メールアドレスの検証を RFC2822 にもとづいて行います。たとえば、妥当な形式のメールアドレスとしては `bob@domain.com`、`bob+jones@domain.us`、 `"bob@jones"@domain.com` および `"bob jones"@domain.com` などがあります。

かつて使われていたものの、現在は有効とはみなされないフォーマットもあります (たとえば、メールアドレスに改行文字や "\" を使用するなど)。

## ローカルパートのみの検証

If you need `Zend_Validate_EmailAddress` to check only the local part of an email address, and want to disable validation of the hostname, you can set the domain option to `FALSE`. This forces `Zend_Validate_EmailAddress` not to validate the hostname part of the email address.

    $validator = new Zend_Validate_EmailAddress();
    $validator->setOptions(array('domain' => FALSE));

## さまざまな形式のホスト名の検証

メールアドレスのホスト名部分の検証は、 `Zend_Validate_Hostname` で行います。デフォルトでは、`domain.com` 形式の DNS ホスト名のみが有効となります。しかし、 IP アドレスやローカルホスト名も有効にしたいこともあるでしょう。

その場合は、`Zend_Validate_EmailAddress` のインスタンスを作成する際にパラメータを渡さなければなりません。 このパラメータで、認めたいホスト名の形式を指定します。 詳細は `Zend_Validate_Hostname` を参照ください。 たとえば DNS ホスト名およびローカルホスト名のどちらも許可するには、次のようにします。

    $validator = new Zend_Validate_EmailAddress(
                        Zend_Validate_Hostname::ALLOW_DNS |
                        Zend_Validate_Hostname::ALLOW_LOCAL);
    if ($validator->isValid($email)) {
        // メールアドレスは正しい形式のようです
    } else {
        // 不正な形式なので、理由を表示します
        foreach ($validator->getMessages() as $message) {
            echo "$message\n";
        }
    }

## そのホスト名が実際にメールを受け付けるかどうかのチェック

ただ単にメールアドレスが正しい書式であるというだけでは、 そのアドレスが実際に存在するかどうかはわかりません。 この問題を解決するには、MX の検証を行います。 メールアドレスのホスト名に対応する DNS レコードに、MX (メール) のエントリが存在するかどうかを調べるのです。 これは、そのホストがメールを受け付けているかどうかを教えてはくれますが、 そのメールアドレス自体が正しいものであるかどうかを知ることはできません。

MX のチェックはデフォルトでは無効です。 MX のチェックを有効にするには、`Zend_Validate_EmailAddress` コンストラクタの 2 番目のパラメータを渡します。

    $validator = new Zend_Validate_EmailAddress(
        array(
            'allow' => Zend_Validate_Hostname::ALLOW_DNS,
            'mx'    => true
        )
    );

### WindowsでのMX のチェック

Within Windows environments MX checking is only available when PHP 5.3 or above is used. Below PHP 5.3 MX checking will not be used even if it's activated within the options.

あるいは、`TRUE` または `FALSE` を `$validator->setValidateMx()` に渡すことで、 MX の検証を有効あるいは無効にすることもできます。

この設定を有効にすると、ネットワーク関数を用いて メールアドレスのホスト名部に対する MX レコードの存在チェックをします。 これにより、スクリプトの処理速度が低下することに気をつけてください。

Sometimes validation for MX records returns false, even if emails are accepted. The reason behind this behaviour is, that servers can accept emails even if they do not provide a MX record. In this case they can provide A, A6 or `AAAA` records. To allow `Zend_Validate_EmailAddress` to check also for these other records you need to set deep MX validation. This can be done at initiation by setting the deep option or by using `setOptions()`.

    $validator = new Zend_Validate_EmailAddress(
        array(
            'allow' => Zend_Validate_Hostname::ALLOW_DNS,
            'mx'    => true,
            'deep'  => true
        )
    );

### パフォーマンスの警告

You should be aware that enabling MX check will slow down you script because of the used network functions. Enabling deep check will slow down your script even more as it searches the given server for 3 additional types.

### 許可されないIPアドレス

You should note that MX validation is only accepted for external servers. When deep MX validation is enabled, then local IP addresses like `192.168.*` or `169.254.*` are not accepted.

## 国際化ドメイン名の検証

`Zend_Validate_EmailAddress` は、ドメインの中に国際文字が使われている場合も処理できます。 このようなドメインは、国際化ドメイン名 (International Domain Name: IDN) と呼ばれています。これはデフォルトで有効になっていますが、無効にすることも可能です。 無効にするには、`Zend_Validate_EmailAddress` が内部で保持している `Zend_Validate_Hostname` オブジェクトの設定を変更します。

    $validator->getHostnameValidator()->setValidateIdn(false);

`setValidateIdn()` の詳細な使用法は、 `Zend_Validate_Hostname` のドキュメントを参照ください。

IDN の検証は、DNS ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。

## トップレベルドメインの検証

デフォルトでは、ホスト名の検証は既知の TLD の一覧に基づいて行われます。 これはデフォルトで有効になっていますが、無効にすることもできます。無効にするには、 無効にするには、`Zend_Validate_EmailAddress` が内部で保持している `Zend_Validate_Hostname` オブジェクトの設定を変更します。

    $validator->getHostnameValidator()->setValidateTld(false);

`setValidateTld()` の詳細な使用法は、 `Zend_Validate_Hostname` のドキュメントを参照ください。

TLD の検証は、DNS ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。

## メッセージの設定

`Zend_Validate_EmailAddress` は、 `Zend_Validate_Hostname` を使用してメールアドレスのホスト名部分をチェックします。 Zend Framework 1.10 以降、 `Zend_Validate_Hostname` 用のメッセージを `Zend_Validate_EmailAddress` から設定できるようになります。

    $validator = new Zend_Validate_EmailAddress();
    $validator->setMessages(array(Zend_Validate_Hostname::UNKNOWN_TLD => 'I don't know the TLD you gave'));

Zend Framework 1.10 より前のバージョンでは、まず `Zend_Validate_Hostname` にメッセージをアタッチしてからそれを `Zend_Validate_EmailAddress` に設定しないと独自のメッセージを返せませんでした。