Home | Symfony2Doc »リファレンスドキュメント »バリデータリファレンス »Email

このページのコンテンツ

前のドキュメント

Type

次のドキュメント

Length

ソース



クイックリンク


コメントリスト

Powered by Disqus

ご質問や翻訳不備等お気軽にコメントください。


ご注意

Symfony2日本語翻訳ドキュメントは内容が古くなっております。公式サイトの英語ドキュメントを参照してください。

Email

Note

  • 対象バージョン:2.3
  • 翻訳更新日:2013/6/9

値が有効なメールアドレスであることを検証します。検証対象の値は、バリデーション前に文字列にキャストされます。

適用先 プロパティまたはメソッド
オプション
クラス Email
バリデーター EmailValidator

基本的な使い方

  • YAML
    # src/BlogBundle/Resources/config/validation.yml
    Acme\BlogBundle\Entity\Author:
        properties:
            email:
                - Email:
                    message: The email "{{ value }}" is not a valid email.
                    checkMX: true
    
  • Annotations
    // src/Acme/BlogBundle/Entity/Author.php
    namespace Acme\BlogBundle\Entity;
    
    use Symfony\Component\Validator\Constraints as Assert;
    
    class Author
    {
        /**
         * @Assert\Email(
         *     message = "The email '{{ value }}' is not a valid email.",
         *     checkMX = true
         * )
         */
         protected $email;
    }
    
  • XML
    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
    <?xml version="1.0" encoding="UTF-8" ?>
    <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
    
        <class name="Acme\BlogBundle\Entity\Author">
            <property name="email">
                <constraint name="Email">
                    <option name="message">The email "{{ value }}" is not a valid email.</option>
                    <option name="checkMX">true</option>
                </constraint>
            </property>
        </class>
    </constraint-mapping>
    
  • PHP
    // src/Acme/BlogBundle/Entity/Author.php
    namespace Acme\BlogBundle\Entity;
    
    use Symfony\Component\Validator\Mapping\ClassMetadata;
    use Symfony\Component\Validator\Constraints as Assert;
    
    class Author
    {
        public static function loadValidatorMetadata(ClassMetadata $metadata)
        {
            $metadata->addPropertyConstraint('email', new Assert\Email(array(
                'message' => 'The email "{{ value }}" is not a valid email.',
                'checkMX' => true,
            )));
        }
    }
    

オプション

message

: string デフォルト: This value is not a valid email address

検証対象の文字列が有効なメールアドレスではない場合に、このメッセージが表示されます。

checkMX

: Boolean デフォルト: false

このオプションを true に設定すると、検証対象のメールアドレスのホスト部が DNS の MX レコードとして有効かどうか checkdnsrr PHP 関数を使ってチェックされます。

checkHost

: Boolean デフォルト: false

このオプションを true に設定すると、検証対象のメールアドレスのホスト部が、DNS の MX または A または AAAA レコードとして有効かどうか checkdnsrr PHP 関数を使ってチェックされます。

blog comments powered by Disqus