Função PHP mail()
Exemplo
Envie um e-mail simples:
<?php
// the message
$msg = "First line of text\nSecond line of text";
// use wordwrap() if lines are longer than 70 characters
$msg = wordwrap($msg,70);
// send email
mail("[email protected]","My subject",$msg);
?>
Definição e uso
A função mail() permite enviar emails diretamente de um script.
Sintaxe
mail(to,subject,message,headers,parameters);
Valores de parâmetro
| Parameter | Description |
|---|---|
| to | Required. Specifies the receiver / receivers of the email |
| subject | Required. Specifies the subject of the email. Note: This parameter cannot contain any newline characters |
| message | Required. Defines the message to be sent. Each line should be separated with a LF (\n).
Lines should not exceed 70 characters.
Windows note: If a full stop is found on the beginning of a line in the message, it might be removed. To solve this problem, replace the full stop with a double dot: |
| headers | Optional. Specifies additional headers, like From, Cc, and Bcc. The additional headers should be separated with a CRLF (\r\n).
Note: When sending an email, it must contain a From header. This can be set with this parameter or in the php.ini file. |
| parameters | Optional. Specifies an additional parameter to the sendmail program (the one defined in the sendmail_path configuration setting). (i.e. this can be used to set the envelope sender address when using sendmail with the -f sendmail option) |
Detalhes técnicos
| Valor de retorno: | Retorna o valor de hash do parâmetro de endereço ou FALSE em caso de falha. Nota: Tenha em mente que mesmo que o e-mail tenha sido aceito para entrega, isso NÃO significa que o e-mail foi realmente enviado e recebido! |
|---|---|
| Versão do PHP: | 4+ |
| Registro de alterações do PHP: | PHP 7.2: O parâmetro headers também aceita um array PHP 5.4: Adicionada proteção de injeção de cabeçalho para o parâmetro headers . PHP 4.3.0: (somente Windows) Todos os cabeçalhos personalizados (como From, Cc, Bcc e Date) são suportados e não diferenciam maiúsculas de minúsculas. PHP 4.2.3: O parâmetro parâmetro está desabilitado no modo de segurança PHP 4.0.5: O parâmetro parâmetro foi adicionado |
Mais exemplos
Envie um e-mail com cabeçalhos extras:
<?php
$to = "[email protected]";
$subject = "My subject";
$txt = "Hello world!";
$headers = "From: [email protected]" . "\r\n" .
"CC: [email protected]";
mail($to,$subject,$txt,$headers);
?>
Envie um e-mail HTML:
<?php
$to = "[email protected], [email protected]";
$subject = "HTML email";
$message = "
<html>
<head>
<title>HTML email</title>
</head>
<body>
<p>This email contains HTML Tags!</p>
<table>
<tr>
<th>Firstname</th>
<th>Lastname</th>
</tr>
<tr>
<td>John</td>
<td>Doe</td>
</tr>
</table>
</body>
</html>
";
// Always set content-type when sending HTML email
$headers = "MIME-Version: 1.0" . "\r\n";
$headers .= "Content-type:text/html;charset=UTF-8" . "\r\n";
// More headers
$headers .= 'From: <[email protected]>' . "\r\n";
$headers .= 'Cc: [email protected]' . "\r\n";
mail($to,$subject,$message,$headers);
?>
❮ Referência completa do PHP Mail