adiju Sat Feb 16 03:54:44 2002 EDT
Added files:
/phpdoc/ro/functions mail.xml
Log:
First romanian version of Mail functions.
Index: phpdoc/ro/functions/mail.xml
+++ phpdoc/ro/functions/mail.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.mail">
<title>Func�ii Mail</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
<simpara>
Func�ia <function>mail</function> v� permite s� trimite�i e-mail-uri
</simpara>
<variablelist>
<title>Directive de configurare ale func�iei Mail</title>
<varlistentry id="ini.smtp">
<term>
<parameter>SMTP</parameter>
<type>string</type>
</term>
<listitem>
<para>
Numele DNS sau adresa IP a serverului SMTP pe care versiunea pentru Windows a
PHP trebuie s� o foloseasc� pentru a trimite e-mail-uri cu func�ia
<function>mail</function>.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.sendmail-from">
<term>
<parameter>sendmail_from</parameter>
<type>string</type>
</term>
<listitem>
<para>
Adresa de e-mail care va fi utilizat� �n c�mpul "From:" la trimiterea de
e-mail-uri �n versiunea Windows a PHP.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.sendmail-path">
<term>
<parameter>sendmail_path</parameter>
<type>string</type>
</term>
<listitem>
<para>
Calea c�tre programul <command>sendmail</command>, de regul�
<filename>/usr/sbin/sendmail</filename> sau <filename>/usr/lib/sendmail</filename>
<command>configure</command> �ncearc� s�-l localizeze �i s�-l seteze ca implicit, dar
dac� acest lucru nu se �nt�mpl� pute�i seta calea �n aceast� directiv�.
</para>
<para>
Pe sistemele care nu utilizeaz� sendmail aceast� directiv� trebuie pentru a
con�ine calea c�tre programul care �nlocuie�te sendmail, dac� exist� vreunul. De
exemplu, cei care utilizeaz� <ulink url="&url.qmail;">Qmail</ulink> pot seta valoarea
directivei la <filename>/var/qmail/bin/sendmail</filename>.
</para>
</listitem>
</varlistentry>
</variablelist>
</partintro>
<refentry id="function.mail">
<refnamediv>
<refname>mail</refname>
<refpurpose>trimite mail</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>bool</type><methodname>mail</methodname>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
<methodparam><type>string</type><parameter>subject</parameter></methodparam>
<methodparam><type>string</type><parameter>message</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>additional_headers</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>additional_parameters
</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>mail</function> trimite automat mesajele specificate �n
<parameter>message</parameter> c�tre destinatarul specificat �n
<parameter>to</parameter>. Pot fi specifica�i mai mul�i destinatari, separ�nd adresele
prin virgul� �n parametrul <parameter>to</parameter>. Pot fi trimise e-mail-uri cu
fi�iere ata�ate �i cu tipuri speciale de con�inut utiliz�nd aceast� func�ie. Aceasta
se realizeaz� prin codificare MIME; Pentru mai multe informa�ii vezi <ulink
url="&url.email.mime.zend;">un articol ZEND</ulink> sau <ulink
url="&url.email.mime.pear;">Clasele PEAR - MIME</ulink>.
</simpara>
<simpara>
Urm�toarele RFC-uri pot fi, de asemenea, folositoare:
<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> returneaz� &true; dac� mailul a fost trimis cu succes,
&false; �n caz contrar.
</para>
<para>
<example>
<title>Trimiterea unui e-mail.</title>
<programlisting>
<![CDATA[
mail("[EMAIL PROTECTED]", "Subiectul", "Linia 1\nLinia 2\nLinia 3");
]]>
</programlisting>
</example></para>
<simpara>
Dac� �i cel de-al patrulea argument este trimis c�tre func�ie, acest �ir este
inserat la finalul antetului. Acest parametru se utilizeaz� pentru a ad�uga antete
adi�ionale. Antetele multiple se separ� cu un �nceput de r�nd (<literal>\r</literal>)
�i cu o linie nou� (<literal>\n</literal>).
</simpara>
<note>
<para>
Trebuie utilizat� combina�ia <literal>\r\n</literal> pentru separarea antetelor,
cu toate c� unii agen�i de transfer mail din Unix pot lucra cu un singur caracter
linie nou� (<literal>\n</literal>). Antetul Cc: este sensibil la distinc�ia
majuscule/minuscule �i trebuie scris <literal>Cc:</literal> pe sisteme Win32. Antetul
Bcc: nu este suportat pe sistemele Win32.
</para>
</note>
<para>
<example>
<title>Trimiterea de mail-uri cu antete adi�ionale.</title>
<programlisting>
<![CDATA[
mail("[EMAIL PROTECTED]", "subiectul", $mesaj,
"From: webmaster@$NUME_SERVER\r\n"
."Reply-To: webmaster@$NUME_SERVER\r\n"
."X-Mailer: PHP/" . phpversion());
]]>
</programlisting>
</example>
</para>
<para>
<parameter>additional_parameters</parameter> poate fi utilizat pentru a trimite
parametri adi�ionali programului folosit pentru trimiterea de e-mail-uri specificat �n
<literal>sendmail_path</literal>. De exemplu ace�ti parametri adi�ionali pot fi
folosi�i pentru a indica adresa expeditorului. Pentru a preveni trimiterea unui antet
'X-Warning' odat� cu mesajul atunci c�nd utiliza�i aceast� metod� este posibil s� fie
necesar s� ad�uga�i utilizatorul care ruleaz� serverul web.
<example>
<title>Expedierea de mesaje cu antete adi�ionale �i setarea unui parametru linie
de comand� adi�ional.</title>
<programlisting>
<![CDATA[
mail("[EMAIL PROTECTED]", "subiectul", $mesaj,
"From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVER_NAME");
]]>
</programlisting>
</example>
</para>
<note>
<para>
Cel de-al cincilea parametru a fost ad�ugat �n PHP 4.0.5.
</para>
</note>
<para>
Se pot utiliza �iruri simple pentru a constru mesaje de e-mail complexe.
<example>
<title>Expedierea de mesaje complexe.</title>
<programlisting>
<![CDATA[
/* destinatari */
$catre = "Mary <[EMAIL PROTECTED]>" . ", " ; //nota�i virgula
$catre .= "Kelly <[EMAIL PROTECTED]>";
/* subiect */
$subiect = "Zile de na�tere �n august";
/* mesaj */
$mesaj = '
<html>
<head>
<title>Zile de na�tere �n august</title>
</head>
<body>
<p>Zile de na�tere care se s�rb�toresc �n august!</p>
<table>
<tr>
<th>Persoana</th><th>Ziua</th><th>Luna</th><th>Anul</th>
</tr>
<tr>
<td>Joe</td><td>3</td><td>august</td><td>1970</td>
<td>Sally</td><td>17</td><td>august</td><td>1973</td>
</tr>
</table>
</body>
</html>
';
/* Pentru a trimite un e-mail �n format HTML trebuie setat antetul Content-type. */
$antete = "MIME-Version: 1.0\r\n";
$antete .= "Content-type: text/html; charset=iso-8859-1\r\n";
/* Antete adi�ionale */
$antete .= "From: Monitorizare zile de nastere <[EMAIL PROTECTED]>\r\n";
$antete .= "Cc: [EMAIL PROTECTED]\r\n";
$antete .= "Bcc: [EMAIL PROTECTED]\r\n";
/* �i acum s�-i d�m drumul... */
mail($catre, $subiect, $mesaj, $antete);
]]>
</programlisting>
</example>
</para>
<note>
<para>
Ave�i grij� s� nu fie vreun caracter linie nou� (\n) �n parametrii
<parameter>to</parameter> sau <parameter>subject</parameter>, dac� dori�i ca mesajul
s� fie trimis.
</para>
</note>
</refsect1>
</refentry>
<refentry id="function.ezmlm-hash">
<refnamediv>
<refname>ezmlm_hash</refname>
<refpurpose>Calculeaz� valoarea hash cerut� de EZMLM</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>int</type><methodname>ezmlm_hash</methodname>
<methodparam><type>string</type><parameter>addr</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>ezmlm_hash</function> calculeaz� valoarea hash necesar� pentru
p�strarea listelor de e-mail EZMLM �ntr-o baz� de date MySQL.
</simpara>
<para>
<example>
<title>Calcularea valorii hash �i ad�ugarea unui utilizator nou.</title>
<programlisting>
<![CDATA[
$utilizator = "[EMAIL PROTECTED]";
$hash = ezmlm_hash ($user);
$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $utilizator);
$db->query($query); // utiliz�nd interfa�a db a PHPLIB
]]>
</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
-->
