<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mbstring.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.mb-send-mail.php',
    1 => 'mb_send_mail',
    2 => 'Env&iacute;a un correo electr&oacute;nico codificado',
  ),
  'up' => 
  array (
    0 => 'ref.mbstring.php',
    1 => 'Funciones de strings multibyte',
  ),
  'prev' => 
  array (
    0 => 'function.mb-scrub.php',
    1 => 'mb_scrub',
  ),
  'next' => 
  array (
    0 => 'function.mb-split.php',
    1 => 'mb_split',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/mbstring/functions/mb-send-mail.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mb-send-mail" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mb_send_mail</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.0.6, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">mb_send_mail</span> &mdash; <span class="dc-title">Envía un correo electrónico codificado</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.mb-send-mail-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mb_send_mail</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$to</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$subject</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$message</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.string.php" class="type string">string</a></span></span> <code class="parameter">$additional_headers</code><span class="initializer"> = []</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.string.php" class="type string">string</a></span></span> <code class="parameter">$additional_params</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span><br>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   Envía un correo electrónico.
   Los encabezados y el cuerpo del mensaje son convertidos y codificados
   de acuerdo con <span class="function"><a href="function.mb-language.php" class="function">mb_language()</a></span>. <span class="function"><strong>mb_send_mail()</strong></span>
   es una versión adaptada de <span class="function"><a href="function.mail.php" class="function">mail()</a></span>.
   Consulte la función <span class="function"><a href="function.mail.php" class="function">mail()</a></span> para más detalles.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mb-send-mail-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">to</code></dt>
     <dd>
      <p class="para">
       <code class="parameter">to</code> es la dirección de destino del correo. Las
       direcciones múltiples pueden especificarse separándolas con comas. Este parámetro
       no es codificado automáticamente.
      </p>
     </dd>
    
    
     <dt><code class="parameter">subject</code></dt>
     <dd>
      <p class="para">
       El asunto del correo.
      </p>
     </dd>
    
    
     <dt><code class="parameter">message</code></dt>
     <dd>
      <p class="para">
       El mensaje del correo.
      </p>
     </dd>
    
    
     <dt><code class="parameter">additional_headers</code> (opcional)</dt>
     <dd>
      <p class="para">
       <span class="type"><a href="language.types.string.php" class="type string">string</a></span> o <span class="type"><a href="language.types.array.php" class="type array">array</a></span> a insertar al final del encabezado del correo.
      </p>
      <p class="para">
       Este parámetro se utiliza típicamente para añadir encabezados adicionales
       (From, Cc, y Bcc). Los diferentes añadidos deben separarse con un
       CRLF (\r\n). Este parámetro debe ser validado para evitar la inyección
       de encabezados no deseados por personas malintencionadas.
      </p>
      <p class="para">
       Si se proporciona un <span class="type"><a href="language.types.array.php" class="type array">array</a></span>, sus claves son los nombres de los encabezados y sus
       valores son los valores respectivos de los encabezados.
      </p>
      <blockquote class="note"><p><strong class="note">Nota</strong>: 
       <p class="para">
        Al enviar un correo, <em>debe</em> contener
        un encabezado <code class="literal">From</code>. Puede ser definido mediante el
        parámetro <code class="parameter">additional_headers</code> o como valor por defecto en el <var class="filename">php.ini</var>.
       </p>
       <p class="para">
        Si no se hace, se emitirá un error similar a:
        <code class="literal">Warning: mail(): &quot;sendmail_from&quot; not
        set in php.ini or custom &quot;From:&quot; header missing</code>. El encabezado <code class="literal">From</code> también
        define <code class="literal">Return-Path</code> en Windows.
       </p>
      </p></blockquote>
      <blockquote class="note"><p><strong class="note">Nota</strong>: 
       <p class="para">
        Si los mensajes no son recibidos, intente utilizar únicamente un LF
        (\n). Algunos agentes de transferencia de correos Unix (en particular
        <a href="http://cr.yp.to/qmail.html" class="link external">&raquo;&nbsp;qmail</a>) reemplazan un LF por
        un CRLF automáticamente (lo que resulta en un doble CR si se utiliza
        CRLF). Debe intentar esta corrección en último lugar, sabiendo que no
        cumple con la
        <a href="https://datatracker.ietf.org/doc/html/rfc2822" class="link external">&raquo;&nbsp;RFC 2822</a>.
       </p>
      </p></blockquote>
     </dd>
    
    
     <dt><code class="parameter">additional_params</code></dt>
     <dd>
      <p class="para">
       <code class="parameter">additional_params</code> es una línea
       de parámetros MTA. Es práctico cuando se quiere
       definir un <code class="literal">Return-Path</code> correcto cuando
       se utiliza <code class="literal">sendmail</code>.
      </p>
      <p class="para">
       Este parámetro es escapado por la función <span class="function"><a href="function.escapeshellcmd.php" class="function">escapeshellcmd()</a></span> internamente
       para prevenir la ejecución de comandos. La función <span class="function"><a href="function.escapeshellcmd.php" class="function">escapeshellcmd()</a></span>
       previene la ejecución de comandos, pero permite parámetros adicionales. Por razones de seguridad,
       este parámetro debe ser validado.
      </p>
      <p class="para">
       Dado que la función <span class="function"><a href="function.escapeshellcmd.php" class="function">escapeshellcmd()</a></span> se aplica automáticamente internamente,
       algunos caracteres permitidos en las direcciones de correo por los RFCs de Internet
       ya no pueden ser utilizados. Los programas que necesiten utilizar estos caracteres,
       la función <span class="function"><a href="function.mail.php" class="function">mail()</a></span> ya no puede ser utilizada.
      </p>
      <p class="para">
       El usuario que ejecuta el servidor web debe ser añadido como usuario de confianza en la configuración
       de envío de correos para evitar la adición de un encabezado &#039;X-Warning&#039; en el mensaje cuando
       el remitente de la envelope (-f) es definido utilizando este método. Para los usuarios de sendmail,
       este archivo se encuentra utilizando la ruta <var class="filename">/etc/mail/trusted-users</var>.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mb-send-mail-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.mb-send-mail-changelog">
  <h3 class="title">Historial de cambios</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Versión</th>
       <th>Descripción</th>
      </tr>

     </thead>

     <tbody class="tbody">
     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">additional_params</code> ahora es nullable.
      </td>
     </tr>

      <tr>
       <td>7.2.0</td>
       <td>
        El parámetro <code class="parameter">additional_headers</code> ahora acepta
        un <span class="type"><a href="language.types.array.php" class="type array">array</a></span>.
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mb-send-mail-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.mail.php" class="function" rel="rdfs-seeAlso">mail()</a> - Env&iacute;o de correo</span></li>
    <li><span class="function"><a href="function.mb-encode-mimeheader.php" class="function" rel="rdfs-seeAlso">mb_encode_mimeheader()</a> - Codifica una cadena para un encabezado MIME</span></li>
    <li><span class="function"><a href="function.mb-language.php" class="function" rel="rdfs-seeAlso">mb_language()</a> - Define/Recupera el lenguaje actual</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>