 |
|
 PhpDig.net |
What is PhpDig?
PhpDig is a PHP MySQL based Web Spider & Search Engine. |
Synopsis
bool mail(recipient, subject, message[, extra_headers][, extra_arguments]);
string recipient: Address of
the recipient
string subject: Message
subject
string message: Body of the
message
string extra_headers
(optional): Extra headers for the message
string extra_arguments
(optional): Extra arguments for the underlying mail
program (PHP 4.0.5 and later)
Description
mail() allows you to send email directly from a PHP script. recipient can be either a single email address or a comma-delimited list of addresses. If you want to set extra headers - for instance, in order to use Cc: or Bcc: - these may be placed in a newline-delimited string in the extra_headers parameter. As of PHP 4.0.5, you can also specify extra arguments to the system mail program in the extra_arguments parameter. For example, this is useful if you want to set the envelope From: header so that it doesn't look like email is coming from your web server daemon. If you do this, however, you may want to add your daemon process to the trusted users list in your sendmail configuration (if using sendmail); otherwise, sendmail will add an X-Authentication-Warning: header to the email, indicating that an untrusted user has modified the envelope.
Because you can modify the headers, it's possible to send attachments or HTML emails using PHP; however, detailing this usage is beyond the scope of this book. There are classes available on the web that will do this for you; check out the code gallery at Zend.com to start with, and be sure to thoroughly read RFC 2049.
TRUE is returned if the function completes successfully; otherwise, FALSE is returned. However, this gives no indication as to whether the email ever reached its destination. This function fails if any of recipient , subject , or message is left out, or if the system's mail program fails for some reason.
Example
Example 659. Send email from a PHP script
/* When the following code was executed, I received this email: * * From: Apache httpd <www@pinc.com> * To: torben@php.net * Subject: This is a test * Date: Mon, 20 Aug 2001 16:33:17 -0700 * * Hi there, * * This is a test message. Please disregard. */ $address = 'torben@php.net'; $subject = 'This is a test'; $message = 'Hi there, This is a test message. Please disregard. '; mail($address, $subject, $message); /* Now, tell it that I want it to look like it's from me, using * the extra_arguments parameter. * The email I got back from this one was as follows. However, * because this was run on a web page and the httpd is not a * sendmail-trusted user, the resulting email also included this * header: * X-Authentication-Warning: shanna.outlander.ca: www set sender to torben@php.net using -f * * From: torben@php.net * To: torben@php.net * Subject: This is a test * Date: Mon, 20 Aug 2001 16:47:56 -0700 * * * Hi there, * * This is a test message. Please disregard. * */ mail($address, $subject, $message, '', '-ftorben@php.net'); /* Send the same message, but to a blind carbon-copy list. */ mail($address, $subject, $message, 'Bcc: foo@bar.baz, kilgore.trout@hiho.com');