leszek Sun Dec 16 22:59:43 2001 EDT
Modified files:
/phpdoc/pl/functions mail.xml
Log:
Update
Index: phpdoc/pl/functions/mail.xml
diff -u phpdoc/pl/functions/mail.xml:1.3 phpdoc/pl/functions/mail.xml:1.4
--- phpdoc/pl/functions/mail.xml:1.3 Wed Dec 12 15:56:14 2001
+++ phpdoc/pl/functions/mail.xml Sun Dec 16 22:59:42 2001
@@ -1,12 +1,65 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<reference id="ref.mail">
<title>Funkcje obs�ugi poczty elektronicznej</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
<simpara>
- <function>mail</function> pozwala ci wysy�a� listy e-mail.
+ Funkcja <function>mail</function> pozwala ci wysy�a� 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, kt�rego PHP pod Windowsem
+ ma u�y� do wys�ania 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>
+ Okre�la adres pocztowy w polu "From:" w listach wysy�anych z PHP pod
+ Windowsem.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.sendmail-path">
+ <term>
+ <parameter>sendmail_path</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Okre�la, gdzie znajduje si� program <command>sendmail</command>, zwykle
+ <filename>/usr/sbin/sendmail</filename> lub
+ <filename>/usr/lib/sendmail</filename>
+ <command>configure</command> pr�buje samodzielnie zlokalizowa� ten
+ program i uczni� go domy�lnym, ale w przypadku niepowodzenia, mo�na
+ r�cznie ustawi� �cie�k� za pomoc� tej dyrektywy.
+ </para>
+ <para>
+ W systemach nie u�ywaj�cych sendmaila, dyrektywa ta powinna wskazywa�
+ na program b�d�cy odpowiednikiem sendmaila, o ile jest taki program
+ w tym systemie.
+ Na przyk�ad u�ytkownicy programu <ulink url="&url.qmail;">Qmail</ulink>
+ mog� ustawi� �cie�k� na <filename>/var/qmail/bin/sendmail</filename>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</partintro>
<refentry id="function.mail">
@@ -41,116 +94,132 @@
kodowaniu MIME - po wi�cej informacji, zajrzyj
<ulink url="http://www.zend.com/zend/spotlight/sendmimeemailpart1.php";
>http://www.zend.com/zend/spotlight/sendmimeemailpart1.php</ulink> lub
- RFC 1896 (Visit <ulink url="http://www.rfc-editor.org/";
- >http://www.rfc-editor.org/</ulink>).
+ <ulink url="&url.rfc1896;">RFC 1896</ulink>.
</simpara>
<para>
- <function>mail</function> zwraca &true; je�li uda�o si� wys�a� e-mail, w
- przeciwnym wypadku zwraca &false;.
+ <function>mail</function> zwraca &true; je�li uda�o si� wys�a� e-mail, lub
+ &false; w przeciwnym wypadku.
</para>
<para>
<example>
<title>Wysy�anie e-maila.</title>
<programlisting>
-mail("[EMAIL PROTECTED]", "Temat listu", "Linia 1\nLinia 2\nLinia 3");
+<![CDATA[
+mail("[EMAIL PROTECTED]", "Temat listu", "Linia 1\nLinia 2\nLinia 3");
+]]>
</programlisting>
</example></para>
<simpara>
Je�li zostanie podany czwarty argument, b�dzie on dopisany na ko�cu
nag��wka wiadomo�ci. Ten argument wykorzystuje si� do wstawienia
dodatkowych nag��wk�w.
- Dodatkowe nag��wki rozdziela si� znakiem nowego wiersza.
+ Dodatkowe nag��wki rozdziela si� znakiem powrotu karetki i nowego wiersza.
</simpara>
<note>
<para>
- W systemach Win32, trzeba u�y� <literal>\r\n</literal> aby
- rozdzieli� nag��wki. Nale�y tak�e zwr�ci� uwag� na nag��wki cc: i bcc:,
- przy kt�rych rozr�niana jest wielko�� liter i z tego powodu, w systemach
- Win32 powinny by� pisane jako <literal>Cc:</literal>
- i <literal>Bcc:</literal>.
+ Aby rozdzieli� nag��wki, trzeba u�y� sekwencji <literal>\r\n</literal>,
+ chocia� niekt�re uniksowe agenty pocztowe obs�uguj� tak�e pojedynczy
+ znak nowej linii (<literal>\n</literal>). W nag��wku Cc: jest rozr�niana
+ wielko�� liter i z tego powodu, w systemach Win32 musi by� pisany jako
+ <literal>Cc:</literal>. Nag��wek Bcc: nie jest obs�ugiwany w systemach
+ Win32.
</para>
</note>
- <simpara>
- Po podaniu pi�tego argumentu, PHP doda jego zawarto�� do wywo�ania
- serwera poczty wychodz�cej (mailera). Potrzebne jest to do prawid�owego
- ustawienia nag��wka Return-Path przy wysy�aniu za pomoc� programu sendmail.
- </simpara>
<para>
<example>
<title>Wysy�anie listu z dodatkowymi nag��wkami.</title>
<programlisting>
-mail("[EMAIL PROTECTED]", "the subject", $message,
- "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer:
- PHP/" . phpversion());
+<![CDATA[
+mail("[EMAIL PROTECTED]", "temat", $message,
+ "From: webmaster@$SERVER_NAME\r\n"
+ ."Reply-To: webmaster@$SERVER_NAME\r\n"
+ ."X-Mailer: PHP/" . phpversion());
+]]>
</programlisting>
</example>
- Za pomoc� pi�tego argumentu mo�na wys�a� dodatkowe parametry do serwera
- poczty wychodz�cej. W poni�szym przyk�adzie ustawiamy w�a�ciwy nag��wek
- Return-Path dla sendmaila. Normalnie sendmail doda nag��wek
- X-Authentication-Warning po u�yciu parametru -f, poniewa� serwer www
- prawdopodobnie nie zalicza si� do zaufanych u�ytkownik�w. Aby pozby� si�
- powy�szego ostrze�enia, nale�y doda� serwer www do listy zaufanych
- u�ytkownik�w w pliku konfiguracyjnym sendmaila.
</para>
- <note>
- <para>
- Pi�ty argument dodano w PHP 4.0.5.
- </para>
- </note>
<para>
+ Argumentu <parameter>dodatkowe_parametry</parameter> u�ywa si� do
+ przekazania dodatkowych paramter�w do programu wysy�aj�cego poczt�
+ skonfigurowanego w dyrektywie <literal>sendmail_path</literal>.
+ U�ywa si� tego na przyk�ad do ustawienia adresu zwrotnego koperty
+ (envelope sender adress) przy wysy�aniu
+ listy za pomoc� sendmaila. Mo�esz by� zmuszony doda� u�ytkownika jakim
+ jest tw�j serwer www do listy zaufanych u�ytkownik�w w pliku
+ konfiguracyjnym sendmaila, aby sendmail nie doda� nag��wka "X-warning" do
+ wiadomo�ci przy wysy�aniu koperty (envelope) t� metod�.
<example>
<title>Wysy�anie listu z dodatkowymi nag��wkami i prze��cznikami.</title>
<programlisting>
-mail("[EMAIL PROTECTED]", "the subject", $message,
+<![CDATA[
+mail("[EMAIL PROTECTED]", "temat", $message,
"From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVER_NAME");
+]]>
</programlisting>
</example>
+ </para>
+ <note>
+ <para>
+ Pi�ty argument funkcji <function>mail</function> zosta� dodany w
+ PHP 4.0.5.
+ </para>
+ </note>
+ <para>
Mo�na tez u�y� zwyk�ych operacji na �a�cuchach znak�w do tworzenia
z�o�onych wiadomo�ci e-mail.
<example>
<title>Wysy�anie z�o�onego e-maila.</title>
<programlisting>
+<![CDATA[
/* adresaci */
-$recipient .= "Mary <[EMAIL PROTECTED]>" . ", " ; //zwr�� uwag� na przecinek
-$recipient .= "Kelly <[EMAIL PROTECTED]>" . ", ";
-$recipient .= "[EMAIL PROTECTED]";
+$to = "Mary <[EMAIL PROTECTED]>" . ", " ; //zwr�c uwag� na przecinek
+$to .= "Kelly <[EMAIL PROTECTED]>";
/* temat */
$subject = "Birthday Reminders for August";
/* wiadomo�� */
-$message .= "The following email includes a formatted ASCII table\n";
-$message .= "Day \t\tMonth \t\tYear\n";
-$message .= "3rd \t\tAug \t\t1970\n";
-$message .= "17rd\t\tAug \t\t1973\n";
-
-/* mo�na doda� sygnatur� rozdzielaj�c� */
-$message .= "--\r\n"; //sygnatura rozdzielaj�ca
-$message .= "Birthday reminder copylefted by public domain";
-
-/* dodatkowe nag��wki na okoliczno�� b��d�w, From cc, bcc, itp. */
-
-$headers .= "From: Birthday Reminder <[EMAIL PROTECTED]>\n";
-$headers .= "X-Sender: <[EMAIL PROTECTED]>\n";
-$headers .= "X-Mailer: PHP\n"; // program pocztowy
-$headers .= "X-Priority: 1\n"; // wa�na wiadomo��!
-$headers .= "Return-Path: <[EMAIL PROTECTED]>\n"; // adres zwrotny dla b��d�w
+$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 wys�a� e-mail w foramcie HTML, nale�y ustawi� nag��wek Content-type. */
+$headers = "MIME-Version: 1.0\r\n";
+$headers .= "Content-type: text/html; charset=iso-8859-1\r\n";
-/* Je�li chcesz wys�a� list w formacie html, odkomentuj poni�sze linie */
-// $headers .= "Content-Type: text/html; charset=iso-8859-1\n"; // typy MIME
+/* dodatkowe nag��wki */
+$headers .= "From: Birthday Reminder <[EMAIL PROTECTED]>\r\n";
-$headers .= "cc: [EMAIL PROTECTED]\n"; // CC do kogo
-$headers .= "bcc: [EMAIL PROTECTED], [EMAIL PROTECTED]"; // BCC do kogo
+$headers .= "Cc: [EMAIL PROTECTED]\r\n";
+$headers .= "Bcc: [EMAIL PROTECTED]\r\n";
/* a teraz wy�lij */
-mail($recipient, $subject, $message, $headers);
+mail($to, $subject, $message, $headers);
+]]>
</programlisting>
</example>
</para>
<note>
<para>
- Upewnij si�, �e nie ma nowej linii (ani spacji) po argumentach do lub
- temat, bo mo�e to wywo�ywa� dziwne rezultaty.
+ Upewnij si�, �e nie ma �adnych znak�w nowej linii w argumencie
+ <parameter>do</parameter> lub <parameter>temat</parameter>,
+ gdy� w przeciwnym razie, e-mail mo�e nie by� wys�any poprawnie.
</para>
</note>
</refsect1>
@@ -177,10 +246,12 @@
<example>
<title>Obliczanie warto�ci hash i dodawanie nowego u�ytkownika</title>
<programlisting>
-$user = "[EMAIL PROTECTED]";
+<![CDATA[
+$user = "[EMAIL PROTECTED]";
$hash = ezmlm_hash ($user);
$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
$db->query($query); // wykorzystanie interfejsu PHPLIB db
+]]>
</programlisting>
</example>
</para>
