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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<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>Конфигурационные опции отправки писем</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.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>|<constant>INI_PERDIR</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.force_extra_parameters">

    <term>
     <parameter>mail.force_extra_parameters</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Принудительно добавить указанные параметры для отправки в sendmail.
      Эти параметры всегда заменяют значение пятого параметра в <function>mail</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.smtp">
    <term>
     <parameter>SMTP</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Используется только в Windows: домен или IP-адрес SMTP-сервера, к которому будет
      обращаться PHP при отправке почты функцией <function>mail</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.smtp-port">
    <term>
     <parameter>smtp_port</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Используется только в Windows: порт <literal>SMTP</literal>-сервера, к которому будет
      обращаться PHP при отправке почты функцией <function>mail</function>;
      по умолчанию 25.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.sendmail-from">
    <term>
     <parameter>sendmail_from</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Адрес, который будет использоваться в заголовке <literal>"From:"</literal> в
      письмах, отправляемых напрямую через SMTP (только для 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> пытается найти sendmail автоматически
      и установить значение по умолчанию самостоятельно, но если это
      не удалось, вы можете установить путь здесь.
     </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
-->