mb_send_mail

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

mb_send_mailEnvía un correo electrónico codificado

Descripción

mb_send_mail(
    string $to,
    string $subject,
    string $message,
    array|string $additional_headers = [],
    ?string $additional_params = null
): bool

Envía un correo electrónico. Los encabezados y el cuerpo del mensaje son convertidos y codificados de acuerdo con mb_language(). mb_send_mail() es una versión adaptada de mail(). Consulte la función mail() para más detalles.

Parámetros

to

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

subject

El asunto del correo.

message

El mensaje del correo.

additional_headers (opcional)

chaîne de caractères o tableau a insertar al final del encabezado del correo.

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.

Si se proporciona un tableau, sus claves son los nombres de los encabezados y sus valores son los valores respectivos de los encabezados.

Nota:

Al enviar un correo, debe contener un encabezado From. Puede ser definido mediante el parámetro additional_headers o como valor por defecto en el php.ini.

Si no se hace, se emitirá un error similar a: Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing. El encabezado From también define Return-Path en Windows.

Nota:

Si los mensajes no son recibidos, intente utilizar únicamente un LF (\n). Algunos agentes de transferencia de correos Unix (en particular » qmail) 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 » RFC 2822.

additional_params

additional_params es una línea de parámetros MTA. Es práctico cuando se quiere definir un Return-Path correcto cuando se utiliza sendmail.

Este parámetro es escapado por la función escapeshellcmd() internamente para prevenir la ejecución de comandos. La función escapeshellcmd() previene la ejecución de comandos, pero permite parámetros adicionales. Por razones de seguridad, este parámetro debe ser validado.

Dado que la función escapeshellcmd() 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 mail() ya no puede ser utilizada.

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 'X-Warning' 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 /etc/mail/trusted-users.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 additional_params ahora es nullable.
7.2.0 El parámetro additional_headers ahora acepta un tableau.

Ver también