<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.37 Maintainer: Qrak Status: ready -->
<!-- $Revision: 1.10 $ -->
 <reference id="ref.mail">
  <title>Poczta elektroniczna</title>
  <titleabbrev>Poczta</titleabbrev>
  <partintro>
   <simpara>
    Funkcja <function>mail</function> pozwala ci wysya listy e-mail.
   </simpara>
   <variablelist>
    <title>Dyrektywy konfiguracyjne poczty elektronicznej</title>

    <varlistentry id="ini.smtp">
     <term>
      <parameter>SMTP</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
       Adres w DNS-ie lub numer IP serwera SMTP, ktrego PHP pod Windowsem
       ma uy do wysania poczty za pomoc funkcji <function>mail</function>
      </para>
     </listitem>
    </varlistentry>

    <varlistentry id="ini.sendmail-from">
     <term>
      <parameter>sendmail_from</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
       Okrela adres pocztowy w polu "From:" w listach wysyanych z PHP pod
       Windowsem.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry id="ini.sendmail-path">
     <term>
      <parameter>sendmail_path</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
       Okrela, gdzie znajduje si program <command>sendmail</command>, zwykle
       <filename>/usr/sbin/sendmail</filename> lub 
       <filename>/usr/lib/sendmail</filename>
       <command>configure</command> prbuje samodzielnie zlokalizowa ten
       program i uczni go domylnym, ale w przypadku niepowodzenia, mona
       rcznie ustawi ciek za pomoc tej dyrektywy.
      </para>
      <para>
       W systemach nie uywajcych sendmaila, dyrektywa ta powinna wskazywa
       na program bdcy odpowiednikiem sendmaila, o ile jest taki program
       w tym systemie.
       Na przykad uytkownicy programu <ulink url="&url.qmail;">Qmail</ulink>
       mog ustawi ciek na <filename>/var/qmail/bin/sendmail</filename>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </partintro>

  <refentry id="function.mail">
   <refnamediv>
    <refname>mail</refname>
    <refpurpose>wylij e-maila</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>mail</methodname>
      <methodparam><type>string</type><parameter>do</parameter></methodparam>
      <methodparam><type>string</type><parameter>temat</parameter></methodparam>
      <methodparam><type>string</type><parameter>tre</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>dodatkowe_nagwki</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>dodatkowe_parametry
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>mail</function> automatycznie wysya wiadomo
     okrelon w <parameter>tre</parameter> do odbiorcy
     okrelonego w <parameter>do</parameter>. Mona wysa wiadomo do kilku
     odbiorcw na raz, wypisujc ich adresy po przecinku w argumencie
     <parameter>do</parameter>.  Poprzez t funkcj mona te wysa listy
     zawierajce zaczniki lub inne typy wiadomoci. Jest to moliwe dziki
     kodowaniu MIME - po wicej informacji, zajrzyj
     <ulink url="http://www.zend.com/zend/spotlight/sendmimeemailpart1.php"
     >http://www.zend.com/zend/spotlight/sendmimeemailpart1.php</ulink> lub
     <ulink url="&url.email.mime.pear;">Klasy Mime PEAR</ulink>.
    </simpara>
    <simpara>
       Ponisze RFC mog by przydatne:  
       <ulink url="&url.rfc1896;">RFC 1896</ulink>,  
       <ulink url="&url.rfc2045;">RFC 2045</ulink>,  
       <ulink url="&url.rfc2046;">RFC 2046</ulink>,  
       <ulink url="&url.rfc2047;">RFC 2047</ulink>,  
       <ulink url="&url.rfc2048;">RFC 2048</ulink> i  
       <ulink url="&url.rfc2049;">RFC 2049</ulink>.  
    </simpara> 
    <para>
     <function>mail</function> zwraca &true; jeli udao si wysa e-mail, lub
      &false; w przeciwnym wypadku.
    </para>
    <para>
     <example>
      <title>Wysyanie e-maila.</title>
      <programlisting>
