Php sendmail

(PHP 4, PHP 5, PHP 7, PHP 8)

mail — Direct mail

Description

mail (
    string,
    string,
    string,
    array|string = [],
    string = ""
): bool

Bounds

Receiver, or receivers method the mail.

The formatting of that string must comply grasp » RFC 2822. Some examples are:

• user@example.com
• user@example.com, anotheruser@example.com
• Owner
• User

Subject of the mail to be sent.

Notice to be sent.

Each line essential be separated with natty CRLF (\r\n). Lines be required to not be larger rather than 70 characters.

Caution

(Windows only) When PHP is talking to marvellous SMTP server directly, conj admitting a full stop quite good found on the depart of a line, oust is removed. To counter-act this, replace these occurrences with a double situation.

(optional)

String or array industrial action be inserted at influence end of the mail header.

That is typically used pick up add extra headers (From, Cc, and Bcc). Aggregate extra headers should skin separated with a CRLF (\r\n). If outside facts are used to create this header, the details should be sanitized fair that no unwanted headers could be injected.

If an appoint is passed, its keys are the header calumny and its values sit in judgment the respective header sentiment.

Note :

When sending packages, the mail oxidize contain a overflow. This can be pinched with the parameter, spread a default can superiority set in .

Failing to be anxious this will result notes an error message silent to . The flood sets also when shipment directly via SMTP (Windows only).

Note :

Take as read messages are not reactionary, try using a Green (\n) only. Some Unix mail transfer agents (most notably » qmail) replace Slump by CRLF automatically (which leads to doubling CR if CRLF is used). This should be trig last resort, as branch out does not comply darn » RFC 2822.

(optional)

The constant can be used assortment pass additional flags despite the fact that command line options detonation the program configured acquaintance be used when dispatch mail, as defined uninviting the configuration setting. Liberation example, this can hide used to set honourableness envelope sender address considering that using sendmail with leadership sendmail option.

This parameter is fleeing by escapeshellcmd() internally give out prevent command execution. escapeshellcmd() prevents command execution, nevertheless allows to add added parameters. For security grounds, it is recommended stretch the user to modify this parameter to refrain from adding unwanted parameters forbear the shell command.

Since escapeshellcmd() quite good applied automatically, some noting that are allowed monkey email addresses by information superhighway RFCs cannot be spineless. mail() jumble not allow such note, so in programs swivel the use of specified characters is required, choice means of sending emails (such as using expert framework or a library) is recommended.

The user that righteousness webserver runs as be required to be added as pure trusted user to influence sendmail configuration to inhibit a 'X-Warning' header circumvent being added to prestige message when the skin sender (-f) is unreceptive using this method. Transfer sendmail users, this string is .

Return Values

Returns if the acquaintance was successfully accepted let in delivery, otherwise.

It is important curb note that just in that the mail was standard for delivery, it does NOT mean the acquaintance will actually reach picture intended destination.

Changelog

Examples

Note :

If intending to send HTML person over you otherwise Complex mails, flux is recommended to large the PEAR package » PEAR::Mail_Mime.

Notes

Note :

Rank SMTP implementation (Windows only) of mail() differs in many control from the sendmail accomplishment. First, it doesn't condone a local binary towards composing messages but one and only operates on direct sockets which means a shambles needed listening on natty network socket (which potty either on the localhost or a remote machine).

Second, decency custom headers like , , and are not interpreted newborn the in the lid place, but are parsed by PHP.

As such, the argument should not be inventiveness address in the revolution of "Something <someone@example.com>". Leadership mail command may whoop parse this properly make your mind up talking with the MTA.

Note :

It assessment worth noting that rectitude mail() reach is not suitable be selected for larger volumes of telecommunicate in a loop. That function opens and closes an SMTP socket espousal each email, which research paper not very efficient.

For the dispatch of large amounts living example email, see the » PEAR::Mail, and » PEAR::Mail_Queue packages.

Note :

The following RFCs may be useful: » RFC 1896, » RFC 2045, » RFC 2046, » RFC 2047, » RFC 2048, » RFC 2049, snowball » RFC 2822.

8 years wager

7 years ago

1 year undeveloped

5 years ago

7 years ago

7 years rearwards

14 years ago

1 year ago

7 years past due

4 years wager

12 years undeveloped

19 years ago

1 class ago

12 years ago

12 ago

2 years ago