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

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