Integrazione SendGrid in PHP

Anche se è possibile utilizzare la funzione mail() di PHP, talvolta capita che le email vengano recapitate in "spam/posta indesiderata" o peggio vengano preventivamente eliminate dal fornitore delle email.
È possibile però utilizzare un servizio esterno gratuito per l’invio delle email; tramite questo procedimento si elimina anche la scritta inserita a fondo mail da AlterVista "To report abuses or spam…".

In questo breve tutorial spiegherò come utilizzare sendGrid al posto della nativa funzione mail di PHP.

Prima cosa occorre registrarsi su SendGrid e registrare il profilo free. È possibile farlo dal sito ufficiale, quindi selezionare "Try for Free".

Compiliamo quindi i dati:
https://i.imgur.com/RM26VFft.png
https://i.imgur.com/o3pk1Z6t.png

A questo punto verrà inviata una email all’indirizzo inserito precedentemente. Ci sarà un link dove occorre aprirlo per confermare l’account. Se non dovesse esserci, guardate su "spam" o "posta indesiderata". L’email dovrebbe essere una cosa del genere:

https://i.imgur.com/obryMntt.png

Una volta confermata l’email, torniamo nella schermata precedente e scegliamo "Integrate using our Web API or SMTP relay", visto che vogliamo utilizzare le "web API".

https://i.imgur.com/R1dTKsNm.png

Quindi, Web API:
https://i.imgur.com/VihbhTMm.png

Infine PHP:
https://i.imgur.com/LGd6Pj3m.png

A questo punto ci si trova un elenco numerato di 5 passi da seguire. In realtà si può riassumere il tutto dicendo di creare la API Key e incollarla nel codice poco sotto. Quindi scaricare la libreria e caricarla su AlterVista.

Vediamo passo passo:

1. 
   Creazione API KEY:
   Clicchiamo su "API keys page":
   https://i.imgur.com/e58F6vqm.png
   Poi su "Create API Key":
   https://i.imgur.com/pdRHNewm.png
   
   Diamo un nome all’API e clicchiamo su "Create & View":
   https://i.imgur.com/XtgcOyJm.png
   
   NOTA BENE: l’API key non verrà più mostrata in futuro. Quindi occorre copiarla da qualche parte (blocco note) così da poterla utilizzare quando servirà. Cliccando nel codice verrà automaticamente copiata nella clipboard:
   https://i.imgur.com/odK6dO4m.png
   Tornando indietro con il pulsante del browser, si dovrebbe tornare alla pagina precedente.
2. Recuperare la libreria:
   Occorre scaricare la libreria (link qui) dell'ultima versione in formato .zip:
   https://i.imgur.com/CME62g5m.png
   
   La libreria è in formato .zip. Non occorrerà perdere tempo a estrarla perché AlterVista supporta l’upload di archivi compressi: una volta scaricato andiamo nel pannello di controllo (gestione files), quindi selezionare "invia files" -> "invia archivi compressi", quindi selezionare la cartella appena scaricata:
   
   https://i.imgur.com/RUygHcmm.png
   
3. Codice di test:
   Siccome abbiamo utilizzato la libreria, occorre modificare un minimo lo script PHP (come indicato nel commento del sorgente stesso). Quindi modificare i vari campi (email destinatario e api-key salvata precedentemente)
   
   Codice PHP:

   ---

   <?php
//require 'vendor/autoload.php'; // If you're using Composer (recommended)
// Comment out the above line if not using Composer
require("./sendgrid-php/sendgrid-php.php"); # <--- controllare che sia corretto il path con la cartella caricata
// If not using Composer, uncomment the above line and
// download sendgrid-php.zip from the latest release here,
// replacing <PATH TO> with the path to the sendgrid-php.php file,
// which is included in the download:
// https://github.com/sendgrid/sendgrid-php/releases
$email = new \SendGrid\Mail\Mail();
$email->setFrom("test@example.com", "Example User"); # <--- indirizzo mittente
$email->setSubject("Sending with SendGrid is Fun"); # <--- oggetto email
$email->addTo("alemoppospam@altervista.org", "Example User"); # <--- indirizzo destinatario
$email->addContent("text/plain", "and easy to do anywhere, even with PHP"); # <--- testo della email
$email->addContent(
"text/html", "<strong>and easy to do anywhere, even with PHP</strong>"
); # <--- eventuale testo HTML della mail
$sendgrid = new \SendGrid('SG.h44LKtmiSpyxbohQP4g.rP8sp_AMtesto8hOMJBkVCapikeyvR9o1XGZyJB8DWmw'); # <--- api key
try {
$response = $sendgrid->send($email);
print $response->statusCode() . "\n";
print_r($response->headers());
print $response->body() . "\n";
} catch (Exception $e) {
echo 'Caught exception: '. $e->getMessage() ."\n";
}

   ---

Aprendo il file.php creato con il codice sopra (modificato), dovrebbe arrivare l’email all’indirizzo destinatario.

Ciao!