Invio di email usando Zend_Mail

Questo articolo illustra come utilizzare lo Zend Framework per realizzare un form di invio email, utile ad esempio agli utenti per contattare l'amministratore del sito oppure per segnalare una pagina del sito ad amici. Zend Framework fornisce tutti gli oggetti necessari allo scopo, oggetti che possono essere usati singolarmente, al di fuori di una applicazione MVC.
L'uso di un framework non deve spaventare coloro che non si sentono degli esperti nella programmazione in PHP. Al contrario l'utilizzo degli oggetti forniti dal framework semplifica e velocizza la realizzazione dello script.

Iniziamo con la creazione del form in HTML che permetterà di inviare i dati inseriti dall'utente tramite $_POST allo script send.php:

<form method="post" action="send.php" name="form">
<table border="0px">
<tr>
 <td style="text-align: right">
   Tuo Nome:
 </td>
 <td>
   <input type="text" name="name" size="40" maxlength="80" />
 </td>
</tr>
<tr>
 <td style="text-align: right">
   Tua Email:
 </td>
 <td>
   <input type="text" name="email" size="40" />
 </td>
</tr>
<tr>
 <td style="text-align: right">
   Oggetto:
 </td>
 <td>
   <input type="text" name="subject" size="40" maxlength="80" />
 </td>
</tr>
<tr>
 <td style="text-align: right">
   Testo:
 </td>
 <td>
   <textarea name="testo" cols="60" rows="10"></textarea>
 </td>
</tr>
<tr>
 <td>
 </td>
 <td style="text-align: right">
   <input type="submit" value="Invia" />
 </td>
</tr>
</table>
</form>

Proseguiamo con la creazione dello script send.php. Per prima cosa è bene fare un controllo sull'array $_POST. Se questo è vuoto è inutile proseguire poiché significa che l'utente non ha inviato il form, mostriamo quindi un messaggio di errore.

Il passaggio successivo sarà richiamare l'oggetto Zend_Loader_Autoloader. Questa classe permette di caricare in automatico i vari oggetti del framework senza la necessità di dover includere i singoli script del framework contenenti le classi che ci interessano.

Fatto ciò possiamo istanziare un oggetto Zend_Mail (referenziato dalla variabile $mail nello script) e comporre così l'email.

La composizione di una email a partire dai campi del form creato precedentemente è davvero semplice ed intuitiva e uno sguardo allo script send.php lo dimostra chiaramente.

Fatto ciò si deve spedire la posta. Prima però è necessario indicare a Zend_Mail con quale "trasporter" inviare la propria email, ovvero quale sistema di invio impiegare. Di default l'invio di una email avviene tramite Zend_Mail_Transport_Sendmail. Questo transporter utilizza il server sendmail impostato nella configurazione del php. Dunque per inviare l'email basterebbe utilizzare il metodo send di Zend_Mail e l'email viene inviata.
Supponiamo però di voler utilizzare un server SMTP. Per farlo ci viene in aiuto un oggetto molto interessante: Zend_Mail_Transport_Smtp. Nello script send.php si può vedere come si impostano i parametri di connessione al server SMTP.
Infine, tramite il metodo send di Zend_Mail si invia l'email indicando il "transporter" creato:

<?php
    // includo la cartella del framework
    // Attenzione, il path impostato è per server windows, se si è su un server linux il path dovrebbe essere del tipo: /directory/zendframework/library
    set_include_path(get_include_path().PATH_SEPARATOR."C:\Programmi\ZendFramework\library");
    
    /**
     * Se il form è stato riempito procedo con l'invio della email  
     */
    if($_POST){

	/**
	 * Richiamo il file contenente la mia classe Zend_Loader_Autoloader
	 *
	 * in questo modo posso caricare facilmente tutte le classi di
	 * Zend Framework agevolmente senza dover ogni volta fare un require
	 * come sto facendo ora
	 */
	require_once("Zend/Loader/Autoloader.php");
	
	$autoloader = Zend_Loader_Autoloader::getInstance();
	
	/**
	 * Istanzio il mio oggetto Zend_Mail
	 */
	$mail = new Zend_Mail();

	/**
	 *  Compongo la mia email 
	 *  impostando le varie parti dell'email
	 */
	$mail->addTo('mario@example.com', 'Mario Santagiuliana');
	
	$mail->setFrom($_POST['email'], $_POST['name']);
	$mail->setSubject($_POST['subject']);
	$mail->setBodyText($_POST['testo']);

	/**
	 *  Voglio usare il mio server smtp, imposto i
	 *  parametri di configurazione per la connessione smtp 
	 */
	$config = array('auth' => 'login',
		'username' => 'mario@example.com',
		'password' => 'la_mia_password',
		'port' => 25);
	/**
	 *  Istanzio l'oggetto Zend_Mail_Transport_Smtp indicandogli i
	 *  parametri di connessione e di accesso
	 */
	$transport = new Zend_Mail_Transport_Smtp('smtp.example.com', $config);
	
	/**
	 * Invio l'email tramite il mio server smtp appena configurato
	 * e stampo un messaggio di corretta esecuzione dello script
	 */
	$mail->send($transport);
	$messaggio = "Email inviata correttamente";
    } else {
	/**
	 * Imposto un messaggio generico di errore
	 */
	$messaggio = "Non hai riempito il form per il messaggio";
    }

    // Stampo il messaggio
    echo $messaggio;
?>

Come si può vedere la creazione dello script, utilizzando le classi di Zend è oltremodo semplice e veloce.