documentation/manual/zh/module_specs/Zend_Mail-Introduction.xml

   1 <sect1 id="zend.mail.introduction">
   2
   3     <title> 简介 </title>
   4
   5     <sect2 id="zend.mail.introduction.getting-started">
   6
   7         <title> 起步 </title>
   8
   9         <para>
  10             <code>Zend_Mail</code> 提供了通用化的功能来撰写和发送文本以及兼容 MIME 标准的含有多个段的邮件消息。邮件在 <code>Zend_Mail</code> 里通过缺省的 <code>Zend_Mail_Transport_Sendmail</code> 传输或通过 <code>Zend_Mail_Transport_Smtp</code> 来发送。
  11         </para>
  12
  13         <example id="zend.mail.introduction.example-1">
  14
  15             <title> 使用Zend_Mail发送简单邮件 </title>
  16
  17             <para>
  18                 一个简单邮件由一个或者几个收件人，一个主题，一个邮件主体和一个发件人组成。下面的步骤，使用 <code>Zend_Mail_Transport_Sendmail</code> 来发送邮件：
  19             </para>
  20
  21             <programlisting role="php"><![CDATA[<?php
  22 require_once 'Zend/Mail.php';
  23 $mail = new Zend_Mail();
  24 $mail->setBodyText('This is the text of the mail.');
  25 $mail->setFrom('somebody@example.com', 'Some Sender');
  26 $mail->addTo('somebody_else@example.com', 'Some Recipient');
  27 $mail->setSubject('TestSubject');
  28 $mail->send();]]>
  29             </programlisting>
  30
  31         </example>
  32
  33         <note>
  34             <title>Minimum definitions</title>
  35             <para>
  36                 使用<code>Zend_Mail</code>来发送邮件，你至少得指定一个收件人, 一个发件人(例如通过<code>setFrom()</code>方法)和一个邮件消息主体(文本 和/或者 HTML)。
  37             </para>
  38         </note>
  39
  40         <para>
  41             通过“get”方法可以读取绝大多数储存在“mail”对象中的邮件属性，更进一步的细节请参阅API文档。<code>getRecipients()</code>是一个特例，它返回一个含有所有先前被加入的收件人地址的数组。
  42         </para>
  43
  44         <para>
  45             出于安全原因，<code>Zend_Mail</code> 过滤了邮件头中所有字段，以防止基于换行符(<code>\n</code>)邮件头注入(header injection)漏洞攻击。
  46         </para>
  47
  48         <para>
  49             你也可以使用大部分带有方便的 fluent interface 的 <code>Zend_Mail</code> 对象的方法。 Fluent interface 意思是每个方法返回一个引用到它被调用的对象，所以你可以立即调用其它方法。
  50         </para>
  51
  52         <programlisting role="php"><![CDATA[<?php
  53 require_once 'Zend/Mail.php';
  54 $mail = new Zend_Mail();
  55 $mail->setBodyText('This is the text of the mail.')
  56     ->setFrom('somebody@example.com', 'Some Sender')
  57     ->addTo('somebody_else@example.com', 'Some Recipient')
  58     ->setSubject('TestSubject')
  59     ->send();]]>
  60         </programlisting>
  61
  62     </sect2>
  63
  64     <sect2 id="zend.mail.introduction.sendmail">
  65
  66         <title> 配置缺省的 sendmail 传送器（transport） </title>
  67
  68         <para>
  69             <code>Zend_Mail</code> 实例的缺省的传送器是 <code>Zend_Mail_Transport_Sendmail</code>，它是 PHP <ulink url="http://php.net/mail"><code>mail()</code></ulink> 函数的基本封装。如果你想传递另外的参数给 <ulink url="http://php.net/mail"><code>mail()</code></ulink>  函数，只需要创建一个新的传送器实例并传递参数给构造器。新的传送器实例可以当作缺省的 <code>Zend_Mail</code> 的传送器，或者它可以被传递给 <code>Zend_Mail</code> 的 <code>send()</code> 方法。
  70         </para>
  71
  72         <example id="zend.mail.introduction.sendmail.example-1">
  73
  74             <title> 传递另外的参数给 Zend_Mail_Transport_Sendmail 传送器 </title>
  75
  76             <para>
  77                 这个例子示范如何修改 <ulink url="http://php.net/mail"><code>mail()</code></ulink> 函数的返回路径。
  78             </para>
  79
  80             <programlisting role="php"><![CDATA[<?php
  81 require_once 'Zend/Mail.php';
  82 require_once 'Zend/Mail/Transport/Sendmail.php';
  83
  84 $tr = new Zend_Mail_Transport_Sendmail('-freturn_to_me@example.com');
  85 Zend_Mail::setDefaultTransport($tr);
  86
  87 $mail = new Zend_Mail();
  88 $mail->setBodyText('This is the text of the mail.');
  89 $mail->setFrom('somebody@example.com', 'Some Sender');
  90 $mail->addTo('somebody_else@example.com', 'Some Recipient');
  91 $mail->setSubject('TestSubject');
  92 $mail->send();]]>
  93             </programlisting>
  94
  95         </example>
  96
  97         <note>
  98             <title> 安全模式限制 </title>
  99             <para>
 100                 如果 PHP 运行在安全模式，另外的可选参数将导致 <ulink url="http://php.net/mail"><code>mail()</code></ulink> 函数失败。
 101             </para>
 102         </note>
 103
 104     </sect2>
 105
 106 </sect1>
 107 <!--
 108 vim:se ts=4 sw=4 et:
 109 -->