added mail

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@135462 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Dimitris Glezos 2003-07-20 00:09:10 +00:00
parent fb9e19da70
commit 23df05bb25
2 changed files with 69 additions and 67 deletions

View file

@ -1,24 +1,25 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<?xml version="1.0" encoding="iso-8859-7"?>
<!-- $Revision: 1.10 $ -->
<!-- En-Revision: 1.9 Maintainer: legionnaire Status: ready -->
<!-- splitted from ./en/functions/mail.xml, last change in rev 1.6 -->
<refentry id="function.ezmlm-hash">
<refnamediv>
<refname>ezmlm_hash</refname>
<refpurpose>Calculate the hash value needed by EZMLM</refpurpose>
<refpurpose>Υπολογίζει την τιμή hash που απαιτείται από το EZMLM</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Περιγραφή</title>
<methodsynopsis>
<type>int</type><methodname>ezmlm_hash</methodname>
<methodparam><type>string</type><parameter>addr</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>ezmlm_hash</function> calculates the hash value needed
when keeping EZMLM mailing lists in a MySQL database.
Η <function>ezmlm_hash</function> υπολογίζει την τιμή hash που απαιτείται
κατά την διατήρηση EZMLM mailing lists σε μια MySQL database.
</simpara>
<para>
<example>
<title>Calculating the hash and subscribing a user</title>
<title>Υπολογίζοντας το hash και εγγράφοντας ένα χρήστη</title>
<programlisting>
<![CDATA[
$user = "joecool@example.com";

View file

@ -1,13 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.17 $ -->
<?xml version="1.0" encoding="iso-8859-7"?>
<!-- $Revision: 1.18 $ -->
<!-- En-Revision: 1.17 Maintainer: legionnaire Status: ready -->
<!-- splitted from ./en/functions/mail.xml, last change in rev 1.2 -->
<refentry id="function.mail">
<refnamediv>
<refname>mail</refname>
<refpurpose>send mail</refpurpose>
<refpurpose>Αποστολή mail</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<title>Περιγραφή</title>
<methodsynopsis>
<type>bool</type><methodname>mail</methodname>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
@ -17,19 +18,19 @@
<methodparam choice="opt"><type>string</type><parameter>additional_parameters</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>mail</function> automatically mails the message
specified in <parameter>message</parameter> to the receiver
specified in <parameter>to</parameter>. Multiple recipients can
be specified by putting a comma between each address in
<parameter>to</parameter>. Email with attachments and special
types of content can be sent using this function. This is
accomplished via MIME-encoding - for more information, see this
Η <function>mail</function> αυτομάτα στέλνει με mail το μήνυμα
όπως ορίζεται στο <parameter>message</parameter> στον παραλήπτη
όπως ορίζεται στο <parameter>to</parameter>. Πολλαπλοί παραλήπτες μπορούν
να οριστούν με την προσθήκη ενός κόμματος ανάμεσα σε κάθε διεύθυνση στο
<parameter>to</parameter>. Email με συννημένα αρχεία και ειδικούς
τύπους περιεχομένου μπορούν να αποσταλούν με την χρήση αυτής της συνάρτησης. Αυτό πραγματοποιείται
μέσω MIME-κωδικοποίησης - για περισσότερες πληροφορίες, δείτε αυτό:
<ulink url="&url.email.mime.zend;">
Zend article</ulink> or the <ulink url="&url.email.mime.pear;">
το άρθρο Zend</ulink> ή τις<ulink url="&url.email.mime.pear;">
PEAR Mime Classes</ulink>.
</simpara>
<simpara>
The following RFC's may also be useful:
Τα παρακάτω RFC's μπορούν επισής να βοηθήσουν:
<ulink url="&url.rfc;1896">RFC 1896</ulink>,
<ulink url="&url.rfc;2045">RFC 2045</ulink>,
<ulink url="&url.rfc;2046">RFC 2046</ulink>,
@ -38,29 +39,29 @@
<ulink url="&url.rfc;2049">RFC 2049</ulink>.
</simpara>
<para>
<function>mail</function> returns &true; if the mail was successfully
accepted for delivery, &false; otherwise.
Η <function>mail</function> επιστρέφει &true; εάν το mail παραδόθηκε
επιτυχώς, &false; σε αντίθετη περίπτωση.
</para>
<warning>
<para>
The Windows implementation of <function>mail</function> differs in many
ways from the Unix implementation. First, it doesn't use a local binary
for composing messages but only operates on direct sockets which means a
<literal>MTA</literal> is needed listening on a network socket (which
can either on the localhost or a remote machine). Second, the custom
headers like <literal>From:</literal>, <literal>Cc:</literal>,
<literal>Bcc:</literal> and <literal>Date:</literal> are <emphasis
role="strong">not</emphasis> interpreted by the <literal>MTA</literal>
in the first place, but are parsed by <literal>PHP</literal>.
<literal>PHP</literal> &lt; 4.3 only supported the <literal>Cc:</literal>
header element (and was case-sensitive). <literal>PHP</literal> &gt;= 4.3
supports all the mentioned header elements and is no longer
Η εγκατάσταση στα Windows της <function>mail</function> διαφέρει ποικιλοτρόπως
από την αντίστοιχη στο UNIX. Καταρχήν, δεν χρησιμοποιεί ένα τοπικό binary αρχείο
για να συνθέτει μηνύματα αλλά μόνο ενεργεί σε direct sockets που σημαίνει ότι ένα
<literal>MTA</literal> απαιτείται που θα "ακούει" σε ένα network socket (το οποίο
μπορεί να είναι είτε στο localhost -τοπικά- είτε στο απομακρυσμένο μηχάνημα). Έπειτα, τα custom
headers όπως <literal>From:</literal>, <literal>Cc:</literal>,
<literal>Bcc:</literal> και <literal>Date:</literal> <emphasis
role="strong">δεν</emphasis> ερμηνεύονται από το <literal>MTA</literal>
στην αρχή, αλλά αναλύονται από την <literal>PHP</literal>.
Η <literal>PHP</literal> &lt; 4.3 υποστήριζε μόνο το στοιχείο header <literal>Cc:</literal>
(και ήταν case-sensitive). Η <literal>PHP</literal> &gt;= 4.3
υποστηρίζει όλα τα προαναφερθέντα στοιχεία header και δεν είναι πλέον
case-sensitive.
</para>
</warning>
<para>
<example>
<title>Sending mail.</title>
<title>Στέλνοντας mail.</title>
<programlisting>
<![CDATA[
<?php
@ -71,21 +72,21 @@ mail("joecool@example.com", "My Subject", "Line 1\nLine 2\nLine 3");
</example>
</para>
<simpara>
If a fourth string argument is passed, this string is inserted at
the end of the header. This is typically used to add extra
headers. Multiple extra headers are separated with a carriage return
and newline.
Εάν περαστεί ένα fourth string argument, αυτό το string εισάγεται στο
τέλος του header. Αυτό χρησιμοποιείται κυρίως για να προστεθούν επιπλέον
headers. Πολλαπλοί επιπλέον headers χωρίζονται με ένα return (enter)
και μια νέα γραμμή.
</simpara>
<note>
<para>
You must use <literal>\r\n</literal> to separate headers, although
some Unix mail transfer agents may work with just a single newline
Πρέπει να χρησιμοποιείτε το <literal>\r\n</literal> για να χωρίζετε τα headers, αν και
κάποιοι Unix mail transfer agents ενδέχεται να δουλεύουν μόνο με μιά νέα γραμμή
(<literal>\n</literal>).
</para>
</note>
<para>
<example>
<title>Sending mail with extra headers.</title>
<title>Στέλνοντας mail με επιπλέον headers.</title>
<programlisting>
<![CDATA[
<?php
@ -99,17 +100,17 @@ mail("nobody@example.com", "the subject", $message,
</example>
</para>
<para>
The <parameter>additional_parameters</parameter> parameter
can be used to pass an additional parameter to the program configured
to use when sending mail using the <literal>sendmail_path</literal>
configuration setting. For example, this can be used to set the
envelope sender address when using sendmail with the
<literal>-f</literal> sendmail option. You may need to add
the user that your web server runs as to your sendmail configuration
to prevent a 'X-Warning' header from being added to the message when
you set the envelope sender using this method.
Η παράμετρος <parameter>additional_parameters</parameter>
μπορεί να χρησιμοποιηθεί για να περαστεί μια επιπρόσθετη παράμετρος στο πρόγραμμα, το οποίο έχει ρυθμιστεί
να χρησιμοποιεί όταν στέλνεται mail με χρήση της <literal>sendmail_path</literal>
ρύθμισης. Για παράδειγμα, αυτό μπορεί να χρησιμοποιηθεί για να ορίσει
την διεύθυνση του αποστολέα όταν γίνεται χρήση του sendmail με την επιλογή
<literal>-f</literal>. Ίσως χρειαστεί να προσθέσετε
τον χρήστη, που ο web server σας χρησιμοποιεί σύμφωνα με τις ρυθμίσεις του sendmail,
για να αποτρέψετε να προστεθεί στο μήνυμα ένα 'X-Warning' header όταν
ορίζετε τον αποστολέα με αυτή τη μέθοδο.
<example>
<title>Sending mail with extra headers and setting an additional command line parameter.</title>
<title>Στέλνοντας mail με επιπλέον headers και ορίζοντας μια επιπρόσθετη command line παράμετρο.</title>
<programlisting>
<![CDATA[
<?php
@ -122,17 +123,17 @@ mail("nobody@example.com", "the subject", $message,
</para>
<note>
<para>
This fifth parameter was added in PHP 4.0.5. Since PHP 4.2.3 this
parameter is disabled in <link linkend="ini.safe-mode">safe_mode</link>
and the <function>mail</function> function will expose a warning message
and return &false; if you're trying to use it.
Αυτή η πέμπτη παράμετρος προστέθηκε στην PHP 4.0.5. Από την PHP 4.2.3 αυτή
η παράμετρος είναι απενεργοποιημένη στο <link linkend="ini.safe-mode">safe_mode</link>
και η συνάρτηση <function>mail</function> θα εμφανίσει ένα μήνυμα προηδοποιήσης
και θα επιστρέψει &false; εάν προσπαθείτε να την χρησιμοποιήσετε.
</para>
</note>
<para>
You can also use simple string building techniques to build complex
email messages.
Μπορείτε επίσης να χρησιμοποιήσετε απλές τεχνικές string building για να δημιουργήσετε πολύπλοκα
μηνύματα email.
<example>
<title>Sending complex email.</title>
<title>Στέλνοντας πολύπλοκα email.</title>
<programlisting>
<![CDATA[
<?php
@ -185,21 +186,21 @@ mail($to, $subject, $message, $headers);
</para>
<note>
<para>
Make sure you do not have any newline characters in the
<parameter>to</parameter> or <parameter>subject</parameter>,
or the mail may not be sent properly.
Φροντίστε να μην έχετε τίποτα newline χαρακτήρες στο
<parameter>to</parameter> ή <parameter>subject</parameter>,
διαφορετικά το mail ίσως να μην σταλεί σωστά.
</para>
</note>
<note>
<para>
The <parameter>to</parameter> parameter cannot be an address
in the form of &quot;Something &lt;someone@example.com&gt;&quot;. The
mail command will not parse this properly while talking with
the MTA.
Η <parameter>to</parameter> παράμετρος δεν μπορεί να είναι μια διεύθυνση
της μορφής &quot;Something &lt;someone@example.com&gt;&quot;. Η
εντολή mail δεν θα το αναλύσει σωστά κατά την επικοινωνία με το
MTA.
</para>
</note>
<para>
See also <function>imap_mail</function>.
Δείτε επίσης <function>imap_mail</function>.
</para>
</refsect1>
</refentry>