9. SESION: ENVIO DE EMAIL

mail()

mail — Enviar correo

Descripción

bool mail ( string $to , string $subject , string $message [, string $additional_headers [, string $additional_parameters ]] )

Envía un email.

Parámetros

to

Receptor o receptores del correo.

Es formato de este string debe cumplir con » RFC 2822. Algunos ejemplos son:

• usuario@example.com
• usuario@example.com, otrousuario@example.com
• Usuario <usuario@example.com>
• Usuario <usuario@example.com>, Otro usuario <otrousuario@example.com>

subject

Título del mail a ser enviado.

Precaución

El título debe satisfacer » RFC 2047.

message

Mensaje a enviar.

Cada línea debería ser separada por un LF (\n). Las líneas no deberían ser más largas de 70 caracteres.

Precaución

(Sólo en Windows) Cuando PHP habla directamente con un servidor SMTP, si se encuentra un punto al principio de la línea, se elimina. Para evitar esto, es necesario reemplazar estos casos con un doble punto.

<?php
$text = str_replace("\n.", "\n..", $text);?>

additional_headers (opcional)

String a ser insertado al final de la cabecera del email.

Se usa típicamente para añadir cabeceras extra (From, Cc y Bcc). En caso de tener múltiples cabeceras adicionales, deben ser separadas con un CRLF(\r\n).

Nota:

Cuando se envía un correo, el correo debe contener una cabecera From. Puede establecerse con el parámetro additional_headers, o puede definirse un valor por defecto en php.ini.

Si no se realiza esta acción se obtendrá un mensaje de error similar a Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing. La cabecera From también establece Return-Path bajo Windows.

Nota:

Si no se reciben los mensajes enviados, intentar el uso de sólo LF (\n). Algunos agentes de transferencia de correo de baja calidad en Unix reemplzan LF por CRLF automáticamente (lo que conlleva doblar CR si se usa CRLF). Esto debería ser el último recurso, si bien no cumple con » RFC 2822.

additional_parameters (opcional)

El parámetro additional_parameters puede usarse para indicar opciones adicionales como opciones de línea de comando al programa configurado para ser usado cuando se envía correo, definido por la opción de configuración sendmail_path. Por ejemplo, puede usarse para establecer la dirección de correo de remitente usado por sendmail con la opción -f.

El usuario usado por el servidor web debe ser añadido como usuario de confianza en la configuración de sendmail para evitar que se añada la cabecera 'X-Warning' al mensaje cuando se añade la dirección de remitente (-f) usando este método. Para los usuarios de sendmail, este fichero es /etc/mail/trusted-users.

Valores devueltos

Retorna TRUE si el correo ha sido aceptado con éxito para reparto, o FALSE en otro caso.

Es importante tener en cuenta que si el correo es aceptado para reparto, NO quiere decir que el correo haya alcanzado el destino indicado.

Historial de cambios

Versión	Descripción
4.3.0 (sólo Windows)	Se aceptan todas las cabeceras personalizadas (como From, Cc, Bcc y Date) y no distinguen entre mayúsculas y minúsculas. (Como las cabeceras personaliazadas no son interpretadas por el MTA en primer lugar pero son analizadas por PHP, PHP < 4.3 sólo soportaba el elemento de cabecera Cc y distinguía entre mayúsculas y minúsculas).
4.2.3	El parámetro additional_parameters es deshabilitado en safe_mode y la función mail() mostrará un mensaje de aviso, retornando FALSE cuando se usa.
4.0.5	Se añade el parámetro additional_parameters.

Ejemplos

Ejemplo #1 Enviar correo

Usando mail() para enviar un correo simple:

<?php// El mensaje$mensaje = "Línea 1\nLínea 2\nLínea 3";// En caso de que cualquiera de las líneas sea más larga de 70 caracteres,
// debe usarse wordwrap()$mensaje = wordwrap($mensaje, 70);// Sendmail('caffeinated@example.com', 'Mi título', $mensaje);?>

Ejemplo #2 Enviar un correo con cabeceras extra.

Adición de cabeceras básicas, diciendo al MUA las direcciones From y Reply-To:

<?php
$para      = 'nobody@example.com';$titulo = 'El título';$mensaje = 'Hola';$cabeceras = 'From: webmaster@example.com' . "\r\n" .
    'Reply-To: webmaster@example.com' . "\r\n" .
    'X-Mailer: PHP/' . phpversion();mail($para, $titulo, $mensaje, $cabeceras);?>

Ejemplo #3 Enviar un correo con parámetros de línea de comando adicionales.

El parámetro additional_parameters puede ser usado para indicar parámetros adicicionales al programa configurado para usar en el envío de correo configurado en sendmail_path.

<?php
mail('nadie@example.com', 'El título', 'El mensaje', null, '-fwebmaster@example.com');?>

Ejemplo #4 Envío de un correo HTML

Es posible también enviar correos HTML con mail().

<?php// Varios destinatarios$para  = 'aidan@example.com' . ', '; // atención a la coma$para .= 'wez@example.com';// subject$titulo = 'Recordatorio de cumpleaños para Agosto';// message$mensaje = '
<html>
<head>
  <title>Recordatorio de cumpleaños para Agosto</title>
