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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 912705841956ea969e25d8d1cc99f8d105d1ce78 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DavidA -->

<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>&ConfigureOptions; para el correo</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>Disponible a partir de 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>|<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>
      Se añade un encabezado <literal>X-PHP-Originating-Script</literal> que incluye
      el UID del script, seguido por el nombre del fichero.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.mail.log">
    <term>
     <parameter>mail.log</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      La ruta del registro de todos los llamados a la función <function>mail</function>.
      Las entradas del registro incluyen la ruta completa hacia el script, el número de la línea,
      las direcciones <literal>To</literal> así como los encabezados.
     </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 volver al indicador de fin de línea para los encabezados de correo electrónico y los cuerpos de mensaje en LF (Line Feed),
      imitando el comportamiento no conforme de PHP 7. Se proporciona como medida de compatibilidad
      para ciertos Agentes de Transferencia de Correo (MTA) no conformes que fallan al tratar correctamente CRLF
      (Retorno de carro + Line Feed) como indicador de fin de línea en los encabezados de correo electrónico y el contenido de los mensajes.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.mail.force_extra_parameters">
    <term>
     <parameter>mail.force_extra_parameters</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Permite forzar la adición del parámetro especificado como
      parámetro adicional para sendmail. Estos parámetros reemplazarán
      al quinto parámetro de la función <function>mail</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.smtp">
    <term>
     <parameter>smtp</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Solo en Windows: nombre del host o dirección IP del SMTP que PHP debe utilizar
      para enviar un correo con la función <function>mail</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.smtp-port">
    <term>
     <parameter>smtp_port</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Solo en Windows: número de puerto a utilizar para conectarse
      al servidor <literal>SMTP</literal> al enviar correo con
      la función <function>mail</function>; por omisión, es 25.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.sendmail-from">
    <term>
     <parameter>sendmail_from</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Solo en Windows: valor del campo <literal>"From:"</literal> que
      debe ser utilizado al enviar correo vía SMTP (solo en Windows).
      Esta directiva definirá también el encabezado <literal>"Return-Path:"</literal>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.sendmail-path">
    <term>
     <parameter>sendmail_path</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Localización del programa <command>sendmail</command>: habitualmente
      <filename>/usr/sbin/sendmail</filename> o <filename>/usr/lib/sendmail</filename>.
      <command>configure</command> intenta detectar la presencia de sendmail
      por sí mismo, y asigna este resultado por omisión. En caso de
      problemas de localización, puede establecerse un nuevo valor por omisión aquí.
     </para>
     <para>
      Todo sistema que no utilice <command>sendmail</command> debe establecer esta
      directiva al camino del programa de sustitución que reemplaza al servidor de correo, si aquel existe. Por ejemplo, los usuarios de
      <link xlink:href="&url.qmail;">Qmail</link> pueden definirla a
     <filename>/var/qmail/bin/sendmail</filename> o <filename>
     /var/qmail/bin/qmail-inject</filename>.
     </para>
     <para>
      <command>qmail-inject</command> no requiere opciones para
      tratar correctamente el correo.
     </para>
     <para>
      Esta directiva funciona también en Windows. Si está definida, <varname>smtp</varname>,
      <varname>smtp_port</varname> y <varname>sendmail_from</varname> son
      ignorados y se ejecuta el comando especificado.
     </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
-->