<![CDATA[
mail("joecool@example.com", "Temat listu", "Linia 1\nLinia 2\nLinia 3");
]]>
      </programlisting>
     </example></para>
    <simpara>
     Jeli zostanie podany czwarty argument, bdzie on dopisany na kocu
     nagwka wiadomoci. Ten argument wykorzystuje si do wstawienia
     dodatkowych nagwkw.
     Dodatkowe nagwki rozdziela si znakiem powrotu karetki i nowego wiersza.
    </simpara>
    <note>
     <para>
     Aby rozdzieli nagwki, trzeba uy sekwencji <literal>\r\n</literal>,
     chocia niektre uniksowe agenty pocztowe obsuguj take pojedynczy
     znak nowej linii (<literal>\n</literal>). W nagwku Cc: jest rozrniana
     wielko liter i z tego powodu, w systemach Win32 musi by pisany jako
     <literal>Cc:</literal>. Nagwek Bcc: nie jest obsugiwany w systemach
     Win32.
     </para>
    </note>
    <para>
     <example>
      <title>Wysyanie listu z dodatkowymi nagwkami.</title>
      <programlisting>
<![CDATA[
mail("nobody@example.com", "temat", $message,
     "From: webmaster@$SERVER_NAME\r\n"
    ."Reply-To: webmaster@$SERVER_NAME\r\n"
    ."X-Mailer: PHP/" . phpversion());
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Argumentu <parameter>dodatkowe_parametry</parameter> uywa si do
     przekazania dodatkowych paramterw do programu wysyajcego poczt
     skonfigurowanego w dyrektywie <literal>sendmail_path</literal>.
     Uywa si tego na przykad do ustawienia adresu zwrotnego koperty 
     (envelope sender adress) przy wysyaniu
     listy za pomoc sendmaila. Moesz by zmuszony doda uytkownika jakim
     jest twj serwer www do listy zaufanych uytkownikw w pliku
     konfiguracyjnym sendmaila, aby sendmail nie doda nagwka "X-warning" do
     wiadomoci przy wysyaniu koperty (envelope) t metod.  
     <example>
      <title>Wysyanie listu z dodatkowymi nagwkami i przecznikami.</title>
      <programlisting>
<![CDATA[
mail("nobody@example.com", "temat", $message,
     "From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVER_NAME");
]]>
      </programlisting>
     </example>
     </para>
     <note>
      <para>
       Pity argument funkcji <function>mail</function> zosta dodany w 
       PHP 4.0.5.
      </para>
     </note>
     <para>
     Mona tez uy zwykych operacji na acuchach znakw do tworzenia
     zoonych wiadomoci e-mail.
     <example>
      <title>Wysyanie zoonego e-maila.</title>
      <programlisting>
<![CDATA[
/* adresaci */
$to  = "Mary <mary@example.com>" . ", " ; //zwrc uwag na przecinek
$to .= "Kelly <kelly@example.com>";

/* temat */
$subject = "Birthday Reminders for August";

/* wiadomo */
$message = '
<html>
<head>
 <title>Birthday Reminders for August</title>
</head>
<body>
<p>Here are the birthdays upcoming in August!</p>
<table>
 <tr>
  <th>Person</th><th>Day</th><th>Month</th><th>Year</th>
 </tr>
 <tr>
  <td>Joe</td><td>3rd</td><td>August</td><td>1970</td>
  <td>Sally</td><td>17th</td><td>August</td><td>1973</td>
 </tr>
</table>
</body>
</html>
';

/* Aby wysa e-mail w foramcie HTML, naley ustawi nagwek Content-type. */
$headers  = "MIME-Version: 1.0\r\n";
$headers .= "Content-type: text/html; charset=iso-8859-1\r\n";

/* dodatkowe nagwki */
$headers .= "From: Birthday Reminder <birthday@example.com>\r\n";

$headers .= "Cc: birthdayarchive@example.com\r\n";
$headers .= "Bcc: birthdaycheck@example.com\r\n";

/* a teraz wylij */
mail($to, $subject, $message, $headers);
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      Upewnij si, e nie ma adnych znakw nowej linii w argumencie
      <parameter>do</parameter> lub <parameter>temat</parameter>,
      gdy w przeciwnym razie, e-mail moe nie by wysany poprawnie.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.ezmlm-hash">
   <refnamediv>
    <refname>ezmlm_hash</refname>
    <refpurpose>Oblicza warto hash potrzebn dla EZMLM</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ezmlm_hash</methodname>
      <methodparam><type>string</type><parameter>adres_e-mail</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>ezmlm_hash</function> oblicza warto hash potrzebn
     przy przechowywaniu list adresatw programu EZMLM w bazie danych MySQL.
    </simpara>
    <para>
     <example>
      <title>Obliczanie wartoci hash i dodawanie nowego uytkownika</title>
      <programlisting>
<![CDATA[
$user = "joecool@example.com";
$hash = ezmlm_hash ($user);
$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
$db->query($query); // wykorzystanie interfejsu PHPLIB db
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->