cvs: phpdoc /pl/functions mail.xml

From: Date: Mon, 17 Dec 2001 03:59:43 +0000
Subject: cvs: phpdoc /pl/functions mail.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969339896@lists.php.net to get a copy of this message
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("rasmus@lerdorf.on.ca", "Temat listu", "Linia 1\nLinia 2\nLinia 3"); +<![CDATA[ +mail("joecool@example.com", "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("nobody@aol.com", "the subject", $message, - "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: - PHP/" . phpversion()); +<![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> - 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("nobody@aol.com", "the subject", $message, +<![CDATA[ +mail("nobody@example.com", "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 &lt;mary@u.college.edu>" . ", " ; //zwróæ uwagê na przecinek -$recipient .= "Kelly &lt;kelly@u.college.edu>" . ", "; -$recipient .= "ronabop@php.net"; +$to = "Mary <mary@example.com>" . ", " ; //zwróc uwagê na przecinek +$to .= "Kelly <kelly@example.com>"; /* 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 &lt;birthday@php.net>\n"; -$headers .= "X-Sender: &lt;birthday@php.net>\n"; -$headers .= "X-Mailer: PHP\n"; // program pocztowy -$headers .= "X-Priority: 1\n"; // wa¿na wiadomo¶æ! -$headers .= "Return-Path: &lt;birthday@php.net>\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 <birthday@example.com>\r\n"; -$headers .= "cc: birthdayarchive@php.net\n"; // CC do kogo -$headers .= "bcc: birthdaycheck@php.net, birthdaygifts@php.net"; // BCC do kogo +$headers .= "Cc: birthdayarchive@example.com\r\n"; +$headers .= "Bcc: birthdaycheck@example.com\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 = "kris@koehntopp.de"; +<![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>
« previous php.doc (#969339896) next »