cvs: peardoc /ja/core mail.xml
| From: | Rui Hirokawa | Date: | Sat, 07 Dec 2002 02:45:45 +0000 |
| Subject: | cvs: peardoc /ja/core mail.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-100@lists.php.net to get a copy of this message | ||
hirokawa Fri Dec 6 21:45:45 2002 EDT
Modified files:
/peardoc/ja/core mail.xml
Log:
translation updated.
Index: peardoc/ja/core/mail.xml diff -u peardoc/ja/core/mail.xml:1.3 peardoc/ja/core/mail.xml:1.4 --- peardoc/ja/core/mail.xml:1.3 Sun Feb 17 06:57:50 2002 +++ peardoc/ja/core/mail.xml Fri Dec 6 21:45:45 2002 @@ -1,768 +1,22 @@ -<?xml encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8" ?> +<!-- $Id: mail.xml,v 1.4 2002/12/07 02:45:45 hirokawa Exp $ --> <reference id="core.mail"> <title>PEAR Mail: ã¡ã¼ã«å¦ç颿°</title> <titleabbrev>Mail</titleabbrev> <partintro> <simpara> - æ¬ç« ã§ã¯ãPEARã«å«ã¾ããMail颿°ã®ä½¿ç¨æ³ã説æãã¾ãã + æ¬ç« ã¯ãPEARã«ä»å±ããMail颿°ã®ä½¿ç¨æ³ã«ã¤ãã¦èª¬æãã¾ãã </simpara> </partintro> + &core.mail.intro; + &core.mail.mail; + &core.mail.mime; + &core.mail.mimepart; + &core.mail.mimedecode; + &core.mail.rfc822; - <refentry id="core.mail.Mail"> - <refnamediv> - <refname>Mail</refname> - <refpurpose>Mail::ã¯ã©ã¹ã¸ã®ã¤ã³ã¿ã¼ãã§ã¤ã¹ãæä¾ãã</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - Mail::ã¯ã©ã¹ã¸ã®ã¤ã³ã¿ã¼ãã§ã¤ã¹ãæä¾ãã¾ããè¤æ°ã®ã¡ã¼ã©ã¼ãã - ã¯ã¨ã³ãã使ç¨ããå ´åã«æç¨ãªãµãã¼ã颿°ã§ãã - </simpara> - </refsect1> - - <refsect1> - <title><function>Mail::factory</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãMail/ãã£ã¬ã¯ããªã«ãããã©ã¤ãã¯ã©ã¹ã®1ã¤ãã - mailãªãã¸ã§ã¯ãã使ããããã«ä½¿ç¨ããã¾ãã弿°ãäºã¤ã¨ããæ - åã®å¼æ°ã¯ä½¿ç¨ãããã©ã¤ãã®åãäºçªç®ã¯ãã©ã¤ããªãã¸ã§ã¯ãã®ã³ - ã³ã¹ãã©ã¯ã¿ã«æ¸¡ããã©ã¡ã¼ã¿ã®é åã¨ãªãã¾ãã - </simpara> - - <programlisting role="php"> -<![CDATA[ -$params['host'] = 'localhost'; -$params['port'] = 25; - -$mail_object =& Mail::factory('smtp', $params); -]]> - </programlisting> - - <para> - æ£ãã弿°ã§ $mail_objectã®<function>send</function>ã¡ã½ãããã³ã¼ - ã«ãããã¨ãå¯è½ã¨ãªãã¾ãã(Mail_mail, Mail_smtp, Mail_sendmail - ã®ããã¥ã¡ã³ããåç §) - </para> - </refsect1> - </refentry> - - <refentry id="core.mail.phpmail"> - <refnamediv> - <refname>Mail/Mail.php</refname> - <refpurpose> - PHPã®<function>mail</function>ãç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã - </refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - PHPã®<function>mail</function>颿°ãç¨ãã - <function>send</function>ã¡ã½ãããæä¾ãããã©ã¤ããªãã¸ã§ã¯ãã - </simpara> - </refsect1> - - <refsect1> - <title><function>send</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãPHPçµè¾¼ã¿ã®<function>mail</function>颿°ãç¨ã㦠- ã¡ã¼ã«ãéä¿¡ããã¡ã½ããã§ããä»ã®ãã©ã¤ã颿°ã¨åæ§ã«3ã¤ã®å¼æ°ã - ã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$recipients</parameter> - ã«ã³ãåºåãã®éä¿¡å ã®é - å - </para> - </listitem> - <listitem> - <para> - <parameter>$headers</parameter> - ãããã®é£æ³é åããããåã - ãã¼ããããã®å¤ã¯å¤ã¨ãªãã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$body</parameter> - emailã®æ¬ä½ã - </para> - </listitem> - </itemizedlist> - </para> - - <programlisting role="php"> -include('Mail.php'); - -$recipients = 'joe@example.com'; - -$headers['From'] = 'richard@phpguru.org'; -$headers['To'] = 'joe@example.com'; -$headers['Subject'] = 'Test message'; - -$body = 'Test message'; - -// Create the mail object using the Mail::factory method -$mail_object =& Mail::factory('mail'); - -$mail_object->send($recipients, $headers, $body); - </programlisting> - </refsect1> - </refentry> - - <refentry id="core.mail.sendmail"> - <refnamediv> - <refname>Mail/sendmail.php</refname> - <refpurpose>sendmailã使ç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - sendmailã使ç¨ãã<function>send</function>ã¡ã½ãããæä¾ãããã© - ã¤ããªãã¸ã§ã¯ãã - </simpara> - </refsect1> - - <refsect1> - <title>constructor</title> - <simpara> - $obj =& Mail::factory()æ§æãç¨ãã¦ãªãã¸ã§ã¯ãã使ããéãã¡ã½ã - ãã«æ¸¡ããããã©ã¡ã¼ã¿ã¯ããã®ãªãã¸ã§ã¯ãã®ã³ã³ã¹ãã©ã¯ã¿ã«é çª - ã«æ¸¡ããã¾ãã使ç¨å¯è½ãªãã©ã¡ã¼ã¿ã以ä¸ã«ç¤ºãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$sendmail_path</parameter> - sendmailå®è¡ãã¡ã¤ã«ã¸ - ã®ãã¹ãæå®ãããªãå ´åã®ããã©ã«ãã¯ã - <filename>/usr/sbin/sendmail</filename> - </para> - </listitem> - <listitem> - <para> - <parameter>$sendmail_args</parameter> - sendmailã«æ¸¡ããªãã·ã§ - ã³å¼æ°ã®æååãæå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>send</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãsendmailãç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã¾ããä»ã®ãã©ã¤ã - 颿°ã¨åæ§ã«3ã¤ã®å¼æ°ãã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$recipients</parameter> - ã«ã³ãåºåãã®éä¿¡å ã®é - å - </para> - </listitem> - <listitem> - <para> - <parameter>$headers</parameter> - ãããã®é£æ³é åããããåã - ãã¼ããããã®å¤ã¯å¤ã¨ãªãã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$body</parameter> - emailã®æ¬ä½ã - </para> - </listitem> - </itemizedlist> - </para> - <programlisting role="php"> -<![CDATA[ -include('Mail.php'); - -$recipients = 'joe@example.com'; - -$headers['From'] = 'richard@phpguru.org'; -$headers['To'] = 'joe@example.com'; -$headers['Subject'] = 'Test message'; - -$body = 'Test message'; - -$params['sendmail_path'] = '/usr/lib/sendmail'; - -// Create the mail object using the Mail::factory method -$mail_object =& Mail::factory('sendmail', $params); - -$mail_object->send($recipients, $headers, $body); -]]> - </programlisting> - </refsect1> - - </refentry> - - <refentry id="core.mail.smtp"> - <refnamediv> - <refname>Mail/smtp.php</refname> - <refpurpose>SMTPãç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - smtpãç¨ãã<function>send</function>ã¡ã½ãããæä¾ãããã©ã¤ã㪠- ãã¸ã§ã¯ãã§ãããµã¼ãã«æ¥ç¶ããããã - <filename>Net/smtp.php</filename>㨠- <filename>Net/socket.php</filename>ã使ç¨ãã¾ãã - </simpara> - </refsect1> - - <refsect1> - <title>constructor</title> - <simpara> - $obj =& Mail::factory()æ§æã使ç¨ãã¦ãªãã¸ã§ã¯ãã使ããéã - ã¡ã½ããã«æ¸¡ããããã©ã¡ã¼ã¿ã¯ããã®ãªãã¸ã§ã¯ãã®ã³ã³ã¹ãã©ã¯ã¿ - ã«é çªã«æ¸¡ããã¾ãã使ç¨å¯è½ãªãã©ã¡ã¼ã¿ã以ä¸ã«ç¤ºãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$host</parameter> - æ¥ç¶ããsmtpãµã¼ãã - IPã¢ãã¬ã¹ã¾ãã¯ãã¹ãåãæå®ãããªãå ´åã®ããã©ã«ãã¯ã - localhostã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$port</parameter> - smtpãµã¼ããå®è¡ããã¦ãããã¼ - ããæå®ãããªãå ´åã®ããã©ã«ãã¯ã25ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$auth</parameter> - èªè¨¼ã使ç¨ãããã©ãããæå®ã - ããªãå ´åã®ããã©ã«ãã¯ã&false;ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$username</parameter> - èªè¨¼æãã®æ¥ç¶ã§ä½¿ç¨ããã¦ã¼ - ã¶åãæå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$password</parameter> - èªè¨¼æãã®æ¥ç¶ã§ä½¿ç¨ããã - ã¹ã¯ã¼ããæå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>send</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãsmtpãç¨ãã¦ã¡ã¼ã«ãéä¿¡ããã¡ã½ããã§ãã - <filename>Net/Socket.php</filename>㨠- <filename>Net/SMTP.php</filename>ã¯ã©ã¹ã使ç¨ãããããããããå© - ç¨å¯è½ã§ããå¿ è¦ãããã¾ããä»ã®ãã©ã¤ã颿°ã¨åæ§ã«3ã¤ã®å¼æ°ã㨠- ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$recipients</parameter> - ã«ã³ãåºåãã®éä¿¡å ã®é - å - </para> - </listitem> - <listitem> - <para> - <parameter>$headers</parameter> - ãããã®é£æ³é åããããåã - ãã¼ããããã®å¤ã¯å¤ã¨ãªãã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$body</parameter> - emailã®æ¬ä½ã - </para> - </listitem> - </itemizedlist> - </para> - <programlisting role="php"> -<![CDATA[ -include('Mail.php'); - -$recipients = 'joe@example.com'; - -$headers['From'] = 'richard@phpguru.org'; -$headers['To'] = 'joe@example.com'; -$headers['Subject'] = 'Test message'; - -$body = 'Test message'; - -$params['host'] = 'mail.example.com'; - -// Create the mail object using the Mail::factory method -$mail_object =& Mail::factory('smtp', $params); - -$mail_object->send($recipients, $headers, $body); -]]> - </programlisting> - </refsect1> - - </refentry> - - <refentry id="core.mail.mime"> - <refnamediv> - <refname>Mail/mime.php</refname> - <refpurpose>ãã«ããã¼ãã¡ãã»ã¼ã¸ã使ããã¯ã©ã¹</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - è¤éãªãã«ããã¼ãã¡ãã»ã¼ã¸ãç°¡åã«ä½æããããã®ã¯ã©ã¹ã§ãã - ãã®ãããªemailã使ããããã®ç°¡åãªAPIãæ¢ãã¦ããå ´åã¯ããã® - ã¯ã©ã¹ãæããé©å½ã§ãããã䏿¹ãemailãé«åº¦ã«å¶å¾¡ãããå ´åã«ã¯ã - <filename>mimePart.php</filename>ã使ç¨ããæ¹ãè¯ãããããã¾ããã - </simpara> - </refsect1> - - <refsect1> - <title>constructor</title> - <simpara> - ã³ã³ã¹ãã©ã¯ã¿ã¯ã弿°ã1ã¤ã ãã¨ãã¾ãããã®å¼æ°ã¯ã使ç¨ããè¡æ« - ã®åã§ããæ¨æºã¯ãCRLFã§ããã*nixã§ã¯LFãåºã使ãããMacã¯CRã§ãã - </simpara> - </refsect1> - <refsect1> - <title><function>setTXTBody</function></title> - <simpara> - ãã®é¢æ°ã¯ãemailã®ããã¹ãé¨åãè¨å®ãã¾ãã以ä¸ã«ç¤ºã弿°ã2㤠- ã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$data</parameter> - è¨å®ããããã¹ãã¾ãã¯ä½¿ç¨ãã - ããã¹ããã¡ã¤ã«ã®ãã¡ã¤ã«åã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfile</parameter> - ãªãã·ã§ã³ã&true;ã®å ´åã - <parameter>$data</parameter>ã¯ãã¡ã¤ã«åã¨ä»®å®ãããèªã¿è¾¼ã¾ã - ã¾ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>setHTMLBody</function></title> - <simpara> - ãã®é¢æ°ã¯ãemailã®HTMLã®é¨åãè¨å®ãã¾ããæ¬¡ã®2ã¤ã®å¼æ°ãã¨ãã¾ - ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$data</parameter> - è¨å®ããHTMLã¾ãã¯ã使ç¨ããã - ãã¹ããã¡ã¤ã«ã®ãã¡ã¤ã«åã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfile</parameter> - ãªãã·ã§ã³ã&true;ã®å ´åã - <parameter>$data</parameter>ã¯ãã¡ã¤ã«åã¨ä»®å®ãããèªã¿è¾¼ã¾ã - ã¾ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>addHTMLImage</function></title> - <simpara> - åè¾¼ã¿ã¤ã¡ã¼ã¸ã¨ãã¦HTML emailãéä¿¡ããå ´åããã®é¢æ°ãã¤ã¡ã¼ã¸ - ã追å ããããã«ä½¿ç¨ãã¦ä¸ããããã®é¢æ°ã¯ä»¥ä¸ã®4ã¤ã®å¼æ°ãã¨ãã¾ - ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$file</parameter> - ãã¡ã¤ã«åã¾ãã¯å®éã®ãã¡ã¤ã« - ãã¼ã¿èªä½ã - </para> - </listitem> - <listitem> - <para> - <parameter>$c_type</parameter> - ã¤ã¡ã¼ã¸/ãã¡ã¤ã«ã®content - typeãæå®ãããªãå ´åã®ããã©ã«ãã¯ãapplication/octet-streamã - </para> - </listitem> - <listitem> - <para> - <parameter>$name</parameter> - ã¤ã¡ã¼ã¸/ãã¡ã¤ã«ã®ãã¡ã¤ã«åã - æå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfilename</parameter> - - <parameter>$file</parameter>弿°ããã¡ã¤ã«åã¨ãããã©ããã - &true;ã®å ´åããã®ãã¡ã¤ã«ãèªã¿è¾¼ã¾ãã¾ããæå®ãããªãå ´åã® - ããã©ã«ãã¯ã&true;ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - <para> - <emphasis>注æ:</emphasis> - ãã®é¢æ°ã¯ãåãè¾¼ã¿ã¤ã¡ã¼ã¸ã使ç¨å¯è½ã¨ããã ãã§ããä»ã®ãã¡ã¤ - ã«åãä¾ãã°flashã ã¼ãã¼ããåãè¾¼ã¿å¯è½ã§ãã - </para> - </refsect1> - <refsect1> - <title><function>addAttachment</function></title> - <simpara> - emailã«æ·»ä»ãã¡ã¤ã«ã追å ããããã®é¢æ°ã¯å¼æ°ã以ä¸ã®5åã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$file</parameter> - ãã¡ã¤ã«åã¾ãã¯ãã¡ã¤ã«ãã¼ã¿ - èªä½ã - </para> - </listitem> - <listitem> - <para> - <parameter>$c_type</parameter> - ãã¡ã¤ã«ã®Content typeã - æå®ãããªãå ´åã®ããã©ã«ãã¯ãapplication/octet-streamã - </para> - </listitem> - <listitem> - <para> - <parameter>$name</parameter> - ãã¡ã¤ã«ã®ãã¡ã¤ã«åã - æå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfilename</parameter> - - <parameter>$file</parameter>弿°ããã¡ã¤ã«åã¨ãããã©ããã - &true;ã®å ´åããã®ãã¡ã¤ã«ãèªã¿è¾¼ã¾ãã¾ããæå®ãããªãå ´åã® - ããã©ã«ãã¯ã&true;ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$encoding</parameter> - ãã¡ã¤ã«ãã¼ã¿ã«é¢ãã¦ä½¿ç¨ - ããtransfer encodingã®åãæå®ãããªãå ´åã®ããã©ã«ãã¯ã - base64ã§ãã(ä¾ãã°scripts/htmlã¨ãã£ã)ããã¹ããã¼ã¹ã®ãã¡ã¤ - ã«ã®å ´åãquoted-printableãæå®ãããã¨ãå¯è½ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>get</function></title> - <simpara> - ãã®é¢æ°ã¯ãtext/html/images/attachmentsã追å ãã度ã«ï¼åº¦ã³ã¼ã« - ããã¾ãããã®é¢æ°ã¯ãemailã使ããè¿ãã¾ãã - éä¿¡ã¯è¡ãã¾ããã(headers()颿°ã¨çµã¿åããã¦)ãã®é¢æ°ãè¿ããã® - ãéä¿¡ããã«ã¯ããã®ããã¥ã¡ã³ãã§èª¬æããã¦ãã - <link linkend="core.mail.phpmail">Mail_mail</link>, - <link linkend="core.mail.sendmail">Mail_sendmail</link>, - <link linkend="core.mail.smtp">Mail_smtp</link>ã¯ã©ã¹ã®ï¼ã¤ã®ä½¿ç¨ - ããå¿ è¦ãããã¾ãããã®é¢æ°ã¯å¼æ°ãï¼ã¤ã ãã¨ããããã¯ããã©ã¡ã¼ - ã¿ã®é£æ³é åã§ãããããã®ãã©ã¡ã¼ã¿ã¯ãemailã®ä½ææ¹æ³ã夿´ãã - ãã®ã§ã以ä¸ã®è¦ç´ ãããªãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$text_encoding</parameter> - emailã®ãã¬ã¼ã³ããã¹ - ããã¼ãã§ä½¿ç¨ããã¨ã³ã³ã¼ãã£ã³ã°ã®åãããã©ã«ãã¯ã7bitã - </para> - </listitem> - <listitem> - <para> - <parameter>$html_encoding</parameter> - emailã®HTMLãã¼ãã§ä½¿ - ç¨ããã¨ã³ã³ã¼ãã£ã³ã°ã®åãããã©ã«ãã¯ãquoted-printableã - </para> - </listitem> - <listitem> - <para> - <parameter>$7bit_wrap</parameter> - ããã¹ããæãè¿ãæåæ°ã - SMTPã¯ã1è¡ã®æå¤§é·ãCRLFãå«ãã§1000æåã¨è¦å®ãã¦ãã¾ããã - ãã©ã«ãã¯ã998æå(CRLFãå«ãã§1000æå)ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$text_charset</parameter> - emailã®ãã¬ã¼ã³ããã¹ã - ãã¼ãã§ä½¿ç¨ãããæåæ¥ã¨ãããã©ã«ãã¯ãiso-8859-1ã - </para> - </listitem> - <listitem> - <para> - <parameter>$html_charset</parameter> - emailã®HTMLãã¼ãã§ä½¿ç¨ - ãããæåã»ãããããã©ã«ãã¯ãiso-8859-1ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>headers</function></title> - <simpara> - ãã®é¢æ°ã¯ãemailã§å¿ è¦ãªé©åãªãããã飿³é åã¨ãã¦è¿ãã¾ãã - ãã®é£æ³é åã¯ãMail_mail, Mail_sendmail, Mail_smtpã¯ã©ã¹ã«ç´æ¥æ¸¡ - ããã¨ãå¯è½ã§ãããã®é¢æ°ã¯ã<function>get</function>ãã³ã¼ã«ã - ãå¾ã«ã³ã¼ã«ããå¿ è¦ãããã¾ããããã¯ã<function>get</function> - ãããã¤ãã®å¿ è¦ãªããããçæããããã§ãããã®é¢æ°ã¯ã弿°ãï¼ - ã¤ã ãã¨ããããã¯ãè¿ããããããã®é£æ³é åã«ãå«ã¾ãã¾ãã - ãã®é åã®ãã¼ã¯ãããå(ä¾ From, Subject, X-Mailer)ã¨ããå¤ã¯ã - ãã®ãããã®å¤ã¨ããå¿ è¦ãããã¾ãã - </simpara> - </refsect1> - <refsect1> - <title>ä¾:</title> - <simpara> - 以ä¸ã®ä¾ã¯ãè²¼ä»ãã¡ã¤ã«ãæããé常ã«ç°¡åãªhtml/text emailã使 - ããmailãã©ã¤ãã®Mail::send()颿°(ããªãã¡ãMail_mail::send())ã - ç¨ãã¦éä¿¡ãããã®ã§ãã - </simpara> - <programlisting role="php"> -<![CDATA[ -include('Mail.php'); -include('Mail/mime.php'); - -$text = 'Text version of email'; -$html = '<html><body>HTML version of email</body></html>'; -$file = '/home/richard/example.php'; -$crlf = "\r\n"; -$hdrs = array( - 'From' => 'richard@phpguru.org', - 'Subject' => 'Test mime message' - ); - -$mime = new Mail_mime($crlf); - -$mime->setTXTBody($text); -$mime->setHTMLBody($html); -$mime->addAttachment($file, 'text/plain'); - -$body = $mime->get(); -$hdrs = $mime->headers($hdrs); - -$mail =& Mail::factory('mail'); -$mail->send('joe@example.com', $hdrs, $body); -]]> - </programlisting> - </refsect1> - </refentry> - - <refentry id="core.mail.mimeDecode"> - <refnamediv> - <refname>Mail/mimeDecode.php</refname> - <refpurpose>MIMEã¡ãã»ã¼ã¸ã§åä½ããã¯ã©ã¹</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - - <simpara> - ãã®ã¯ã©ã¹ã¯ã mime emails/messageä½æãæ¯æ´ãããã¼ã«ã§ãã - ãã®é¢æ°ã¯æå®ããå ¥åãæç¨ãªPHPãã¼ã¿æ§é ã«ãã³ã¼ããã¾ãã - ãã¼ã¿æ§é ã¯ã以ä¸ã®è¦ç´ ãæãããªãã¸ã§ã¯ãã§ãã - </simpara> - <para> - <emphasis>headers:</emphasis> ãããã®é£æ³é åãé åã®ãã¼ã¯ããã - ãå(å°æåã«å¤æ)ãå¤ã¯ãã®ãããã®å¤(大æåå°æåã¯ãã®ã¾ã¾)ã§ - ãã(Recieved:ã®ããã«)åãååã§è¤æ°ã®ããããããå ´åãåããã - ã®å¤ã®æ°å¤æ·»åã®é åã¨ãªãã¾ãããã©ã¡ã¼ã¿decode_headersã«&true; - ãæå®ãããå ´åããããã¯ãã³ã¼ãããã¾ãã(RFC2047) - </para> - <para> - <emphasis>ctype_primary:</emphasis> content typeã®æåã®é¨åã - (ããªãã¡ãååãã¹ã©ãã·ã¥ã®å) ä¾ãã°ãcontent typeã - multipart/mixedã®å ´åãctype_primaryã¯"multipart"(å¼ç¨ç¬¦ã¯å«ã¾ã) - ã¨ãªãã¾ãã - </para> - <para> - <emphasis>ctype_secondary:</emphasis> content typeã®2çªç®é¨åã - ä¾ãã°ãcontent typeãmultipart/mixedã®å ´åãctype_secondary㯠- "mixed" (å¼ç¨ç¬¦ã¯å«ã¾ã)ã¨ãªãã¾ãã - </para> - <para> - <emphasis>ctype_parameters:</emphasis> content typeãããã«ãã©ã¡ã¼ - ã¿ãããå ´å(ä¾ãã°ãboundary="=_hudfhdsalfhds8fy8329hfj")ããã® - 飿³é åã«ä»£å ¥ããã¾ãããã¼ã¯ããã©ã¡ã¼ã¿å(ä¾ boundary)ãä¸ - æ¹ãå¤ã¯ãã®ãã©ã¡ã¼ã¿ã®å¤(ä¾ =_hudfhdsalfhds8fy8329hfj )ã¨ãªãã¾ - ãã - </para> - <para> - <emphasis>disposition:</emphasis> Content-Dispositionãããããã - å ´åããã®å¤ãããã«æå®ããã¾ããããã¯ãé常ã"inline"ã¾ã㯠- "attachment" (å¼ç¨ç¬¦ã¯å«ã¾ã)ã®ã©ã¡ããã§ãã - </para> - <para> - <emphasis>d_parameters:</emphasis> Content-Dispositionã«ä½ããã® - ãã©ã¡ã¼ã¿ãæå®ãããå ´åãããã«é£æ³é åãä»£å ¥ããããã¼ã¯ãã© - ã¡ã¼ã¿åãå¤ã¯ãã®ãã©ã¡ã¼ã¿ã®å¤ã¨ãªãã¾ãã"name"ã¨"filename"ã - ããããä¾ã§ãã - </para> - <para> - <emphasis>body:</emphasis> (éçã¾ãã¯é常ã®å¤æ°ã®ã©ã¡ããã§)ãã® - ã¯ã©ã¹ã®ã¤ã³ã¹ã¿ã³ã¹ãçæããéã«include_bodiesãã©ã¡ã¼ã¿ãæå® - ãããéã«åé¡ã®é¨åãbodyãæããå ´åã«ä»£å ¥ããã¾ãã - content type multipart/*ãæããMIMEãã¼ãã¯ãé常ãbodyãæããã - ãµããã¼ãããæ§æããã¾ãããã©ã¡ã¼ã¿decode_bodiesã«&true;ãæå® - ãããå ´åãbodyã¯ãã³ã¼ãããã¾ãã - </para> - <para> - <emphasis>parts:</emphasis> ããMIMEãã¼ãããµããã¼ããããªãå ´ - åãããã§èª¬æãããã®ã¨åæ§ãªããããã£ãæãããªãã¸ã§ã¯ããã - ãªãé åã¨ãªãã¾ãã - </para> - </refsect1> - <refsect1> - <title><function>Mail_mimeDecode::constructor</function></title> - <simpara> - ãªãã¸ã§ã¯ãã¨ãã¦ã¤ã³ã¹ã¿ã³ã¹ä½æãè¡ãããå ´åãã³ã³ã¹ãã©ã¯ã¿ - ã¯å¼æ°ã以ä¸ã®äºã¤ã¨ãã¾ãã - </simpara> - <itemizedlist> - <listitem> - <para> - <parameter>$input</parameter> - ãã³ã¼ãããemail/messageã - </para> - </listitem> - <listitem> - <para> - <parameter>$crlf</parameter> - ãªãã·ã§ã³ã使ç¨ããè¡æ«è¨å·ãæ - å®ãã¾ããé常ã¯ãCRLFã¾ãã¯LFã®ã¿ã§ãããã®ãªãã·ã§ã³ã¯ããã® - ã¯ã©ã¹ãåä½ãããã©ããã®éããçããã¨ãããã¾ãã - ãã®å¼æ°ã§æå®ãããã®ã ããemailã§ç¢ºå®ã«ä½¿ç¨ãããã¨ãå¼·ãæ¨å¥¨ - ããã¾ããããã©ã«ãã¯ãCRLFã§ãã - </para> - </listitem> - </itemizedlist> - </refsect1> - - <refsect1> - <title><function>Mail_mimeDecode::decode</function></title> - <simpara> - ãã®é¢æ°ã¯ããã³ã¼ããè¡ããä¸è¨ã®æ§é ä½ãè¿ãã¾ãããã®é¢æ°ã¯ã - 弿°ã¨ãã¦ãã©ã¡ã¼ã¿ã®é£æ³é åã®ã¿ãã¨ãã¾ãããããã®ãã©ã¡ã¼ã¿ - ã¯ã次ã®è¦ç´ ãããªãã¾ãã - </simpara> - <itemizedlist> - <listitem> - <para> - <parameter>$include_bodies</parameter> - è¿ãããæ§é ä½ã«bodyã - å«ããã©ããã - </para> - </listitem> - <listitem> - <para> - <parameter>$decode_bodies</parameter> - è¿ãããbodyããã³ã¼ã - ãããã©ããã - </para> - </listitem> - <listitem> - <para> - <parameter>$decode_headers</parameter> - ãããããã³ã¼ãããã - ã©ããã(RFC2047) - </para> - </listitem> - <listitem> - <para> - <parameter>$input</parameter> - éçã«ã³ã¼ã«ãããå ´åã®ã¿ã - ãã®å ¥åããã³ã¼ããããã©ãããæå®ããããã«ä½¿ç¨ããã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$crlf</parameter> - éçã«ã³ã¼ã«ãããå ´åã®ã¿ã - è¡æ«ãæå®ããããã«ä½¿ç¨ããã¾ãã - </para> - </listitem> - </itemizedlist> - </refsect1> - - <refsect1> - <title><function>Mail_mimeDecode::uudecode</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãã¯ã©ã¹ã®ãã³ã¼ãå¦çé¨ããã³ã¼ã«ããããå®è¡å¯è½ - ãªã¡ã½ããã¨ãã¦å«ã¾ãã¦ãã¾ãã - ä½ããã®å ¥åãæå®ããã¨ãuuencodeãããæ·»ä»ãã¼ã¿ã確èªãããã¡ - ã¤ã«ãã¼ã¿ããã¡ã¤ã«è¨±å¯å±æ§ããã¡ã¤ã«åãããªã飿³é åã¨ãã¦è¿ - ãã¾ãããã®ã¡ã½ããã¯ã調ã¹ããã¼ã¿å ¥åã弿°ã¨ãã¦1ã¤ã ãã¨ãã¾ - ãããã®é¢æ°ã¯ããã®ã¯ã©ã¹ã®æ®ãã®æ©è½ã使ç¨ããªãå ´åã§ãéçã« - ã³ã¼ã«ãããã¨ãå¯è½ã§ãã - </simpara> - </refsect1> - - <refsect1> - <title><function>Mail_mimeDecode::getXML</function></title> - <simpara> - ãã®ã¡ã½ããã¯ããã®ã¯ã©ã¹ã®ãã³ã¼ãå¦çé¨ããã¯ã³ã¼ã«ããã¾ããã - ãã®ã¡ã½ããã¯ã<function>decode</function>ã«ããè¿ãããåºåãå¼ - æ°ã¨ããhttp://www.phpguru.org/xmail/ã§å®ç¾©ãããDTDã¾ãã¯(å©ç¨å¯ - è½ãªå ´åã«ã¯)PEAR mimeããã±ã¼ã¸ãç¨ãã¦XMLã«å¤æãã¾ãããã®ã¡ã½ã - ãã¯ã弿°ã1ã¤ã ãåããããã¯ã<function>decode</function>ã¡ã½ã - ãããè¿ããããã¼ã¿ã§ãã - </simpara> - </refsect1> - - <refsect1> - <title>使ç¨ä¾:</title> - - <simpara> - ãã®ä¾ã¯ããªãã¸ã§ã¯ãã®ã¤ã³ã¹ã¿ã³ã¹ã使ããdecode颿°ãå®è¡ã - ã¾ãã - </simpara> - - <programlisting role="php"> -<![CDATA[ -$params['include_bodies'] = TRUE; -$params['decode_bodies'] = TRUE; -$params['decode_headers'] = TRUE; - -$decoder = new Mail_mimeDecode($input); -$structure = $decoder->decode($params); -]]> - </programlisting> - - <para> - ãã®ä¾ã¯ãdecode颿°ãéçã«ã³ã¼ã«(ããªãã¡ããªãã¸ã§ã¯ãã使ã - ãã«é¢æ°ãç´æ¥ã³ã¼ã«)ããå¾ã<function>getXML</function>颿°ã«æ§ - é ä½ã渡ãã¾ãã - <programlisting role="php"> -<![CDATA[ -$params['include_bodies'] = TRUE; -$params['decode_bodies'] = FALSE; -$params['decode_headers'] = TRUE; -$params['input'] = $input; -$params['crlf'] = "\r\n"; - -$structure = Mail_mimeDecode::decode($params); -$xml = Mail_mimeDecode::getXML($structure); -]]> - </programlisting> - </para> - - </refsect1> - </refentry> </reference> <!-- Keep this comment at the end of the file
Index: peardoc/ja/core/mail.xml diff -u peardoc/ja/core/mail.xml:1.3 peardoc/ja/core/mail.xml:1.4 --- peardoc/ja/core/mail.xml:1.3 Sun Feb 17 06:57:50 2002 +++ peardoc/ja/core/mail.xml Fri Dec 6 21:45:45 2002 @@ -1,768 +1,22 @@ -<?xml encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="utf-8" ?> +<!-- $Id: mail.xml,v 1.4 2002/12/07 02:45:45 hirokawa Exp $ --> <reference id="core.mail"> <title>PEAR Mail: ã¡ã¼ã«å¦ç颿°</title> <titleabbrev>Mail</titleabbrev> <partintro> <simpara> - æ¬ç« ã§ã¯ãPEARã«å«ã¾ããMail颿°ã®ä½¿ç¨æ³ã説æãã¾ãã + æ¬ç« ã¯ãPEARã«ä»å±ããMail颿°ã®ä½¿ç¨æ³ã«ã¤ãã¦èª¬æãã¾ãã </simpara> </partintro> + &core.mail.intro; + &core.mail.mail; + &core.mail.mime; + &core.mail.mimepart; + &core.mail.mimedecode; + &core.mail.rfc822; - <refentry id="core.mail.Mail"> - <refnamediv> - <refname>Mail</refname> - <refpurpose>Mail::ã¯ã©ã¹ã¸ã®ã¤ã³ã¿ã¼ãã§ã¤ã¹ãæä¾ãã</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - Mail::ã¯ã©ã¹ã¸ã®ã¤ã³ã¿ã¼ãã§ã¤ã¹ãæä¾ãã¾ããè¤æ°ã®ã¡ã¼ã©ã¼ãã - ã¯ã¨ã³ãã使ç¨ããå ´åã«æç¨ãªãµãã¼ã颿°ã§ãã - </simpara> - </refsect1> - - <refsect1> - <title><function>Mail::factory</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãMail/ãã£ã¬ã¯ããªã«ãããã©ã¤ãã¯ã©ã¹ã®1ã¤ãã - mailãªãã¸ã§ã¯ãã使ããããã«ä½¿ç¨ããã¾ãã弿°ãäºã¤ã¨ããæ - åã®å¼æ°ã¯ä½¿ç¨ãããã©ã¤ãã®åãäºçªç®ã¯ãã©ã¤ããªãã¸ã§ã¯ãã®ã³ - ã³ã¹ãã©ã¯ã¿ã«æ¸¡ããã©ã¡ã¼ã¿ã®é åã¨ãªãã¾ãã - </simpara> - - <programlisting role="php"> -<![CDATA[ -$params['host'] = 'localhost'; -$params['port'] = 25; - -$mail_object =& Mail::factory('smtp', $params); -]]> - </programlisting> - - <para> - æ£ãã弿°ã§ $mail_objectã®<function>send</function>ã¡ã½ãããã³ã¼ - ã«ãããã¨ãå¯è½ã¨ãªãã¾ãã(Mail_mail, Mail_smtp, Mail_sendmail - ã®ããã¥ã¡ã³ããåç §) - </para> - </refsect1> - </refentry> - - <refentry id="core.mail.phpmail"> - <refnamediv> - <refname>Mail/Mail.php</refname> - <refpurpose> - PHPã®<function>mail</function>ãç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã - </refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - PHPã®<function>mail</function>颿°ãç¨ãã - <function>send</function>ã¡ã½ãããæä¾ãããã©ã¤ããªãã¸ã§ã¯ãã - </simpara> - </refsect1> - - <refsect1> - <title><function>send</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãPHPçµè¾¼ã¿ã®<function>mail</function>颿°ãç¨ã㦠- ã¡ã¼ã«ãéä¿¡ããã¡ã½ããã§ããä»ã®ãã©ã¤ã颿°ã¨åæ§ã«3ã¤ã®å¼æ°ã - ã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$recipients</parameter> - ã«ã³ãåºåãã®éä¿¡å ã®é - å - </para> - </listitem> - <listitem> - <para> - <parameter>$headers</parameter> - ãããã®é£æ³é åããããåã - ãã¼ããããã®å¤ã¯å¤ã¨ãªãã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$body</parameter> - emailã®æ¬ä½ã - </para> - </listitem> - </itemizedlist> - </para> - - <programlisting role="php"> -include('Mail.php'); - -$recipients = 'joe@example.com'; - -$headers['From'] = 'richard@phpguru.org'; -$headers['To'] = 'joe@example.com'; -$headers['Subject'] = 'Test message'; - -$body = 'Test message'; - -// Create the mail object using the Mail::factory method -$mail_object =& Mail::factory('mail'); - -$mail_object->send($recipients, $headers, $body); - </programlisting> - </refsect1> - </refentry> - - <refentry id="core.mail.sendmail"> - <refnamediv> - <refname>Mail/sendmail.php</refname> - <refpurpose>sendmailã使ç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - sendmailã使ç¨ãã<function>send</function>ã¡ã½ãããæä¾ãããã© - ã¤ããªãã¸ã§ã¯ãã - </simpara> - </refsect1> - - <refsect1> - <title>constructor</title> - <simpara> - $obj =& Mail::factory()æ§æãç¨ãã¦ãªãã¸ã§ã¯ãã使ããéãã¡ã½ã - ãã«æ¸¡ããããã©ã¡ã¼ã¿ã¯ããã®ãªãã¸ã§ã¯ãã®ã³ã³ã¹ãã©ã¯ã¿ã«é çª - ã«æ¸¡ããã¾ãã使ç¨å¯è½ãªãã©ã¡ã¼ã¿ã以ä¸ã«ç¤ºãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$sendmail_path</parameter> - sendmailå®è¡ãã¡ã¤ã«ã¸ - ã®ãã¹ãæå®ãããªãå ´åã®ããã©ã«ãã¯ã - <filename>/usr/sbin/sendmail</filename> - </para> - </listitem> - <listitem> - <para> - <parameter>$sendmail_args</parameter> - sendmailã«æ¸¡ããªãã·ã§ - ã³å¼æ°ã®æååãæå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>send</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãsendmailãç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã¾ããä»ã®ãã©ã¤ã - 颿°ã¨åæ§ã«3ã¤ã®å¼æ°ãã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$recipients</parameter> - ã«ã³ãåºåãã®éä¿¡å ã®é - å - </para> - </listitem> - <listitem> - <para> - <parameter>$headers</parameter> - ãããã®é£æ³é åããããåã - ãã¼ããããã®å¤ã¯å¤ã¨ãªãã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$body</parameter> - emailã®æ¬ä½ã - </para> - </listitem> - </itemizedlist> - </para> - <programlisting role="php"> -<![CDATA[ -include('Mail.php'); - -$recipients = 'joe@example.com'; - -$headers['From'] = 'richard@phpguru.org'; -$headers['To'] = 'joe@example.com'; -$headers['Subject'] = 'Test message'; - -$body = 'Test message'; - -$params['sendmail_path'] = '/usr/lib/sendmail'; - -// Create the mail object using the Mail::factory method -$mail_object =& Mail::factory('sendmail', $params); - -$mail_object->send($recipients, $headers, $body); -]]> - </programlisting> - </refsect1> - - </refentry> - - <refentry id="core.mail.smtp"> - <refnamediv> - <refname>Mail/smtp.php</refname> - <refpurpose>SMTPãç¨ãã¦ã¡ã¼ã«ãéä¿¡ãã</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - smtpãç¨ãã<function>send</function>ã¡ã½ãããæä¾ãããã©ã¤ã㪠- ãã¸ã§ã¯ãã§ãããµã¼ãã«æ¥ç¶ããããã - <filename>Net/smtp.php</filename>㨠- <filename>Net/socket.php</filename>ã使ç¨ãã¾ãã - </simpara> - </refsect1> - - <refsect1> - <title>constructor</title> - <simpara> - $obj =& Mail::factory()æ§æã使ç¨ãã¦ãªãã¸ã§ã¯ãã使ããéã - ã¡ã½ããã«æ¸¡ããããã©ã¡ã¼ã¿ã¯ããã®ãªãã¸ã§ã¯ãã®ã³ã³ã¹ãã©ã¯ã¿ - ã«é çªã«æ¸¡ããã¾ãã使ç¨å¯è½ãªãã©ã¡ã¼ã¿ã以ä¸ã«ç¤ºãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$host</parameter> - æ¥ç¶ããsmtpãµã¼ãã - IPã¢ãã¬ã¹ã¾ãã¯ãã¹ãåãæå®ãããªãå ´åã®ããã©ã«ãã¯ã - localhostã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$port</parameter> - smtpãµã¼ããå®è¡ããã¦ãããã¼ - ããæå®ãããªãå ´åã®ããã©ã«ãã¯ã25ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$auth</parameter> - èªè¨¼ã使ç¨ãããã©ãããæå®ã - ããªãå ´åã®ããã©ã«ãã¯ã&false;ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$username</parameter> - èªè¨¼æãã®æ¥ç¶ã§ä½¿ç¨ããã¦ã¼ - ã¶åãæå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$password</parameter> - èªè¨¼æãã®æ¥ç¶ã§ä½¿ç¨ããã - ã¹ã¯ã¼ããæå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>send</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãsmtpãç¨ãã¦ã¡ã¼ã«ãéä¿¡ããã¡ã½ããã§ãã - <filename>Net/Socket.php</filename>㨠- <filename>Net/SMTP.php</filename>ã¯ã©ã¹ã使ç¨ãããããããããå© - ç¨å¯è½ã§ããå¿ è¦ãããã¾ããä»ã®ãã©ã¤ã颿°ã¨åæ§ã«3ã¤ã®å¼æ°ã㨠- ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$recipients</parameter> - ã«ã³ãåºåãã®éä¿¡å ã®é - å - </para> - </listitem> - <listitem> - <para> - <parameter>$headers</parameter> - ãããã®é£æ³é åããããåã - ãã¼ããããã®å¤ã¯å¤ã¨ãªãã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$body</parameter> - emailã®æ¬ä½ã - </para> - </listitem> - </itemizedlist> - </para> - <programlisting role="php"> -<![CDATA[ -include('Mail.php'); - -$recipients = 'joe@example.com'; - -$headers['From'] = 'richard@phpguru.org'; -$headers['To'] = 'joe@example.com'; -$headers['Subject'] = 'Test message'; - -$body = 'Test message'; - -$params['host'] = 'mail.example.com'; - -// Create the mail object using the Mail::factory method -$mail_object =& Mail::factory('smtp', $params); - -$mail_object->send($recipients, $headers, $body); -]]> - </programlisting> - </refsect1> - - </refentry> - - <refentry id="core.mail.mime"> - <refnamediv> - <refname>Mail/mime.php</refname> - <refpurpose>ãã«ããã¼ãã¡ãã»ã¼ã¸ã使ããã¯ã©ã¹</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - <simpara> - è¤éãªãã«ããã¼ãã¡ãã»ã¼ã¸ãç°¡åã«ä½æããããã®ã¯ã©ã¹ã§ãã - ãã®ãããªemailã使ããããã®ç°¡åãªAPIãæ¢ãã¦ããå ´åã¯ããã® - ã¯ã©ã¹ãæããé©å½ã§ãããã䏿¹ãemailãé«åº¦ã«å¶å¾¡ãããå ´åã«ã¯ã - <filename>mimePart.php</filename>ã使ç¨ããæ¹ãè¯ãããããã¾ããã - </simpara> - </refsect1> - - <refsect1> - <title>constructor</title> - <simpara> - ã³ã³ã¹ãã©ã¯ã¿ã¯ã弿°ã1ã¤ã ãã¨ãã¾ãããã®å¼æ°ã¯ã使ç¨ããè¡æ« - ã®åã§ããæ¨æºã¯ãCRLFã§ããã*nixã§ã¯LFãåºã使ãããMacã¯CRã§ãã - </simpara> - </refsect1> - <refsect1> - <title><function>setTXTBody</function></title> - <simpara> - ãã®é¢æ°ã¯ãemailã®ããã¹ãé¨åãè¨å®ãã¾ãã以ä¸ã«ç¤ºã弿°ã2㤠- ã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$data</parameter> - è¨å®ããããã¹ãã¾ãã¯ä½¿ç¨ãã - ããã¹ããã¡ã¤ã«ã®ãã¡ã¤ã«åã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfile</parameter> - ãªãã·ã§ã³ã&true;ã®å ´åã - <parameter>$data</parameter>ã¯ãã¡ã¤ã«åã¨ä»®å®ãããèªã¿è¾¼ã¾ã - ã¾ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>setHTMLBody</function></title> - <simpara> - ãã®é¢æ°ã¯ãemailã®HTMLã®é¨åãè¨å®ãã¾ããæ¬¡ã®2ã¤ã®å¼æ°ãã¨ãã¾ - ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$data</parameter> - è¨å®ããHTMLã¾ãã¯ã使ç¨ããã - ãã¹ããã¡ã¤ã«ã®ãã¡ã¤ã«åã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfile</parameter> - ãªãã·ã§ã³ã&true;ã®å ´åã - <parameter>$data</parameter>ã¯ãã¡ã¤ã«åã¨ä»®å®ãããèªã¿è¾¼ã¾ã - ã¾ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>addHTMLImage</function></title> - <simpara> - åè¾¼ã¿ã¤ã¡ã¼ã¸ã¨ãã¦HTML emailãéä¿¡ããå ´åããã®é¢æ°ãã¤ã¡ã¼ã¸ - ã追å ããããã«ä½¿ç¨ãã¦ä¸ããããã®é¢æ°ã¯ä»¥ä¸ã®4ã¤ã®å¼æ°ãã¨ãã¾ - ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$file</parameter> - ãã¡ã¤ã«åã¾ãã¯å®éã®ãã¡ã¤ã« - ãã¼ã¿èªä½ã - </para> - </listitem> - <listitem> - <para> - <parameter>$c_type</parameter> - ã¤ã¡ã¼ã¸/ãã¡ã¤ã«ã®content - typeãæå®ãããªãå ´åã®ããã©ã«ãã¯ãapplication/octet-streamã - </para> - </listitem> - <listitem> - <para> - <parameter>$name</parameter> - ã¤ã¡ã¼ã¸/ãã¡ã¤ã«ã®ãã¡ã¤ã«åã - æå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfilename</parameter> - - <parameter>$file</parameter>弿°ããã¡ã¤ã«åã¨ãããã©ããã - &true;ã®å ´åããã®ãã¡ã¤ã«ãèªã¿è¾¼ã¾ãã¾ããæå®ãããªãå ´åã® - ããã©ã«ãã¯ã&true;ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - <para> - <emphasis>注æ:</emphasis> - ãã®é¢æ°ã¯ãåãè¾¼ã¿ã¤ã¡ã¼ã¸ã使ç¨å¯è½ã¨ããã ãã§ããä»ã®ãã¡ã¤ - ã«åãä¾ãã°flashã ã¼ãã¼ããåãè¾¼ã¿å¯è½ã§ãã - </para> - </refsect1> - <refsect1> - <title><function>addAttachment</function></title> - <simpara> - emailã«æ·»ä»ãã¡ã¤ã«ã追å ããããã®é¢æ°ã¯å¼æ°ã以ä¸ã®5åã¨ãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$file</parameter> - ãã¡ã¤ã«åã¾ãã¯ãã¡ã¤ã«ãã¼ã¿ - èªä½ã - </para> - </listitem> - <listitem> - <para> - <parameter>$c_type</parameter> - ãã¡ã¤ã«ã®Content typeã - æå®ãããªãå ´åã®ããã©ã«ãã¯ãapplication/octet-streamã - </para> - </listitem> - <listitem> - <para> - <parameter>$name</parameter> - ãã¡ã¤ã«ã®ãã¡ã¤ã«åã - æå®ãããªãå ´åã®ããã©ã«ãã¯ã空ç½ã - </para> - </listitem> - <listitem> - <para> - <parameter>$isfilename</parameter> - - <parameter>$file</parameter>弿°ããã¡ã¤ã«åã¨ãããã©ããã - &true;ã®å ´åããã®ãã¡ã¤ã«ãèªã¿è¾¼ã¾ãã¾ããæå®ãããªãå ´åã® - ããã©ã«ãã¯ã&true;ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$encoding</parameter> - ãã¡ã¤ã«ãã¼ã¿ã«é¢ãã¦ä½¿ç¨ - ããtransfer encodingã®åãæå®ãããªãå ´åã®ããã©ã«ãã¯ã - base64ã§ãã(ä¾ãã°scripts/htmlã¨ãã£ã)ããã¹ããã¼ã¹ã®ãã¡ã¤ - ã«ã®å ´åãquoted-printableãæå®ãããã¨ãå¯è½ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>get</function></title> - <simpara> - ãã®é¢æ°ã¯ãtext/html/images/attachmentsã追å ãã度ã«ï¼åº¦ã³ã¼ã« - ããã¾ãããã®é¢æ°ã¯ãemailã使ããè¿ãã¾ãã - éä¿¡ã¯è¡ãã¾ããã(headers()颿°ã¨çµã¿åããã¦)ãã®é¢æ°ãè¿ããã® - ãéä¿¡ããã«ã¯ããã®ããã¥ã¡ã³ãã§èª¬æããã¦ãã - <link linkend="core.mail.phpmail">Mail_mail</link>, - <link linkend="core.mail.sendmail">Mail_sendmail</link>, - <link linkend="core.mail.smtp">Mail_smtp</link>ã¯ã©ã¹ã®ï¼ã¤ã®ä½¿ç¨ - ããå¿ è¦ãããã¾ãããã®é¢æ°ã¯å¼æ°ãï¼ã¤ã ãã¨ããããã¯ããã©ã¡ã¼ - ã¿ã®é£æ³é åã§ãããããã®ãã©ã¡ã¼ã¿ã¯ãemailã®ä½ææ¹æ³ã夿´ãã - ãã®ã§ã以ä¸ã®è¦ç´ ãããªãã¾ãã - </simpara> - <para> - <itemizedlist> - <listitem> - <para> - <parameter>$text_encoding</parameter> - emailã®ãã¬ã¼ã³ããã¹ - ããã¼ãã§ä½¿ç¨ããã¨ã³ã³ã¼ãã£ã³ã°ã®åãããã©ã«ãã¯ã7bitã - </para> - </listitem> - <listitem> - <para> - <parameter>$html_encoding</parameter> - emailã®HTMLãã¼ãã§ä½¿ - ç¨ããã¨ã³ã³ã¼ãã£ã³ã°ã®åãããã©ã«ãã¯ãquoted-printableã - </para> - </listitem> - <listitem> - <para> - <parameter>$7bit_wrap</parameter> - ããã¹ããæãè¿ãæåæ°ã - SMTPã¯ã1è¡ã®æå¤§é·ãCRLFãå«ãã§1000æåã¨è¦å®ãã¦ãã¾ããã - ãã©ã«ãã¯ã998æå(CRLFãå«ãã§1000æå)ã§ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$text_charset</parameter> - emailã®ãã¬ã¼ã³ããã¹ã - ãã¼ãã§ä½¿ç¨ãããæåæ¥ã¨ãããã©ã«ãã¯ãiso-8859-1ã - </para> - </listitem> - <listitem> - <para> - <parameter>$html_charset</parameter> - emailã®HTMLãã¼ãã§ä½¿ç¨ - ãããæåã»ãããããã©ã«ãã¯ãiso-8859-1ã§ãã - </para> - </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1> - <title><function>headers</function></title> - <simpara> - ãã®é¢æ°ã¯ãemailã§å¿ è¦ãªé©åãªãããã飿³é åã¨ãã¦è¿ãã¾ãã - ãã®é£æ³é åã¯ãMail_mail, Mail_sendmail, Mail_smtpã¯ã©ã¹ã«ç´æ¥æ¸¡ - ããã¨ãå¯è½ã§ãããã®é¢æ°ã¯ã<function>get</function>ãã³ã¼ã«ã - ãå¾ã«ã³ã¼ã«ããå¿ è¦ãããã¾ããããã¯ã<function>get</function> - ãããã¤ãã®å¿ è¦ãªããããçæããããã§ãããã®é¢æ°ã¯ã弿°ãï¼ - ã¤ã ãã¨ããããã¯ãè¿ããããããã®é£æ³é åã«ãå«ã¾ãã¾ãã - ãã®é åã®ãã¼ã¯ãããå(ä¾ From, Subject, X-Mailer)ã¨ããå¤ã¯ã - ãã®ãããã®å¤ã¨ããå¿ è¦ãããã¾ãã - </simpara> - </refsect1> - <refsect1> - <title>ä¾:</title> - <simpara> - 以ä¸ã®ä¾ã¯ãè²¼ä»ãã¡ã¤ã«ãæããé常ã«ç°¡åãªhtml/text emailã使 - ããmailãã©ã¤ãã®Mail::send()颿°(ããªãã¡ãMail_mail::send())ã - ç¨ãã¦éä¿¡ãããã®ã§ãã - </simpara> - <programlisting role="php"> -<![CDATA[ -include('Mail.php'); -include('Mail/mime.php'); - -$text = 'Text version of email'; -$html = '<html><body>HTML version of email</body></html>'; -$file = '/home/richard/example.php'; -$crlf = "\r\n"; -$hdrs = array( - 'From' => 'richard@phpguru.org', - 'Subject' => 'Test mime message' - ); - -$mime = new Mail_mime($crlf); - -$mime->setTXTBody($text); -$mime->setHTMLBody($html); -$mime->addAttachment($file, 'text/plain'); - -$body = $mime->get(); -$hdrs = $mime->headers($hdrs); - -$mail =& Mail::factory('mail'); -$mail->send('joe@example.com', $hdrs, $body); -]]> - </programlisting> - </refsect1> - </refentry> - - <refentry id="core.mail.mimeDecode"> - <refnamediv> - <refname>Mail/mimeDecode.php</refname> - <refpurpose>MIMEã¡ãã»ã¼ã¸ã§åä½ããã¯ã©ã¹</refpurpose> - </refnamediv> - <refsect1> - <title>説æ</title> - - <simpara> - ãã®ã¯ã©ã¹ã¯ã mime emails/messageä½æãæ¯æ´ãããã¼ã«ã§ãã - ãã®é¢æ°ã¯æå®ããå ¥åãæç¨ãªPHPãã¼ã¿æ§é ã«ãã³ã¼ããã¾ãã - ãã¼ã¿æ§é ã¯ã以ä¸ã®è¦ç´ ãæãããªãã¸ã§ã¯ãã§ãã - </simpara> - <para> - <emphasis>headers:</emphasis> ãããã®é£æ³é åãé åã®ãã¼ã¯ããã - ãå(å°æåã«å¤æ)ãå¤ã¯ãã®ãããã®å¤(大æåå°æåã¯ãã®ã¾ã¾)ã§ - ãã(Recieved:ã®ããã«)åãååã§è¤æ°ã®ããããããå ´åãåããã - ã®å¤ã®æ°å¤æ·»åã®é åã¨ãªãã¾ãããã©ã¡ã¼ã¿decode_headersã«&true; - ãæå®ãããå ´åããããã¯ãã³ã¼ãããã¾ãã(RFC2047) - </para> - <para> - <emphasis>ctype_primary:</emphasis> content typeã®æåã®é¨åã - (ããªãã¡ãååãã¹ã©ãã·ã¥ã®å) ä¾ãã°ãcontent typeã - multipart/mixedã®å ´åãctype_primaryã¯"multipart"(å¼ç¨ç¬¦ã¯å«ã¾ã) - ã¨ãªãã¾ãã - </para> - <para> - <emphasis>ctype_secondary:</emphasis> content typeã®2çªç®é¨åã - ä¾ãã°ãcontent typeãmultipart/mixedã®å ´åãctype_secondary㯠- "mixed" (å¼ç¨ç¬¦ã¯å«ã¾ã)ã¨ãªãã¾ãã - </para> - <para> - <emphasis>ctype_parameters:</emphasis> content typeãããã«ãã©ã¡ã¼ - ã¿ãããå ´å(ä¾ãã°ãboundary="=_hudfhdsalfhds8fy8329hfj")ããã® - 飿³é åã«ä»£å ¥ããã¾ãããã¼ã¯ããã©ã¡ã¼ã¿å(ä¾ boundary)ãä¸ - æ¹ãå¤ã¯ãã®ãã©ã¡ã¼ã¿ã®å¤(ä¾ =_hudfhdsalfhds8fy8329hfj )ã¨ãªãã¾ - ãã - </para> - <para> - <emphasis>disposition:</emphasis> Content-Dispositionãããããã - å ´åããã®å¤ãããã«æå®ããã¾ããããã¯ãé常ã"inline"ã¾ã㯠- "attachment" (å¼ç¨ç¬¦ã¯å«ã¾ã)ã®ã©ã¡ããã§ãã - </para> - <para> - <emphasis>d_parameters:</emphasis> Content-Dispositionã«ä½ããã® - ãã©ã¡ã¼ã¿ãæå®ãããå ´åãããã«é£æ³é åãä»£å ¥ããããã¼ã¯ãã© - ã¡ã¼ã¿åãå¤ã¯ãã®ãã©ã¡ã¼ã¿ã®å¤ã¨ãªãã¾ãã"name"ã¨"filename"ã - ããããä¾ã§ãã - </para> - <para> - <emphasis>body:</emphasis> (éçã¾ãã¯é常ã®å¤æ°ã®ã©ã¡ããã§)ãã® - ã¯ã©ã¹ã®ã¤ã³ã¹ã¿ã³ã¹ãçæããéã«include_bodiesãã©ã¡ã¼ã¿ãæå® - ãããéã«åé¡ã®é¨åãbodyãæããå ´åã«ä»£å ¥ããã¾ãã - content type multipart/*ãæããMIMEãã¼ãã¯ãé常ãbodyãæããã - ãµããã¼ãããæ§æããã¾ãããã©ã¡ã¼ã¿decode_bodiesã«&true;ãæå® - ãããå ´åãbodyã¯ãã³ã¼ãããã¾ãã - </para> - <para> - <emphasis>parts:</emphasis> ããMIMEãã¼ãããµããã¼ããããªãå ´ - åãããã§èª¬æãããã®ã¨åæ§ãªããããã£ãæãããªãã¸ã§ã¯ããã - ãªãé åã¨ãªãã¾ãã - </para> - </refsect1> - <refsect1> - <title><function>Mail_mimeDecode::constructor</function></title> - <simpara> - ãªãã¸ã§ã¯ãã¨ãã¦ã¤ã³ã¹ã¿ã³ã¹ä½æãè¡ãããå ´åãã³ã³ã¹ãã©ã¯ã¿ - ã¯å¼æ°ã以ä¸ã®äºã¤ã¨ãã¾ãã - </simpara> - <itemizedlist> - <listitem> - <para> - <parameter>$input</parameter> - ãã³ã¼ãããemail/messageã - </para> - </listitem> - <listitem> - <para> - <parameter>$crlf</parameter> - ãªãã·ã§ã³ã使ç¨ããè¡æ«è¨å·ãæ - å®ãã¾ããé常ã¯ãCRLFã¾ãã¯LFã®ã¿ã§ãããã®ãªãã·ã§ã³ã¯ããã® - ã¯ã©ã¹ãåä½ãããã©ããã®éããçããã¨ãããã¾ãã - ãã®å¼æ°ã§æå®ãããã®ã ããemailã§ç¢ºå®ã«ä½¿ç¨ãããã¨ãå¼·ãæ¨å¥¨ - ããã¾ããããã©ã«ãã¯ãCRLFã§ãã - </para> - </listitem> - </itemizedlist> - </refsect1> - - <refsect1> - <title><function>Mail_mimeDecode::decode</function></title> - <simpara> - ãã®é¢æ°ã¯ããã³ã¼ããè¡ããä¸è¨ã®æ§é ä½ãè¿ãã¾ãããã®é¢æ°ã¯ã - 弿°ã¨ãã¦ãã©ã¡ã¼ã¿ã®é£æ³é åã®ã¿ãã¨ãã¾ãããããã®ãã©ã¡ã¼ã¿ - ã¯ã次ã®è¦ç´ ãããªãã¾ãã - </simpara> - <itemizedlist> - <listitem> - <para> - <parameter>$include_bodies</parameter> - è¿ãããæ§é ä½ã«bodyã - å«ããã©ããã - </para> - </listitem> - <listitem> - <para> - <parameter>$decode_bodies</parameter> - è¿ãããbodyããã³ã¼ã - ãããã©ããã - </para> - </listitem> - <listitem> - <para> - <parameter>$decode_headers</parameter> - ãããããã³ã¼ãããã - ã©ããã(RFC2047) - </para> - </listitem> - <listitem> - <para> - <parameter>$input</parameter> - éçã«ã³ã¼ã«ãããå ´åã®ã¿ã - ãã®å ¥åããã³ã¼ããããã©ãããæå®ããããã«ä½¿ç¨ããã¾ãã - </para> - </listitem> - <listitem> - <para> - <parameter>$crlf</parameter> - éçã«ã³ã¼ã«ãããå ´åã®ã¿ã - è¡æ«ãæå®ããããã«ä½¿ç¨ããã¾ãã - </para> - </listitem> - </itemizedlist> - </refsect1> - - <refsect1> - <title><function>Mail_mimeDecode::uudecode</function></title> - <simpara> - ãã®ã¡ã½ããã¯ãã¯ã©ã¹ã®ãã³ã¼ãå¦çé¨ããã³ã¼ã«ããããå®è¡å¯è½ - ãªã¡ã½ããã¨ãã¦å«ã¾ãã¦ãã¾ãã - ä½ããã®å ¥åãæå®ããã¨ãuuencodeãããæ·»ä»ãã¼ã¿ã確èªãããã¡ - ã¤ã«ãã¼ã¿ããã¡ã¤ã«è¨±å¯å±æ§ããã¡ã¤ã«åãããªã飿³é åã¨ãã¦è¿ - ãã¾ãããã®ã¡ã½ããã¯ã調ã¹ããã¼ã¿å ¥åã弿°ã¨ãã¦1ã¤ã ãã¨ãã¾ - ãããã®é¢æ°ã¯ããã®ã¯ã©ã¹ã®æ®ãã®æ©è½ã使ç¨ããªãå ´åã§ãéçã« - ã³ã¼ã«ãããã¨ãå¯è½ã§ãã - </simpara> - </refsect1> - - <refsect1> - <title><function>Mail_mimeDecode::getXML</function></title> - <simpara> - ãã®ã¡ã½ããã¯ããã®ã¯ã©ã¹ã®ãã³ã¼ãå¦çé¨ããã¯ã³ã¼ã«ããã¾ããã - ãã®ã¡ã½ããã¯ã<function>decode</function>ã«ããè¿ãããåºåãå¼ - æ°ã¨ããhttp://www.phpguru.org/xmail/ã§å®ç¾©ãããDTDã¾ãã¯(å©ç¨å¯ - è½ãªå ´åã«ã¯)PEAR mimeããã±ã¼ã¸ãç¨ãã¦XMLã«å¤æãã¾ãããã®ã¡ã½ã - ãã¯ã弿°ã1ã¤ã ãåããããã¯ã<function>decode</function>ã¡ã½ã - ãããè¿ããããã¼ã¿ã§ãã - </simpara> - </refsect1> - - <refsect1> - <title>使ç¨ä¾:</title> - - <simpara> - ãã®ä¾ã¯ããªãã¸ã§ã¯ãã®ã¤ã³ã¹ã¿ã³ã¹ã使ããdecode颿°ãå®è¡ã - ã¾ãã - </simpara> - - <programlisting role="php"> -<![CDATA[ -$params['include_bodies'] = TRUE; -$params['decode_bodies'] = TRUE; -$params['decode_headers'] = TRUE; - -$decoder = new Mail_mimeDecode($input); -$structure = $decoder->decode($params); -]]> - </programlisting> - - <para> - ãã®ä¾ã¯ãdecode颿°ãéçã«ã³ã¼ã«(ããªãã¡ããªãã¸ã§ã¯ãã使ã - ãã«é¢æ°ãç´æ¥ã³ã¼ã«)ããå¾ã<function>getXML</function>颿°ã«æ§ - é ä½ã渡ãã¾ãã - <programlisting role="php"> -<![CDATA[ -$params['include_bodies'] = TRUE; -$params['decode_bodies'] = FALSE; -$params['decode_headers'] = TRUE; -$params['input'] = $input; -$params['crlf'] = "\r\n"; - -$structure = Mail_mimeDecode::decode($params); -$xml = Mail_mimeDecode::getXML($structure); -]]> - </programlisting> - </para> - - </refsect1> - </refentry> </reference> <!-- Keep this comment at the end of the file