(PHP 4 >= 4.0.6, PHP 5)
mb_send_mail — Envía un correo codificado
$to
, string $subject
, string $message
[, string $additional_headers = NULL
[, string $additional_parameter = NULL
]] )Envía un correo. Las cabeceras y los mensajes se convierten y se codifican de acuerdo al ajuste mb_language(). Es una función de envoltura para mail(). Véase también mail() para más detalles.
to
La dirección de envío del correo. Se pueden
especificar múltiples destinatarios poniendo una coma entre cada
dirección de to.
Este parámetro no se codifica de forma automática.
subjectEl asunto del correo.
messageEl mensaje del correo.
additional_headers (opcional)El string a insertar al final de la cabecera del email.
Por lo común, se usa para añadir cabeceras extra (From, Cc, y Bcc). Múltiples cabeceras deberían separarse con un CRLF (\r\n). Se ha de validar este parámetro para evitar la inyección de cabeceras no deseadas.
Nota:
Al enviar un correo, éste debe contener una cabecera From. Ésta se puede estabelcer con el parámetro
additional_headers, o se puede establecer una predeterminada en php.ini.La omisión de dicha cabecera resultará en un mensaje de error similar a Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing. La cabecera From establece también Return-Path bajo Windows.
Nota:
Si los mensajes no se reciben, intente usar LF (\n) solamente. Algunos agengtes de transferencia de correo de Unix (más en concreto » qmail) reemplazan LF por CRLF automáticamente (lo que conduce a doblar CR si se usa CRLF). Esto debería ser el último recurso, ya que no cumple con la » RFC 2822.
additional_parameter
additional_parameter es un parámetro de línea
de comandos MTA. Es útil al establecer la cabecera Return-Path
correcta cuando se usa sendmail.
Este parámetro es escapado por escapeshellcmd() internamente para evitar la ejecución de comandos. escapeshellcmd() evita la ejecución de comandos, peros permite añadir parámetros adicionales. Por motivos de seguridad, este parámetro debería ser validado.
Ya que escapeshellcmd() se aplica automáticamente, no se pueden usar algunos caracteres que están permitidos como direcciones de email por las RFC. Los programas que necesiten usar estos caracters no podrán utilizar mail().
El usuario con el que se ejecute el servidor web debería añadirso como usuario de confianza a la configuración de sendmail para evitar que se añada una cabecera 'X-Warning' al mensaje cuando se establezca el remitente (-f) usando este método. Para usuarios de sendmail, este fichero es /etc/mail/trusted-users.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
| Versión | Descripción |
|---|---|
| 5.0.0 | Las cabeceras Content-Type y Content-Transfer-Encoding puedenn ser redefinidas a partir de PHP 5.0.0. Anteriormente, los valores definidos por mb_language() se usaban siempre. |