</head>
<body>
  <p>¡Estos son los cumpleaños para Agosto!</p>
  <table>
    <tr>
      <th>Quien</th><th>Día</th><th>Mes</th><th>Año</th>
    </tr>
    <tr>
      <td>Joe</td><td>3</td><td>Agosto</td><td>1970</td>
    </tr>
    <tr>
      <td>Sally</td><td>17</td><td>Agosto</td><td>1973</td>
    </tr>
  </table>
</body>
</html>
';// Para enviar un correo HTML mail, la cabecera Content-type debe fijarse$cabeceras  = 'MIME-Version: 1.0' . "\r\n";$cabeceras .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n";// Cabeceras adicionales$cabeceras .= 'To: Mary <mary@example.com>, Kelly <kelly@example.com>' . "\r\n";$cabeceras .= 'From: Recordatorio <cumples@example.com>' . "\r\n";$cabeceras .= 'Cc: birthdayarchive@example.com' . "\r\n";$cabeceras .= 'Bcc: birthdaycheck@example.com' . "\r\n";// Mail itmail($para, $titulo, $mensaje, $cabeceras);?>

Nota:

Si la intención es enviar HTML u otro tipo de correos complejos, es recomendable usar el paquete PEAR » PEAR::Mail_Mime.

Notas

Nota:

La implementación Windows de mail() difiere en muchas formas de la implementación Unix. Primero, no usa un ejecutable local para componer mensajes ya que sólo opera en sockets directos, lo que significa que se necesita un MTA escuchando en un un socket de red (que puede estar tanto en localhost como en una máquina remota).

Segundo, las cabeceras personalizadas como From:, Cc:, Bcc: y Date: no son interpretadas por el MTA en primer lugar, pero son analizadas por PHP.

Por esto, el parámetro to no debería ser una dirección de correo de la forma "Algo <alguien@example.com>". Es posible que el comando mail no analice esto correctamente cuando dialoga con el MTA.

Nota:

Es importante indicar que la función mail() no es conveniente para grandes volúmenes de correo en bucle. Esta función abre y cierra un socket SMTP para cada correo, algo que no es muy eficiente.

Para enviar una gran cantidad de correo, ver los paquetes » PEAR::Mail y » PEAR::Mail_Queue. 

error_log

error_log — Enviar un mensaje de error a algún lugar

Descripción

bool error_log ( string $message [, int $message_type = 0 [, string $destination [, string $extra_headers ]]] )

Envía un mensaje de error al registro de errores del servidor web o a un archivo.

Parámetros

message

El mensaje de error que debería ser registrado.

message_type

Indica dónde debería ir el error. Lo tipos de mensaje posibles son:

Tipos de registro de error_log()

0	message es enviado al registro del sistema de PHP, usando el mecanismo de registro del Sistema Operativo o un archivo, dependiendo de qué directiva de configuración esté establecida en error_log. Esta es la opción predeterminada.
1	message es enviado por email a la dirección del parámetro destination. Este es el único tipo de mensaje donde se usa el cuarto parámetro extra_headers.
2	Ya no es una opción.
3	message es añadido al inicio del archivo destination. No se añade automáticamente una nueva línea al final de la cadena message.
4	message es enviado directamente al gestor de registro de SAPI.

destination

El destino. Su significado depende del parámetro message_type tal como se describió arriba.

extra_headers

Las cabeceras extra. Se usa cuando el parámetro message_type está establecido a 1. Este tipo de mensaje usa la misma función interna que mail().

Valores devueltos

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

Historial de cambios

Versión	Descripción
5.2.7	El valor posible de 4 se añadió a message_type.

Ejemplos

Ejemplo #1 Ejemplos de error_log()
<?php// Enviar una notificación al registro del servidor si no podemos
// conectarnos a la base de datos.if (!Ora_Logon($username, $password)) {
    error_log("¡Base de datos Oracle no disponible!", 0);
}// Notificar al administrador mediante un email si agotamos FOOif (!($foo = allocate_new_foo())) {
    error_log("Problema serio, nos hemos quedado sin FOOs!", 1,
               "operator@example.com");
}// otra manera de llamar a error_log():error_log("¡Lo echaste a perder!", 3, "/var/tmp/my-errors.log");

Mail_Mime						proporciona clases para crear mensajes MIME.	Estilo BSD
»Versión actual	»Resumen de errores
1.8.3 (estable) fue lanzado el 12/03/2012 ( de cambios ) Easy Install ¿No está seguro? Obtenga más información . pear install Mail_Mime Pyrus instalación Trate de PEAR2 instalador @ s, Pyrus. php pyrus.phar instalación de pera / Mail_Mime Mapa de desarrollo de	Paquete Rango de Mantenimiento: 34 de 191 paquetes con bugs abiertos Número de bugs abiertos : 1 (180 errores en total) El promedio de edad de los bugs abiertos: 239 días El más antiguo fallo abierta: 239 días Número de abiertas las solicitudes de funciones : 4 (32 peticiones de nuevas funcionalidades en total) Notificar un error nuevo Mail_Mime
»Descripción
Mail_Mime ofrece clases para hacer frente a la creación y manipulación de los mensajes MIME. Permite a las personas para crear mensajes de correo electrónico que consiste en: * Piezas de texto * HTML piezas * HTML en línea Imágenes * Adjuntos * Los mensajes adjuntos Soporta mensajes grandes, base64 y codificaciones quoted-printable y caracteres no ASCII en nombres de archivos, temas, destinatarios, etc codificada utilizando RFC2047 y / o RFC2231.