cvs: peardoc /ja/core/mail intro.xml mail.xml

From: Date: Sun, 01 Dec 2002 23:30:34 +0000
Subject: cvs: peardoc /ja/core/mail intro.xml mail.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-93@lists.php.net to get a copy of this message
hirokawa Sun Dec 1 18:30:34 2002 EDT Added files: /peardoc/ja/core/mail intro.xml mail.xml Log: added mail/* in japanese manual.

Index: peardoc/ja/core/mail/intro.xml +++ peardoc/ja/core/mail/intro.xml <!-- $Id: intro.xml,v 1.1 2002/12/01 23:30:34 hirokawa Exp $ --> <refentry id="core.mail.intro"> <refnamediv> <refname>Introduction</refname> <refpurpose>A overview about Mail</refpurpose> </refnamediv> <refsect1 id="core.mail.intro.send"> <title>emailの送信</title> <para> <link linkend="core.mail.mail"><classname>Mail</classname></link>は、 異なる方法でemailを送信するAPIを提供します。<ulink url="http://www.php.net/manual/en/ref.mail.php"><function>mail</function> </ulink>があるのでこのクラスは不要だと思われるかも知れません。 しかし、この関数はローカルにインストールされたsendmail互換のプログ ラムでしか動作しません。このクラスにより異なるバックエンドでメール を送信することが自由にできるようになります。このため、ホストコンピュー タ上で動作する<function>mail</function>関数に接続しない、可搬 性のあるアプリケーションを簡単に作成できるようになります。 </para> </refsect1> <refsect1 id="core.mail.intro.mime"> <title>マルチパートメッセージとMIMEメッセージを作成する</title> <para> 特にビジネス環境では、顧客は添付を含む正しい形式のemailを期待します。 <classname>Mail_Mime</classname>クラスは、MIME形式のemailを簡単に作 成、処理する機能を提供します。 </para> </refsect1> <refsect1 id="core.mail.intro.address"> <title>emailアドレスを処理</title> <para> emailアドレスを処理することは容易ではありません。しかし、emailアド レスの検証および処理は、しばしばWebアプリケーションで行われます。 <classname>Mail_RFC822</classname>は、 <ulink url="http://www.faqs.org/rfcs/rfc822.html">RFC 822</ulink>に基 づくemailアドレスの解析を支援します。 </para> </refsect1> </refentry> <!-- 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 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 --> Index: peardoc/ja/core/mail/mail.xml +++ peardoc/ja/core/mail/mail.xml <!-- $Id: mail.xml,v 1.1 2002/12/01 23:30:34 hirokawa Exp $ --> <refentry id="core.mail.mail"> <refnamediv> <refname>Mail</refname> <refpurpose>email送信用インターフェイス</refpurpose> </refnamediv> <refsect1 id="core.mail.mail.backend"> <title>複数のバックエンド</title> <para> <classname>Mail</classname>は、emailを送信するための異なる形式のバッ クエンドをサポートします。このため、emailを送信するために2段階の手 順が必要です。 <itemizedlist> <listitem> <simpara>手順1</simpara> <para> 指定した<classname>Mail</classname>の新規インスタンス、つまり、 <link linkend="core.mail.mail.factory"><function>factory</function></link>-メソッドを 有するバックエンドを作成します。 </para> </listitem> <listitem> <simpara>手順2</simpara> <para> <link linkend="core.mail.mail.send"><function>send</function></link>を 用いてメールを送信します。 </para> </listitem> </itemizedlist> </para> <para> <classname>Mail</classname>は以下の3種類のバックエンドをサポートします。 <itemizedlist> <listitem> <para><parameter>mail</parameter></para> <para> PHPの組込関数<function>mail</function>を使用して送信します。 </para> </listitem> <listitem> <para><parameter>sendmail</parameter></para> <para> sendmailプログラムにより送信します。 </para> </listitem> <listitem> <para><parameter>smtp</parameter></para> <para> smtpサーバに直接接続してメールを送信します。 </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="core.mail.mail.factory"> <title>Mail::Factory()</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>&amp;factory</function></funcdef> <paramdef>string <parameter>$backend</parameter></paramdef> <paramdef> array <parameter><optional>$param = array()</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <refsect2 id="core.mail.mail.factory.description"> <title>説明</title> <para> バックエンド毎のmailクラスのインスタンスを生成します。 </para> </refsect2> <refsect2 id="core.mail.mail.factory.parameter"> <title>パラメータ</title> <para> <itemizedlist> <listitem> <para> <parameter>string $backend</parameter> - バックエンド名 <parameter>"mail"</parameter>,<parameter>"smtp"</parameter>, <parameter>"sendmail"</parameter> </para> </listitem> <listitem> <para> <parameter>array $param</parameter> - バックエンド固有のパラメータの配列。使用可能な値については注記 を参照して下さい。このパラメータはオプションとされていますが、 現時点で各実装はこのパラメータを必要としています。 </para> </listitem> </itemizedlist> </para> </refsect2> <refsect2 id="core.mail.mail.factory.return"> <title>返り値</title> <para> <itemizedlist> <listitem> <para> <parameter>mixed</parameter> - 特定のMailインスタンスまたは 失敗した場合に<classname>PEAR_Error</classname>オブジェクト </para> </listitem> </itemizedlist> </para> </refsect2> <refsect2 id="core.mail.mail.factory.note"> <title>注記</title> <para> バックエンドのパラメータ一覧 <itemizedlist> <listitem> <para> <parameter>mail</parameter> <itemizedlist> <listitem> <para>追加オプションなし</para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <parameter>sendmail</parameter> <itemizedlist> <listitem> <para> <parameter>$param["sendmail_path"]</parameter> - システム上でのsendmailプログラムの場所、デフォルトは、 <parameter>/usr/bin/sendmail</parameter>です。 </para> </listitem> <listitem> <para> <parameter>$param["sendmail_args"]</parameter> - sendmailプログラムへ渡す追加パラメータ。 </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <parameter>smtp</parameter> <itemizedlist> <listitem> <para> <parameter>$param["host"]</parameter> - 接続するサーバ。 デフォルトは、<parameter>localhost</parameter>です。 </para> </listitem> <listitem> <para> <parameter>$param["port"]</parameter> - 接続するポート。 デフォルトは、<parameter>25</parameter>です。 </para> </listitem> <listitem> <para> <parameter>$param["auth"]</parameter> - SMTP認証を使用するか どうか。デフォルトは<parameter>false</parameter>です。 </para> </listitem> <listitem> <para> <parameter>$param["username"]</parameter> - SMTP認証で使用す るユーザ名。 </para> </listitem> <listitem> <para> <parameter>$param["password"]</parameter> - SMTP認証で使用す るパスワード。 </para> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </para> </refsect2> </refsect1> <refsect1 id="core.mail.mail.send"> <title>Mail_*::send()</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>send</function></funcdef> <paramdef>mixed <parameter>$recipients</parameter></paramdef> <paramdef>array <parameter>$headers</parameter></paramdef> <paramdef>string <parameter>$body</parameter></paramdef> </funcprototype> </funcsynopsis> <refsect2 id="core.mail.mail.send.description"> <title>説明</title> <para> メールを送信します。<function>send</function>関数は、<link linkend="core.mail.mail.factory"><function>factory</function> から返されたオブジェクトにより提供されます。 </link> </para> </refsect2> <refsect2 id="core.mail.mail.send.parameter"> <title>パラメータ</title> <para> <itemizedlist> <listitem> <para> <parameter>mixed $recipients</parameter> - 配列またはカンマ区切 りで受信者を保持する配列または文字列。 </para> </listitem> <listitem> <para> <parameter>array $headers</parameter> - ヘッダの連想配列。ヘッダ名はキーとして、ヘッダの値は値として使 用されます。 </para> </listitem> <listitem> <para> <parameter>string $body</parameter> - emailの本文。 </para> </listitem> </itemizedlist> </para> </refsect2> <refsect2 id="core.mail.mail.send.return"> <title>返り値</title> <para> <itemizedlist> <listitem> <para> <parameter>mixed</parameter> - <parameter>true</parameter>また は失敗した場合に<classname>PEAR_Error</classname>オブジェクト </para> </listitem> </itemizedlist> </para> </refsect2> </refsect1> <refsect1 id="core.mail.mail.example"> <title>例</title> <para> <programlisting role="php"> <![CDATA[ <?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'; $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> </para> </refsect1> </refentry> <!-- 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 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 -->
« previous php.pear.doc (#93) next »