LXXVI. Funzioni di Mail
Introduzione
La funzione mail() permette di inviare messaggi di posta elettronica.
Requisiti
Per avere disponibili le funzioni Mail, il PHP deve potere accedere all'eseguibile sendmail del sistema durante la compila. Qualora si utilizzi un'altro programma di posta, tipo qmail o postfix, occorre utlizzare il wrapper sendmail allegato al programma di posta. Il PHP cercherà sendmail in PATH e quindi in: /usr/bin:/usr/sbin:/usr/etc:/etc:/usr/ucblib:/usr/lib. Si consiglia vivamente di avere sendmail in PATH. Inoltre, l'utente che compila PHP deve avere i diritti di accesso all'eseguibile di sendmail.
Installazione
Non è necessaria nessuna installazione per usare queste funzioni, esse fanno parte del core di PHP.
Configurazione di Runtime
Il comportamento di queste funzioni è influenzato dalle impostazioni di php.ini.
Tabella 1. Opzioni di configurazione Mail
| Nome | Predefinito | Modificabile in |
|---|---|---|
| SMTP | "localhost" | PHP_INI_ALL |
| smtp_port | "25" | PHP_INI_ALL |
| sendmail_from | NULL | PHP_INI_ALL |
| sendmail_path | DEFAULT_SENDMAIL_PATH | PHP_INI_SYSTEM |
Breve descrizione dei parametri di configurazione.
- SMTP string
Usato solo sotto Windows: Nome DNS o indirizzo IP del server SMTP che PHP deve usare per spedire posta elettronica con la funzione mail().
- smtp_port int
Usato solo sotto Windows: Numero della porta del server specificato da SMTP al quale connettersi quando si inviano email usando mail(); il valore predefinito è 25. Disponibile solo a partire da PHP 4.3.0.
- sendmail_from string
Quale campo "From:" devono avere i messaggi inviati da PHP sotto Windows.
- sendmail_path string
Dove trovare il programma sendmail, solitamente /usr/sbin/sendmail oppure /usr/lib/sendmail. configure cerca di trovare il file e lo imposta di default, ma se non riesce a localizzarlo, lo si può impostare qui.
I sistemi che non usano sendmail devono impostare questa direttiva al wrapper che i rispettivi sistemi di posta offrono, se esistenti. Per esempio, gli utenti di Qmail possono normalmente impostarla a /var/qmail/bin/sendmail o /var/qmail/bin/qmail-inject.
qmail-inject non necessita di nessuna opzione al fine di processare correttamente la mail.
Questi parametri funzionano anche su Windows. Se si impostate smtp, smtp_port e sendmail_from saranno ignorate e verrà eseguito il comando indicato.
Tipi di risorse
Questa estensione non definisce alcun tipo di risorsa.
Costanti predefinite
Questa estensione non definisce alcuna costante.
- Sommario
- ezmlm_hash -- Calcola il valore hash che occorre a EZMLM
- mail -- Invio mail