mb_send_mail

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

mb_send_mailEnvía un correo codificado

Descripción

mb_send_mail ( string $to , string $subject , string $message [, string $additional_headers = NULL [, string $additional_parameter = NULL ]] ) : bool

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.

Parámetros

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.

subject

El asunto del correo.

message

El 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.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ver también