1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243
|
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.mail">
<title>Funcii Mail</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
<simpara>
Funcia <function>mail</function> v permite s trimitei e-mail-uri
</simpara>
<variablelist>
<title>Directive de configurare ale funciei 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 funcia <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 cmpul "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 ctre 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 ntmpl putei seta calea n aceast directiv.
</para>
<para>
Pe sistemele care nu utilizeaz sendmail aceast directiv trebuie pentru a conine calea ctre programul care nlocuiete 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> ctre destinatarul specificat n <parameter>to</parameter>. Pot fi specificai mai muli destinatari, separnd adresele prin virgul n parametrul <parameter>to</parameter>. Pot fi trimise e-mail-uri cu fiiere ataate i cu tipuri speciale de coninut utiliznd aceast funcie. Aceasta se realizeaz prin codificare MIME; Pentru mai multe informaii vezi <ulink url="&url.email.mime.zend;">un articol ZEND</ulink> sau <ulink url="&url.email.mime.pear;">Clasele PEAR - MIME</ulink>.
</simpara>
<simpara>
Urmtoarele 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("joecool@example.com", "Subiectul", "Linia 1\nLinia 2\nLinia 3");
]]>
</programlisting>
</example></para>
<simpara>
Dac i cel de-al patrulea argument este trimis ctre funcie, acest ir este inserat la finalul antetului. Acest parametru se utilizeaz pentru a aduga antete adiionale. Antetele multiple se separ cu un nceput de rnd (<literal>\r</literal>) i cu o linie nou (<literal>\n</literal>).
</simpara>
<note>
<para>
Trebuie utilizat combinaia <literal>\r\n</literal> pentru separarea antetelor, cu toate c unii ageni de transfer mail din Unix pot lucra cu un singur caracter linie nou (<literal>\n</literal>). Antetul Cc: este sensibil la distincia 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 adiionale.</title>
<programlisting>
<![CDATA[
mail("nobody@example.com", "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 adiionali programului folosit pentru trimiterea de e-mail-uri specificat n <literal>sendmail_path</literal>. De exemplu aceti parametri adiionali pot fi folosii pentru a indica adresa expeditorului. Pentru a preveni trimiterea unui antet 'X-Warning' odat cu mesajul atunci cnd utilizai aceast metod este posibil s fie necesar s adugai utilizatorul care ruleaz serverul web.
<example>
<title>Expedierea de mesaje cu antete adiionale i setarea unui parametru linie de comand adiional.</title>
<programlisting>
<![CDATA[
mail("nimeni@exemplu.com", "subiectul", $mesaj,
"From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVER_NAME");
]]>
</programlisting>
</example>
</para>
<note>
<para>
Cel de-al cincilea parametru a fost adugat 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 <mary@example.com>" . ", " ; //notai virgula
$catre .= "Kelly <kelly@example.com>";
/* subiect */
$subiect = "Zile de natere n august";
/* mesaj */
$mesaj = '
<html>
<head>
<title>Zile de natere n august</title>
</head>
<body>
<p>Zile de natere care se srbtoresc 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 adiionale */
$antete .= "From: Monitorizare zile de nastere <birthday@example.com>\r\n";
$antete .= "Cc: birthdayarchive@example.com\r\n";
$antete .= "Bcc: birthdaycheck@example.com\r\n";
/* i acum s-i dm drumul... */
mail($catre, $subiect, $mesaj, $antete);
]]>
</programlisting>
</example>
</para>
<note>
<para>
Avei grij s nu fie vreun caracter linie nou (\n) n parametrii <parameter>to</parameter> sau <parameter>subject</parameter>, dac dorii 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 pstrarea listelor de e-mail EZMLM ntr-o baz de date MySQL.
</simpara>
<para>
<example>
<title>Calcularea valorii hash i adugarea unui utilizator nou.</title>
<programlisting>
<![CDATA[
$utilizator = "joecool@example.com";
$hash = ezmlm_hash ($user);
$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $utilizator);
$db->query($query); // utiliznd interfaa 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
-->
|