cvs: phpdoc-da /reference/mail/functions ezmlm-hash.xml mail.xml
[email protected] ("Jesper Laursen") Fri, 17 Jun 2005 21:53:54 -0000
| Newsgroups | php.doc.da |
|---|---|
| Message-ID | <cvslauer1119045234@cvsserver> |
lauer Fri Jun 17 17:53:54 2005 EDT
Modified files:
/phpdoc-da/reference/mail/functions ezmlm-hash.xml mail.xml
Log:
Sync with EN
lauer-20050617175354.txt
(text/plain, 23.4 KB)
http://cvs.php.net/diff.php/phpdoc-da/reference/mail/functions/ezmlm-hash.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-da/reference/mail/functions/ezmlm-hash.xml diff -u phpdoc-da/reference/mail/functions/ezmlm-hash.xml:1.1 phpdoc-da/reference/mail/functions/ezmlm-hash.xml:1.2 --- phpdoc-da/reference/mail/functions/ezmlm-hash.xml:1.1 Sat Oct 2 10:22:03 2004 +++ phpdoc-da/reference/mail/functions/ezmlm-hash.xml Fri Jun 17 17:53:51 2005 @@ -1,25 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.16 Maintainer: lauer Status: ready --> - <refentry id="function.ezmlm-hash"> - <refnamediv> - <refname>ezmlm_hash</refname> - <refpurpose>Beregner den hash-værdi EZMLM kræver</refpurpose> - </refnamediv> - <refsect1> - <title>Beskrivelse</title> - <methodsynopsis> - <type>int</type><methodname>ezmlm_hash</methodname> - <methodparam><type>string</type><parameter>addr</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>ezmlm_hash</function> beregner den hash-værdi deres skal bruges - for at beholde EZMLM mailinglister i en MySQL database. - </simpara> - <para> - <example> - <title>Beregner en hash og tilmelder en bruger</title> - <programlisting role="php"> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.18 Maintainer: lauer Status: ready --> +<refentry id="function.ezmlm-hash"> + <refnamediv> + <refname>ezmlm_hash</refname> + <refpurpose>Beregner den hash-værdi EZMLM kræver</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>ezmlm_hash</methodname> + <methodparam><type>string</type><parameter>addr</parameter></methodparam> + </methodsynopsis> + <simpara> + <function>ezmlm_hash</function> beregner den hash-værdi deres skal bruges + for at holde EZMLM mailinglister i en MySQL database. + </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>addr</parameter></term> + <listitem> + <para> + E-mailadressen der skal beregnes en hash-værdi på. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Hash-værdien af <parameter>addr</parameter>. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Beregner en hash og tilmelder en bruger</title> + <programlisting role="php"> <![CDATA[ <?php @@ -30,11 +58,11 @@ ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-da/reference/mail/functions/mail.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc-da/reference/mail/functions/mail.xml diff -u phpdoc-da/reference/mail/functions/mail.xml:1.10 phpdoc-da/reference/mail/functions/mail.xml:1.11 --- phpdoc-da/reference/mail/functions/mail.xml:1.10 Mon Dec 13 12:06:55 2004 +++ phpdoc-da/reference/mail/functions/mail.xml Fri Jun 17 17:53:51 2005 @@ -1,206 +1,408 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.29 Maintainer: lauer Status: ready --> - <refentry id="function.mail"> - <refnamediv> - <refname>mail</refname> - <refpurpose>Send mail</refpurpose> - </refnamediv> - <refsect1> - <title>Beskrivelse</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> sender automatisk en e-mail med beskeden angivet - i <parameter>message</parameter> til modtageren angivet i - <parameter>to</parameter>. Flere modtagere kan angives ved at indsætte - et komma mellem hver adresse i <parameter>to</parameter>. En e-mail med - vedhæftet fil og specielle typer af indhold, kan også sendes med denne - funktion. Dette er muligt ved hjælp af MIME-encoding - læs mere om det i - denne <ulink url="&url.email.mime.zend;"> - Zend artikel</ulink> eller i <ulink url="&url.pear.package;Mail_Mime"> - PEAR Mime Klasser</ulink>. - </simpara> - <simpara> - Følgende RFC artikler kan også være nyttige: - <ulink url="&url.rfc;1896">RFC 1896</ulink>, - <ulink url="&url.rfc;2045">RFC 2045</ulink>, - <ulink url="&url.rfc;2046">RFC 2046</ulink>, - <ulink url="&url.rfc;2047">RFC 2047</ulink>, - <ulink url="&url.rfc;2048">RFC 2048</ulink> og - <ulink url="&url.rfc;2049">RFC 2049</ulink>. - </simpara> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.33 Maintainer: lauer Status: ready --> +<refentry id="function.mail"> + <refnamediv> + <refname>mail</refname> + <refpurpose>Afsend email</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <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> + <para> + Sender en email. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>to</parameter></term> + <listitem> + <para> + Modtager eller modtagerne af mailen + </para> + <para> + Denne streng skal overholde <ulink url="&url.rfc;2822">RFC 2822</ulink>. + Et par eksempler:: + <simplelist> + <member>[email protected]</member> + <member>[email protected], [email protected]</member> + <member>User <[email protected]></member> + <member>User <[email protected]>, Another User <[email protected]></member> + </simplelist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>subject</parameter></term> + <listitem> + <para> + Emnet på mailen der skal sendes. + </para> + <caution> + <para> + Dette må ikke indeholde nogle linjeskift, da mailen måske ikke bliver + leveret korrekt. + </para> + </caution> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>message</parameter></term> + <listitem> + <para> + Beskeden som skal sendes. + </para> + <para> + Alle linjer bør blive delt med en LF (\n). Linjerne bør ikke være + længere end 70 tegn. + </para> + <caution> + <para> + (Kun windows) Når PHP snakker direkte med en SMTP server og et fuldt + stop er fundet på starten af en linje, vil den blive fjernet. For at + undgå dette, kan sådanne linjer udskriftes med to punktommer. + <programlisting role="php"> +<![CDATA[ +<?php +$text = str_replace("\n.", "\n..", $text); +?> +]]> + </programlisting> + </para> + </caution> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>additional_headers</parameter> (optional)</term> + <listitem> + <para> + Tekst som vil blive indsat til sidst i brevhovedet på emailen. + </para> + <para> + Dette bliver typisk brugt til at tilføje flere linjer til brevhovedet, + som f.eks. From, Cc og Bcc). + Hvis der er flere ekstra linjer, skal de deles med CRLF (\r\n). + </para> + <note> + <para> + Mailen <emphasis>skal</emphasis> indeholde en <literal>From</literal> + i brevhovedet. Dette kan sættes i + <parameter>additional_headers</parameter> eller en standardværdi + direkte i &php.ini;. + </para> + <para> + Hvis dette ikke bliver gjort, vil det resultere i en fejl som kunne + ligne dette: <literal>Warning: mail(): "sendmail_from" not + set in php.ini or custom "From:" header missing</literal>. + </para> + </note> + <note> + <para> + Hvis beskeden ikke bliver modtaget, prøv så kun at benytte LF (\n). + Nogle dårlige Unix mailservere udskifter LF med CRLF automatisk, + hvilket bliver til dobbelt CR hvis CRLF er brugt. + Dette skal være den sidste udvej, da metoden ikke overholder + <ulink url="&url.rfc;2822">RFC 2822</ulink> standarden. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>additional_parameters</parameter> (optional)</term> + <listitem> + <para> + Den sidste parameter, <parameter>additional_parameters</parameter>, kan + bruges til at angive indstillinger direkte til det program som er + konfigureret ved <literal>sendmail_path</literal>, som bruges til at + sende mail. Det kunne f.eks. være 'envelope sender address', som bruges + til at angive mailserverens svaradresse, og kan beskrives ved at bruge + <literal>-f</literal> som sendmail parameter. + </para> + <para> + Den bruger som webserveren kører under, bør tilføjes til listen over + betroede brugere i sendmail konfiguration for at undgå en 'X-Warning' + i brevhovedet, når 'envelope sender' (-f) bliver brugt i denne funktion. + Til dem som bruger sendmail, hedder filen + <filename>/etc/mail/trusted-users</filename>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Returnere &true;, hvis mailen blev accepteret af modtagerserveren og ellers + &false;. + </para> + <para> + Det er vigtigt at bemærke, at selvom mailen blev accepteret af serveren, + er det IKKE sikkert at mailen bliver leveret til den tilsigtet + destination. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0 (Kun Windows)</entry> + <entry> + Alle brugerdefineret brevhoveder (som From, Cc, Bcc og Date) er alle + tilgængelige og ser ikke forskelligt på store og små bogstaver. + (Da brugerdefineret brevhoveder ikke bliver behandlet af MTA i første + omgang, men bliver først gennemgået af PHP. PHP < 4.3 tillader + kun Cc og ser forskel på store og små bogstaver.) + </entry> + </row> + <row> + <entry>4.2.3</entry> + <entry> + Parameteren <parameter>additional_parameters</parameter> er slået fra + i <link linkend="ini.safe-mode">safe_mode</link> og funktionen + <function>mail</function> vil komme med en advarsel besked (warning) + og returner &false; hvis den bliver brugt. + </entry> + </row> + <row> + <entry>4.0.5</entry> + <entry> + Parameteren <parameter>additional_parameters</parameter> blev tilføjet. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Afsende mail.</title> <para> - <function>mail</function> returner &true; hvis e-mailen blev accepteret - til afsendelse, og ellers &false;. + Brug af <function>mail</function> til at sende en simpel mail: </para> - <warning> - <para> - Windows versionen af <function>mail</function> er på mange - måder forskellig fra Unix versionen. For det første, bruger den ikke et - lokalt program til at sende mailen med, men bruger i stedet en direkte forbindelse til en - <literal>MTA</literal>, som enten kan være lokal eller ekstern. For det - andet er brevhovedværdierne som <literal>From:</literal>, - <literal>Cc:</literal>, <literal>Bcc:</literal> og - <literal>Date:</literal> i første omgang <emphasis role="strong">ikke</emphasis> - kontroleret af <literal>MTA</literal>en, men bearbejdet af - PHP. - PHP < 4.3 understøttede kun <literal>Cc:</literal> elementet (og det skulle - skrives korrekt med store og små bogstaver). PHP >= 4.3 understøtter - alle de nævte brevhovedværdier og er ikke længere afhængig af store og små - bogstaver. - </para> - </warning> - <para> - <example> - <title>Afsendelse af en e-mail.</title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php -mail("[email protected]", "Mit emne", "Linje 1\nLinje 2\nLinje 3"); +// Beskeden +$message = "Line 1\nLine 2\nLine 3"; + +// I tilfældet at vores linjer er længere end 70 tegn, bør wordwrap() benyttes +$message = wordwrap($message, 70); + +// Send +mail('[email protected]', 'My Subject', $message); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Hvis det fjerde streng argument er angivet, bliver denne streng indsat til - sidst i brevhovedet. Den bliver typisk brugt til at tilføje ekstra - variabler til brevhovedet. Ved flere ekstra variabler skal de separateres - med en linjeafslutning og ny linje. - </simpara> - <note> - <para> - Du skal bruge <literal>\r\n</literal> til at separatere hovedvariablerne, - selvom nogen Unix mailprogrammer udskifter <literal>\n</literal> med - <literal>\r\n</literal> automatisk (hvilket vil betyde dobbelt - <literal>\r</literal> hvis <literal>\r\n</literal> bliver brugt). - </para> - </note> + </programlisting> + </example> + <example> + <title>Afsende mail med brugerdefineret brevhoved.</title> <para> - <example> - <title>Afsending af mails med extra elementer til brevhovedet.</title> - <programlisting role="php"> + Ved tilføjning af nogle elementære indstillinger, kan vi fortælle MUA + omkring fra (From) og svar-til (Reply-To) adresserne: + </para> + <programlisting role="php"> <![CDATA[ <?php -mail("[email protected]", "the subject", $message, - "From: webmaster@{$_SERVER['SERVER_NAME']}\r\n" . - "Reply-To: webmaster@{$_SERVER['SERVER_NAME']}\r\n" . - "X-Mailer: PHP/" . phpversion()); +$to = '[email protected]'; +$subject = 'the subject'; +$message = 'hello'; +$headers = 'From: [email protected]' . "\r\n" . + 'Reply-To: [email protected]' . "\r\n" . + 'X-Mailer: PHP/' . phpversion(); + +mail($to, $subject, $message, $headers); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + <example> + <title>Afsending af mail med ekstra kommandolinje parameter.</title> <para> - Elementet <parameter>additional_parameters</parameter> kan blive brugt til at - tilføje flere parameter til programmet der afsender e-mailen, som er blevet - valgt ved brug af <literal>sendmail_path</literal> i indstillingerne af - PHP. For eksempel kan den bruges til at sende mailformidlerens e-mailadresse - med ved brug af sendmail med parameteren <literal>-f</literal> fra sendmail. - Du kan også få brug for at sende hvilken program e-mailen er blevet sendt - med, for at undgå en 'X-Warning' bliver tilføjet i brevhovedet - når du sender mailformidlerens e-mailadresse med ved overstående metode. - <example> - <title>Afsendning af e-mail med ekstra hovedvariabler og ekstra paramenter til sendmail-programmet.</title> - <programlisting role="php"> + Parameteren <parameter>additional_parameters</parameter> kan blive brugt + til at overføre ekstra værdier til det program, der igennem + <literal>sendmail_path</literal> er sat til at sende mails for PHP. + </para> + <programlisting role="php"> <![CDATA[ <?php -mail("[email protected]", "the subject", $message, - "From: webmaster@{$_SERVER['SERVER_NAME']}", "-fwebmaster@{$_SERVER['SERVER_NAME']}"); +mail('[email protected]', 'the subject', 'the message', null, + '[email protected]'); ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Den femte parameter blev tilføjet i PHP 4.0.5. Siden PHP 4.2.3 er denne - parameter slået fra i <link linkend="ini.safe-mode">safe_mode</link> - og <function>mail</function> funktionen vil komme med en advarsel og - returner &false; hvis du prøver at bruge den. - </para> - </note> + </programlisting> + </example> + <example> + <title>Afsending af en HTML mail </title> <para> - Du kan også gøre brug af en simpel strengmetode til at lave en kompleks - e-mailbesked - <example> - <title>Afsending af en kompleks besked.</title> - <programlisting role="php"> + Det er også muligt at afsende en mail i HTML-format med <function>mail</function>. + </para> + <programlisting role="php"> <![CDATA[ <?php -/* recipients */ -$to = "[email protected]" . ", " ; // note the comma -$to .= "[email protected]"; +// multiple recipients +$to = '[email protected]' . ', '; // note the comma +$to .= '[email protected]'; -/* subject */ -$subject = "Birthday Reminders for August"; +// subject +$subject = 'Birthday Reminders for August'; -/* message */ +// message $message = ' <html> <head> - <title>Birthday Reminders for August</title> + <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> - </tr> - <tr> - <td>Sally</td><td>17th</td><td>August</td><td>1973</td> - </tr> -</table> + <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> + </tr> + <tr> + <td>Sally</td><td>17th</td><td>August</td><td>1973</td> + </tr> + </table> </body> </html> '; -/* To send HTML mail, you can set the Content-type header. */ -$headers = "MIME-Version: 1.0\r\n"; -$headers .= "Content-type: text/html; charset=iso-8859-1\r\n"; - -/* additional headers */ -$headers .= "To: Mary <[email protected]>, Kelly <[email protected]>\r\n"; -$headers .= "From: Birthday Reminder <[email protected]>\r\n"; -$headers .= "Cc: [email protected]\r\n"; -$headers .= "Bcc: [email protected]\r\n"; +// To send HTML mail, the Content-type header must be set +$headers = 'MIME-Version: 1.0' . "\r\n"; +$headers .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n"; + +// Additional headers +$headers .= 'To: Mary <[email protected]>, Kelly <[email protected]>' . "\r\n"; +$headers .= 'From: Birthday Reminder <[email protected]>' . "\r\n"; +$headers .= 'Cc: [email protected]' . "\r\n"; +$headers .= 'Bcc: [email protected]' . "\r\n"; -/* and now mail it */ +// Mail it mail($to, $subject, $message, $headers); ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Vær sikker på at du ikke har linjeskift i <parameter>to</parameter> eller - <parameter>subject</parameter>, da e-mailen herved muligvis ikke vil blive sendt - korrekt. - </para> - </note> - <note> - <para> - Parameteren <parameter>to</parameter> skal ikke være en adresse i form af - "Something <[email protected]>". Mailprogrammet vil i så - fald ikke altid kunne sende mailen korrekt. (Især under Windows). - </para> - </note> + </programlisting> <para> - Se også <function>imap_mail</function>. + <note> + <para> + Hvis det påtænkes at sende HTML eller andre former for komplekse email, + anbefales det at bruge PEAR package + <ulink url="&url.pear.package;Mail">PEAR::Mail</ulink>. + </para> + </note> </para> - </refsect1> - </refentry> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Windows implementeringen af <function>mail</function> er på mange måder + forskellig fra Unix versionen. For det første, bruger den ikke et + lokalt program til udsending af mail, men åbner en forbindelse direkte + til en <literal>MTA</literal>, som entet er lokal eller på en ekstern + maskine. + </para> + <para> + For det andet, brugerdefineret brevhoveder som + <literal>From:</literal>, + <literal>Cc:</literal>, + <literal>Bcc:</literal> og + <literal>Date:</literal> er + <emphasis role="strong">ikke</emphasis> overført direkte til + <literal>MTA</literal>, men først læst igennem af PHP. + </para> + <para> + Lige som at <parameter>to</parameter> parameteren ikke skal være en adresse + i formatet "Something <[email protected]>". + Mailprogrammet vil muligvis ikke behandler det korrekt, når det snakker med + MTA. + </para> + </note> + + <note> + <para> + Email med vedhæftede filer og specielle typer af indhold (f.eks. HTML), + kan blive sendt ved brug af denne funktion. Dette gøres ved hjælp af + MIME-encoding - læs mere omkring det her + <ulink url="&url.email.mime.zend;"> + Zend article</ulink> og her <ulink url="&url.pear.package;Mail_Mime"> + PEAR Mime Classes</ulink>. + </para> + </note> + + <note> + <para> + Det skal også lige bemærkes at funktionen <function>mail</function> ikke + er beregning til at sende store mængder af email i en løkke. Denne funktion + åbner og lukker en forbindelse til en SMTP-server ved hver mail, hvilket + ikke er særlig effektivt. + </para> + <para> + For at sende store mænger af emails, se mere her + <ulink url="&url.pear.package;Mail">PEAR::Mail</ulink> og her + <ulink url="&url.pear.package;Mail_Mime">PEAR::Mail_Queue</ulink>. + </para> + </note> + + <note> + <para> + De følgende RFC kan være meget brugbare: + <ulink url="&url.rfc;1896">RFC 1896</ulink>, + <ulink url="&url.rfc;2045">RFC 2045</ulink>, + <ulink url="&url.rfc;2046">RFC 2046</ulink>, + <ulink url="&url.rfc;2047">RFC 2047</ulink>, + <ulink url="&url.rfc;2048">RFC 2048</ulink>, + <ulink url="&url.rfc;2049">RFC 2049</ulink> og + <ulink url="&url.rfc;2822">RFC 2822</ulink>. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_mail</function></member> + <member><ulink url="&url.pear.package;Mail">PEAR::Mail</ulink></member> + <member><ulink url="&url.pear.package;Mail_Mime">PEAR::Mail_Mime</ulink></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: