ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 912705841956ea969e25d8d1cc99f8d105d1ce78 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><constant>INI_PERDIR</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.mail.mixed_lf_and_crlf">mail.mixed_lf_and_crlf</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_SYSTEM</constant>|<constant>INI_PERDIR</constant></entry>
     <entry>PHP 8.2.4 で追加されました。</entry>
    </row>
    <row>
     <entry><link linkend="ini.mail.log">mail.log</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_SYSTEM</constant>|<constant>INI_PERDIR</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.mail.force_extra_parameters">mail.force_extra_parameters</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.smtp">SMTP</link></entry>
      <entry>"localhost"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
     <entry><link linkend="ini.smtp-port">smtp_port</link></entry>
      <entry>"25"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
     <entry><link linkend="ini.sendmail-from">sendmail_from</link></entry>
      <entry>NULL</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
     <entry><link linkend="ini.sendmail-path">sendmail_path</link></entry>
     <entry>"/usr/sbin/sendmail -t -i"</entry>
      <entry><constant>INI_SYSTEM</constant></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.mixed_lf_and_crlf">
   <term>
    <parameter>mail.mixed_lf_and_crlf</parameter>
    <type>bool</type>
   </term>
   <listitem>
    <para>
     メールヘッダとメッセージボディの改行をLF(Line Feed) に戻せるようにします。
     これは、PHP 7 の RFC に準拠しない振る舞いを真似るものです。
     この設定は、メールヘッダとメッセージの改行コード CRLF(Carriage Return + Line Feed) 
     を正しく処理できない RFC 非準拠の MTA と互換性を取るために提供されています。
    </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>
    <simpara>
     <constant>INI_SYSTEM</constant> のデフォルトの振る舞いに加えて、
     この値は <filename>httpd.conf</filename> の <literal>php_value</literal>
     を使って設定することもできます(が、お勧めはしません)。
    </simpara>
   </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
-->