archived-doc-pt-br/reference/mail/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 912705841956ea969e25d8d1cc99f8d105d1ce78 Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,leonardolara -->
<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>Opções de configuração da função 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>Adicionada no 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>
     Adiciona <literal>X-PHP-Originating-Script</literal> que incluirá o UID do
     script seguido pelo nome do arquivo.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mail.log">
   <term>
    <parameter>mail.log</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     O caminho para o arquivo de registro que irá armazenar todas as chamadas à função <function>mail</function>.
     As entradas de registro incluirão o caminho completo do script, número da linha,
     endereço de destino <literal>To</literal> e cabeçalhos.
    </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>
     Permite reverter o separador de linha para cabeçalhos de e-mail e corpos de mensagem para LF (Alimentação de Linha),
     imitando o comportamento não compatível do PHP 7. É fornecido como uma medida de compatibilidade
     para certos Agentes de Transferência de Correio Eletrônico (MTAs) não compatíveis que falham em processar corretamente CRLF
     (Retorno de Carro + Alimentação de Linha) como um separador de linha em cabeçalhos de e-mail e conteúdo de mensagem.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.mail.force_extra_parameters">
   <term>
    <parameter>mail.force_extra_parameters</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Força a adição de parâmetros específicos que serão passados como
     parâmetros extras para o binário sendmail. Estes parâmetros sempre substituirão
     o valor do quinto parâmetro da função <function>mail</function>.
    </para>
    <simpara>
     Além do comportamento padrão para <constant>INI_SYSTEM</constant>,
     este valor também pode ser definido com <literal>php_value</literal>
     no <filename>httpd.conf</filename> (mas isto não é recomendado).
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.smtp">
   <term>
    <parameter>SMTP</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Usado somente no Windows: nome de servidor ou endereço IP do servidor SMTP que o PHP
     deve usar para e-mail envio com a função <function>mail</function>.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.smtp-port">
   <term>
    <parameter>smtp_port</parameter>
    <type>int</type>
   </term>
   <listitem>
    <para>
     Usado somente no Windows: Número da porta para se conectar ao servidor
     definido com a configuração de <literal>SMTP</literal> ao enviar e-mail
     com a função <function>mail</function>; a porta padrão é 25.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.sendmail-from">
   <term>
    <parameter>sendmail_from</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Qual endereço de e-mail <literal>"From:"</literal> deve ser usado no e-mail
     enviado diretamente via SNMP (somente Windows).
     Esta diretiva também define o cabeçalho <literal>"Return-Path:"</literal>.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.sendmail-path">
   <term>
    <parameter>sendmail_path</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     Onde o programa <command>sendmail</command> pode ser encontrado,
     normalmente em <filename>/usr/sbin/sendmail</filename> ou
     <filename>/usr/lib/sendmail</filename>.
     <command>configure</command> faz uma tentativa de
     localizar e definir o padrão, mas se ele falhar,
     pode ser definido aqui.
    </para>
    <para>
     Sistema que não usam o <command>sendmail</command> devem configurar essa diretiva para a
     alternativa ao sendmail que o sistema oferece, se houver.
     Por exemplo, usuários do <link xlink:href="&url.qmail;">Qmail</link>
     normalmente usam
     <filename>/var/qmail/bin/sendmail</filename> ou <filename>
     /var/qmail/bin/qmail-inject</filename>.
    </para>
    <para>
     <command>qmail-inject</command> não requer nehuma opção
     para o processar o e-mail corretamente.
    </para>
    <para>
     Esta diretiva também funciona no Windows. Se definida, <varname>smtp</varname>,
     <varname>smtp_port</varname> e <varname>sendmail_from</varname> são
     ignorados e o comando especificado é executado.
    </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
-->