documentation/manual/zh/module_specs/Zend_Validate-EmailAddress.xml

   1 <sect2 id="zend.validate.set.email_addresses">
   2
   3     <title> Email 地址</title>
   4
   5     <para>
   6         <code>Zend_Validate_EmailAddress</code>允许你校验一个email地址。首先校验器把email地址分成local-part和@hostname并试图按照email地址和主机名的规范来匹配它。
   7     </para>
   8
   9     <para>
  10         <emphasis role="strong">基本用法</emphasis>
  11     </para>
  12
  13     <para>
  14         一个基本用法的例子如下：
  15
  16         <programlisting role="php"><![CDATA[
  17 $validator = new Zend_Validate_EmailAddress();
  18 if ($validator->isValid($email)) {
  19     // email appears to be valid
  20 } else {
  21     // email is invalid; print the reasons
  22     foreach ($validator->getMessages() as $message) {
  23         echo "$message\n";
  24     }
  25 }
  26 ]]>
  27         </programlisting>
  28
  29         这个例子匹配email地址<code>$email</code>并在匹配失败的时候用<code>$validator->getMessages()</code>来获得有用的错误信息。
  30
  31     </para>
  32
  33
  34     <para>
  35         <emphasis role="strong">复杂的local parts</emphasis>
  36     </para>
  37
  38     <para>
  39         <code>Zend_Validate_EmailAddress</code>根据RFC2822来匹配任何有效的email地址。例如，有效的email地址包括<code>bob@domain.com</code>, <code>bob+jones@domain.us</code>, <code>"bob@jones"@domain.com</code> 和 <code>"bob jones"@domain.com</code>。一些过时的email格式目前不再校验（例如email地址中的回车符或"\"符）。
  40     </para>
  41
  42     <para>
  43         <emphasis role="strong">校验不同类型的主机名</emphasis>
  44     </para>
  45
  46     <para>
  47         Email地址中的主机名部分依靠<link linkend="zend.validate.set.hostnames"><code>Zend_Validate_Hostname</code></link>来校验。尽管你希望IP地址和本地主机名也被接受，但缺省地只有像<code>domain.com</code>格式的DNS主机名被接受。
  48         当然如果你想如愿，需要实例化<code>Zend_Validate_EmailAddress</code>并传递一个参数来指明哪种主机名你想接受。更多的细节包含在<code>Zend_Validate_Hostname</code>中。
  49         下面的例子显示如何同时接受DNS和本地主机名：
  50         <programlisting role="php"><![CDATA[
  51 $validator = new Zend_Validate_EmailAddress(Zend_Validate_Hostname::ALLOW_DNS | Zend_Validate_Hostname::ALLOW_LOCAL);
  52 if ($validator->isValid($email)) {
  53     // email appears to be valid
  54 } else {
  55     // email is invalid; print the reasons
  56     foreach ($validator->getMessages() as $message) {
  57         echo "$message\n";
  58     }
  59 }
  60 ]]>
  61         </programlisting>
  62
  63     </para>
  64     <para>
  65         <emphasis role="strong">检查主机名是否确实接受email</emphasis>
  66     </para>
  67
  68     <para>
  69         email地址的格式正确并不意味着这个email地址确实存在。为解决这个问题，你可以用MX校验来检查一个MX(email)条目的主机名是否存在于DNS的纪录里。这将告诉你这个主机名接受email，但并不告诉你确切的email地址是有效的。
  70     </para>
  71
  72     <para>
  73         MX 检查不是缺省地激活的，并且目前只支持UNIX平台。为激活MX检查，你可以传递第二个参数给<code>Zend_Validate_EmailAddress</code>构造器。
  74         <programlisting role="php"><![CDATA[
  75 $validator = new Zend_Validate_EmailAddress(Zend_Validate_Hostname::ALLOW_DNS, true);
  76 ]]>
  77         </programlisting>
  78
  79         另外你可以传递 <code>true</code> 或 <code>false</code> 给<code>$validator->setValidateMx()</code> 来激活或禁止 MX 校验。
  80     </para>
  81
  82     <para>
  83         用激活这个设置的网络函数将用来为你所想校验的email地址的主机名中的MX记录的存在做检查。请注意这将可能把你的脚本变慢。
  84     </para>
  85
  86     <para>
  87         <emphasis role="strong">校验国际域名</emphasis>
  88     </para>
  89
  90     <para>
  91         <code>Zend_Validate_EmailAddress</code> 也将匹配存在于某些域名中的国际字符。这就是国际域名（IDN）支持。这个是缺省激活，你可以通过用存在于 <code>Zend_Validate_EmailAddress</code> 中的内部的 <code>Zend_Validate_Hostname</code> 对象来改变设置来禁止。
  92
  93     <programlisting role="php"><![CDATA[
  94 $validator->hostnameValidator->setValidateIdn(false);
  95 ]]>
  96     </programlisting>
  97
  98         关于 <code>setValidateIdn()</code> 更多的信息在<code>Zend_Validate_Hostname</code> 文档中。
  99     </para>
 100
 101     <para>
 102         请注意你有你允许DNS 主机名被校验，国际域名（IDNs）才被校验。
 103     </para>
 104
 105     <para>
 106         <emphasis role="strong">校验顶级域名</emphasis>
 107     </para>
 108
 109     <para>
 110        缺省地用已知的TLDs列表来检查主机名。你可以通过用存在于<code>Zend_Validate_EmailAddress</code> 中的内部的 <code>Zend_Validate_Hostname</code> 对象来改变设置来禁止。
 111     <programlisting role="php"><![CDATA[
 112 $validator->hostnameValidator->setValidateTld(false);
 113 ]]>
 114     </programlisting>
 115
 116         关于 <code>setValidateTld()</code> 更多的信息在<code>Zend_Validate_Hostname</code> 文档中。
 117     </para>
 118
 119     <para>
 120         请注意你有你允许DNS 主机名被校验，顶级域名（TLDs）才被校验。
 121     </para>
 122
 123 </sect2>
 124 <!--
 125 vim:se ts=4 sw=4 et:
 126 -->