1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118
|
<sect1 id="zend.mail.introduction">
<title>Wprowadzenie</title>
<sect2 id="zend.mail.introduction.getting-started">
<title>Getting started</title>
<para>
<code>Zend_Mail</code> zapewnia możliwość tworzenia i wysyłania tekstowych
wiadomości e-mail oraz wieloczęściowych wiadomości e-mail zgodnych z MIME.
Wiadomość może być wysłana przez <code>Zend_Mail</code> za pomocą
domyślnego transportu <code>Zend_Mail_Transport_Sendmail</code> lub
za pomocą <code>Zend_Mail_Transport_Smtp</code>.
</para>
<example id="zend.mail.introduction.example-1">
<title>Wysyłanie prostego e-maila za pomocą Zend_Mail</title>
<para>
Prosty e-mail składa się z odbiorców, z tematu, treści i z nadawcy.
Aby wysłać taki e-mail używając <code>Zend_Mail_Transport_Sendmail</code>
możesz zrobić to w ten sposób:
</para>
<programlisting role="php"><![CDATA[
$mail = new Zend_Mail();
$mail->setBodyText('Treść wiadomości e-mail.');
$mail->setFrom('somebody@example.com', 'Nadawca');
$mail->addTo('somebody_else@example.com', 'Odbiorca');
$mail->setSubject('Testowy Temat');
$mail->send();
]]>
</programlisting>
</example>
<note>
<title>Minimalne definicje</title>
<para>
Aby wysłać e-mail za pomocą <code>Zend_Mail</code> musisz określić chociaż
jednego odbiorcę, nadawcę (np., za pomocą <code>setFrom()</code>), i treść
wiadomości (tekst i/lub HTML).
</para>
</note>
<para>
Dla większości atrybutów obiektu mail są dostępne metody "get" w służące do
odczytywania przechowywanych w nim informacji. Więcej informacji można znaleść
w dokumentacji API. Specjalną metodą jest <code>getRecipients()</code>. Zwraca
ona tablicę w wszystkimi adresami e-mail odbiorców, które zostały dodane.
</para>
<para>
Ze względów bezpieczeństwa, <code>Zend_Mail</code> filtruje wszystkie nagłówki
aby zapobiec dołączeniu niechcianych nagłówków za pomocą znaku nowej linii
(<code>\n</code>).
</para>
<para>
You also can use most methods of the <code>Zend_Mail</code> object with a convenient fluent interface. A fluent
interface means that each method returns a reference to the object on which it was called, so you can
immediately call another method.
</para>
<programlisting role="php"><![CDATA[
$mail = new Zend_Mail();
$mail->setBodyText('This is the text of the mail.')
->setFrom('somebody@example.com', 'Some Sender')
->addTo('somebody_else@example.com', 'Some Recipient')
->setSubject('TestSubject')
->send();
]]>
</programlisting>
</sect2>
<sect2 id="zend.mail.introduction.sendmail">
<title>Configuring the default sendmail transport</title>
<para>
The default transport for a <code>Zend_Mail</code> instance is <code>Zend_Mail_Transport_Sendmail</code>.
It is essentially a wrapper to the PHP <ulink url="http://php.net/mail"><code>mail()</code></ulink> function.
If you wish to pass additional parameters to the <ulink url="http://php.net/mail"><code>mail()</code></ulink> function,
simply create a new transport instance and pass your parameters to the constructor. The new transport instance
can then act as the default <code>Zend_Mail</code> transport, or it can be passed to the <code>send()</code>
method of <code>Zend_Mail</code>.
</para>
<example id="zend.mail.introduction.sendmail.example-1">
<title>Passing additional parameters to the Zend_Mail_Transport_Sendmail transport</title>
<para>
This example shows how to change the Return-Path of the <ulink url="http://php.net/mail"><code>mail()</code></ulink>
function.
</para>
<programlisting role="php"><![CDATA[
$tr = new Zend_Mail_Transport_Sendmail('-freturn_to_me@example.com');
Zend_Mail::setDefaultTransport($tr);
$mail = new Zend_Mail();
$mail->setBodyText('This is the text of the mail.');
$mail->setFrom('somebody@example.com', 'Some Sender');
$mail->addTo('somebody_else@example.com', 'Some Recipient');
$mail->setSubject('TestSubject');
$mail->send();
]]>
</programlisting>
</example>
<note>
<title>Safe mode restrictions</title>
<para>
The optional additional parameters will be cause the <ulink url="http://php.net/mail"><code>mail()</code></ulink> function to fail
if PHP is running in safe mode.
</para>
</note>
</sect2>
</sect1>
|