archived-doc-ja/reference/mail/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 10c85e65bb92ed3677329a8985a7ed0b07c35171 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<section xml:id="mail.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Mail 設定オプション</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
    <row>
     <entry><link linkend="ini.mail.add-x-header">mail.add_x_header</link></entry>
     <entry>"0"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.mail.log">mail.log</link></entry>
     <entry>NULL</entry>
     <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.mail.force_extra_parameters">mail.force_extra_parameters</link></entry>
     <entry>NULL</entry>
     <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.smtp">SMTP</link></entry>
      <entry>"localhost"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
     <entry><link linkend="ini.smtp-port">smtp_port</link></entry>
      <entry>"25"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
     <entry><link linkend="ini.sendmail-from">sendmail_from</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
     <entry><link linkend="ini.sendmail-path">sendmail_path</link></entry>
     <entry>"/usr/sbin/sendmail -t -i"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 &ini.php.constants;
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
  <varlistentry xml:id="ini.mail.add-x-header">
   <term>
    <parameter>mail.add_x_header</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     <literal>X-PHP-Originating-Script</literal> を追加します。
     それはスクリプトの UID を含み、その後にファイル名が続きます。
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mail.log">
   <term>
    <parameter>mail.log</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     ログファイルへのパス。<function>mail</function>
     がコールされるたびにこのファイルに記録します。
     ログに含まれる内容は、スクリプトのフルパスと行番号、そして
     <literal>To</literal> アドレスとヘッダです。
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mail.force_extra_parameters">
   <term>
    <parameter>mail.force_extra_parameters</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     指定したパラメータを、sendmail バイナリへの追加パラメータとして強制的に渡します。
     これらのパラメータは、たとえセーフモードであっても、常に
     <function>mail</function> の第 5 パラメータの値を上書きします。
    </para>
   </listitem>
  </varlistentry>

   <varlistentry xml:id="ini.smtp">
    <term>
     <parameter>SMTP</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Windows 環境のみで使用されます: 
      <function>mail</function> 関数でメールを送信する際に使用する
      SMTP サーバーのホスト名または IP アドレス。
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.smtp-port">
    <term>
    <parameter>smtp_port</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Windows 環境のみで使用されます: 
      <literal>SMTP</literal> 設定で指定したサーバーに接続するポート番号で、
      デフォルトは 25 です。
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.sendmail-from">
    <term>
     <parameter>sendmail_from</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      SMTP 経由で直接送信されるメールにおいて <literal>"From:"</literal>
      に使用するメールアドレスを指定します(Windows環境のみ)。
      このディレクティブは、<literal>"Return-Path:"</literal> ヘッダも設定します。
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.sendmail-path">
    <term>
     <parameter>sendmail_path</parameter>
     <type>string</type>
   </term>
    <listitem>
    <para>
      <command>sendmail</command> プログラムを探すパスを指定します。
      通常、<filename>/usr/sbin/sendmail</filename> または
      <filename>/usr/lib/sendmail</filename> です。
      <command>configure</command> は、このパスを探し、
      デフォルト値として設定しますが、
      これで上手くいかない場合にはこのオプションで設定する必要があります。
     </para>
     <para>
      <command>sendmail</command> を使用していないシステムは、
      使用するメールシステムが提供する sendmail のラッパー/代替品を、
      必要に応じてこのディレクティブに設定する必要があります。例えば、<link
       xlink:href="&url.qmail;">Qmail</link> ユーザーは、通常
      <filename>/var/qmail/bin/sendmail</filename> または
      <filename>/var/qmail/bin/qmail-inject</filename> に設定します。
     </para>
     <para>
      <command>qmail-inject</command> では、
      メールを正しく処理するためのオプション設定は不要です。
     </para>
     <para>
      このディレクティブは Windows 環境でも動作します。指定された場合は
      <varname>smtp</varname> および <varname>smtp_port</varname>・
      <varname>sendmail_from</varname> の値は無視され、
      ここで指定したコマンドが実行されます。
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
  
 </para>
</section>

<!-- 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:"~/.phpdoc/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
-->