L’envoid’un formulaire parcourriel

L’envoi d’unformulairepar courriel

Configuration requise ........................................................................................................ 236Mail Texte ............................................................................................................................. 237Mail HTML ........................................................................................................................... 242Check-list ............................................................................................................................. 248

L’envoi par courriel d’informations en provenance d’un formulaire estcertainement l’utilisation la plus répandue de PHP. Vous verrez dans cechapitre que PHP vous facilite largement la tâche pour les envois lesplus simples. Vous constaterez en revanche que les courriels mis enforme (HTML) nécessitent davantage de connaissances, notamment ence qui concerne le standard MIME.

9.1. Configuration requiseAlors que l’envoi de courriel ne nécessite aucune configurationparticulière si vos scripts sont exécutés chez un hébergeur, il en va toutautrement s’ils sont placés sur votre machine. Arrêtons-nous un instantsur les adaptations à apporter à votre environnement de travail pour lerendre compatible avec l’envoi de courriels.

Hébergements gratuits

Certains hébergeurs gratuits interdisent l’usage de la commandemail() afin d’éviter les abus de type spam. N’hésitez donc pas, avantde choisir un hébergeur, à vous renseigner sur l’étendue des limitationsau niveau des fonctionnalités du langage.

Si votre version de WampServer n’est pas suffisamment récente, vouspourrez découvrir, en parcourant le fichier php.ini, la section suivante :

Listing 9-1 : section consacrée à l’envoi de courriels dans le fichier php.ini[mail function]; For Win32 only.SMTP = localhost

; For Win32 only.;sendmail_from = [email protected]

La ligne SMTP = localhost indique que PHP est paramétré pourutiliser votre propre machine (localhost) pour l’envoi des courriels. Ils’agit là de la directive de configuration par défaut qui est loin deconvenir.

Le serveur que vous devez utiliser est celui qui est proposé par votrefournisseur d’accès. Il s’agit du serveur SMTP par lequel vous passezégalement dans votre gestionnaire de courriels (par exemple, OutlookExpress, Thunderbird, etc.). Chez Free, le serveur SMTP a pour adresse

236 LE GUIDE COMPLET

L’envoi d’un formulaire par courrielChapitre 9

smtp.free.fr. Cette norme est à peu près respectée par l’ensemble des FAI(fournisseurs d’accès à Internet). Nous pouvons citer à titre d’exemple :smtp.wanadoo.fr, smtp.noos.fr, smtp.club-internet.fr, etc.

Intéressons-nous maintenant à la ligne ;sendmail_from [email protected]. Le point-virgule initial signifie qu’elle estcommentée et qu’elle n’est donc pas prise en compte. Cette directivepermet de préciser l’origine des courriels envoyés depuis votre machine.Cette directive est importante dans la mesure où les serveurs de courriels« relais » refuseront de faire suivre votre message si son origine n’estpas précisée. Veillez donc à supprimer le point-virgule et à renseignervotre adresse e-mail.

Une fois ces directives de configuration modifiées, le serveur Apachedoit être redémarré.

Accès restreints

Les FAI n’autorisent que leurs clients à utiliser leur serveur SMTP. Unclient Wanadoo ne pourra en aucun cas passer par smtp.free.fr. Cettesituation peut se révéler pénible si vous travaillez sur un portable et quele fournisseur d’accès change d’un lieu à un autre. Une solution consisteà passer par un serveur SMTP gratuit qui vous autorisera à transmettredes courriels quelle que soit votre connexion à Internet. Google proposedésormais ce service à l’ensemble de ses clients Gmail (www.gmail.com).

9.2. Mail TexteComme vous l’avez vu en introduction, l’envoi de courriels en PHP estsimple. Il suffit d’utiliser la fonction mail().

Les arguments de cette fonction sont :

j l’adresse de destination ;j le titre du message ;j le contenu du message ;j d’éventuelles options.

La fonction mail() est généralement appelée de la manière suivante :mail($destinataire,$titre,$message);

Mail Texte Chapitre 9

237LE GUIDE COMPLET

j $email est l’e-mail de la personne qui va recevoir le courriel, parexemple $destinataire = "[email protected]";.

j $titre est le titre de l’e-mail, par exemple $titre ="réponse au formulaire";.

j $message est le corps du message qui va contenir toutes lesinformations.

La fonction mail() retourne un booléen qui indique si l’envoi s’estbien déroulé. Ce statut ne concerne que l’envoi, il n’indique en aucuncas le fait que le courriel est bien arrivé dans la boîte du destinataire.

Commencez par construire ce message :

Listing 9-2 : Construction du contenu du courriel$message = "";$message .= "Titre : ".$_REQUEST[’titre’]."\n";$str_genre = join(’,’,$_REQUEST[’genre’]);$message .= "Genre : ".$str_genre."\n");$message .= "Description : ".$_REQUEST[’description’]."\n");$message .= "Couleur : ".$_REQUEST[’couleur’]."\n");$message .= "Pays : ".$_REQUEST[’pays’]."\n");$str_soustitre = join(’,’,$_REQUEST[’soustitre’]);$message .= "Sous titres : ".$str_soustitre."\n";

La première ligne initialise la variable (=), les suivantes ajoutent desinformations à la fin de la variable (.=).

Vous remarquez l’usage systématique du caractère \n à la fin de chaqueligne. Il s’agit du caractère représentant un saut de ligne.

Jusqu’à maintenant, vous utilisiez la balise pour effectuer dessauts de ligne car les informations générées par vos scripts s’affichaientdans un navigateur web. Or, en HTML, un saut de ligne est représentépar la balise .

Dans le cas présent, c’est un lecteur de courriels (de type Thunderbirdou Outlook) qui va afficher l’information. Cette fois, les données sontconsidérées comme du texte brut. Le caractère de saut de ligne est alorsreprésenté par un \n (ou \r\n sous Windows). Il existe d’autrescaractères spéciaux qui peuvent être utilisés dans du texte brut, parexemple le \t qui correspond à une tabulation.



Votre script prend finalement la forme suivante :<?php

function verif(){

$erreur = "";

if (strlen($_REQUEST[’titre’])<=2)$erreur .= "- le champ titre est mal rempli ";

if( strlen($_REQUEST[’description’])<=10 ||strlen($_REQUEST[’description’])>=500)$erreur .= "- le champ description est mal rempli ";

if ($_REQUEST[’annee’]<1930 || $_REQUEST[’annee’]>2006)$erreur .= "- le champ année est mal rempli ";

if ($_REQUEST[’couleur’]!=0 && $_REQUEST[’couleur’]!=1)$erreur .= "- le champ couleur est mal rempli ";

$tableau_pays = array(’fr’,’us’,’gb’);if (in_array($_REQUEST[’pays’],$tableau_pays)==false)

$erreur .= "- le champ pays est mal rempli ";

if (is_array($_REQUEST[’genre’])==false ||count($_REQUEST[’genre’])<1) {

$erreur .= "- le genre n’est pas correct ";}else {

$tableau_genre = array(’policier’,’sf’,’culte’);foreach ($_REQUEST[’genre’] as $tmp) {

if (in_array($tmp,$tableau_genre)==false)$erreur .= "- le genre $tmp n’est pas correct ";

}}

if (is_array($_REQUEST[’soustitre’])==false ||count($_REQUEST[’soustitre’])<1) {

$erreur .= "- le sous-titre n’est pas correct ";}else {

$tableau_soustitre = array(’fr’,’gb’,’es’);foreach ($_REQUEST[’soustitre’] as $tmp) {

if (in_array($tmp,$tableau_soustitre)==false)$erreur .= "- le sous-titre $tmp n’est pas✂ correct ";

}}

if (!empty($erreur)) {


239LE GUIDE COMPLET

print($erreur);return false;

}

return true;

}

if (verif()==false) exit(0);

print("Titre : ".$_REQUEST[’titre’]." ");print("Année : ".$_REQUEST[’annee’]." ");$str_genre = join(’,’,$_REQUEST[’genre’]);print("Genre : ".$str_genre." ");print("Description : ".$_REQUEST[’description’]." ");print("Couleur : ".$_REQUEST[’couleur’]." ");print("Pays : ".$_REQUEST[’pays’]." ");$str_soustitre = join(’,’,$_REQUEST[’soustitre’]);print("Sous titres : ".$str_soustitre." ");

$destinataire = "[email protected]";$titre = "réponse au formulaire";

$message = "";$message .= "Titre : ".$_REQUEST[’titre’]."\n";$message .= "Année : ".$_REQUEST[’annee’]."\n";$str_genre = join(’,’,$_REQUEST[’genre’]);$message .= "Genre : ".$str_genre."\n";$message .= "Description : ".$_REQUEST[’description’]."\n";$message .= "Couleur : ".$_REQUEST[’couleur’]."\n";$message .= "Pays : ".$_REQUEST[’pays’]."\n";$str_soustitre = join(’,’,$_REQUEST[’soustitre’]);$message .= "Sous titres : ".$str_soustitre."\n";

if (mail($destinataire,$titre,$message)==true) {print("<hr/>Les informations ont bien été transmises.");

}else {

die("<hr/>L’envoi du courriel a échoué.");}

?>



Présentation des courriels en mode texte

Certains gestionnaires de courriels reconnaissent en mode texte desbalises qui permettent d’enrichir visuellement le contenu. Un mot peutainsi être passé en gras s’il est entouré d’astérisques (*), en soulignéavec d _ et en italique avec /.

Figure 9.1 : Message envoyé par le script et visualisé avec Thunderbird

Figure 9.2 : Mise en forme minimale dans un courriel en mode texte


241LE GUIDE COMPLET

9.3. Mail HTMLLe script que vous venez d’écrire ne permet d’envoyer un courriel qu’auformat texte.

Mettre une page HTML dans le corps du message ne fonctionnerait pas.L’émission d’un courriel au format HTML nécessite la mise en œuvredu quatrième paramètre de la fonction mail(). Ce paramètre est unechaîne de caractères contenant des informations qui seront ajoutées àl’en-tête (header) du message.

Un courriel est composé de deux parties principales : l’en-tête et lecorps du message. L’en-tête contient un certain nombre d’informationssur le courriel : son origine, le destinataire, le format, le sujet, l’heured’envoi, le logiciel d’envoi.

L’organisation des données dans cet en-tête est très simple :champs1: valeur1champs2: valeur2etc.

Voyez cet exemple d’en-tête de courriel :From: [email protected]: [email protected]: retour de vacancesX-Mailer: Microsoft Outlook Express

La commande mail() compose donc un en-tête par défaut en intégrantles données passées en paramètres : le destinataire (To:), le sujet

Figure 9.3 :Partie de l’en-tête d’un courriel (vu avecOutlook Express)



(Subject:). Le quatrième paramètre permet d’ajouter certainesinformations à cet en-tête.

Il est courant qu’une personne recevant un courriel émanant d’un scriptPHP ne sache pas qui lui a envoyé. En ajoutant "From:[email protected]" comme quatrième paramètre, le destinataire est enmesure de connaître l’origine du courriel.

Les lignes contenues dans le quatrième paramètre doivent être séparéespar des sauts de ligne : \n.

Ajoutez également une adresse de réponse (Reply−To) différente del’adresse de l’émetteur (From) :mail("[email protected]","retour de vacances","excellent",

"From: [email protected]\nReply-To: [email protected]");

C’est aussi grâce à l’en-tête que vous allez être en mesure de dire augestionnaire de courriels que le message qu’il a reçu doit être considérécomme une page HTML. Les deux lignes suivantes dans l’en-têteindiquent que le courriel n’est pas du simple texte.MIME-Version: 1.0Content-Type: multipart/alternative; boundary=B97C1230

Le corps du courriel doit lui aussi être construit de manière spécifique.Le contenu HTML doit être précédé de :This is a multi-part message in MIME format.--B97C1230Content-Type: text/html; charset="iso-8859-1"

… et suivi de :--B97C1230--end of the multi-part

La valeur "B97C1230", que l’on retrouve en trois endroits, est unevaleur à la fois aléatoire et unique. Il est possible de calculer une valeurunique en PHP de la façon suivante :$val_unique = md5(uniqid(rand()));

Affichez une liste de 20 valeurs uniques générées avec cette technique :for ($i=1;$i<=20;$i++){

$unique = md5(uniqid(rand()));print("$i - $unique ");

}

Mail HTML Chapitre 9

243LE GUIDE COMPLET

Envoyez votre premier courriel en HTML :<?php

$boundary = md5(uniqid(rand()));

$header = "";$header .= "From: php <[email protected]>\n";$header .= "Reply-To: [email protected]\n";$header .= "MIME-Version: 1.0\n";$header .= "Content-Type: multipart/alternative;✂ boundary=$boundary\n";

$sujet = "test d’envoi HTML";

$html = "\nThis is a multi-part message in MIME format.";$html .= "\n--$boundary\nContent-Type: text/html;✂ charset=\"iso-8859-1\"\n\n";$html .= "<html><body>\n";$html .= " <center><h2>premier✂ courriel HTML</h2>\n";$html .= "</body></html>\n";$html .= "\n--$boundary--\n end of the multi-part";

Figure 9.4 : Liste de 20 valeurs uniques



mail("[email protected]",$sujet,$html,$header);

print("courriel envoyé ...");

?>

Le résultat correspond tout à fait à vos attentes :

Pour voir comment la fonction a organisé les données, vous pouvezafficher les sources du courriel :

Vous retrouvez bien tous les éléments transmis.

Figure 9.5 :Un premier courrielHTML

Figure 9.6 :Source du courriel HTML


245LE GUIDE COMPLET

Images et courriels

Il est possible de joindre les images composant le courriel dans lecontenu même de ce dernier. Cette méthode complexe n’est cependantpas obligatoire. Il est préférable de placer les images sur un serveurd’hébergement accessible sur le Net et d’y faire appel en utilisant lechemin absolu, par exemple :<img src="http://server.com/img/titre.gif" />.

Reprenez votre exemple d’envoi de profil en ajoutant la dimensionHTML :

Listing 9-3 : Envoi des informations dans un courriel HTML$destinataire = "[email protected]";

$titre = "réponse au formulaire";

$boundary = md5(uniqid(rand()));

$header = "";$header .= "From: script php <[email protected]>\n";$header .= "Reply-To: [email protected] \n";$header .= "MIME-Version: 1.0\n";$header .= "Content-Type: multipart/alternative;✂ boundary=$boundary\n";

$message = "";$message .= "\nThis is a multi-part message in MIME format.";$message .= "\n--$boundary\nContent-Type: text/html;✂ charset=\"iso-8859-1\"\n\n";$message .= "<html><body>\n";$message .= "Titre : ".$_REQUEST✂ [’titre’]." \n";$message .= "Année : ".$_REQUEST[’annee’]." \n";$str_genre = join(’,’,$_REQUEST[’genre’]);$message .= "Genre : ".$str_genre." \n";$message .= "Description : ".$_REQUEST✂ [’description’]." \n";$message .= "Couleur : ".$_REQUEST[’couleur’]✂ ." \n";$message .= "Pays : ".$_REQUEST[’pays’]." \n";$str_soustitre = join(’,’,$_REQUEST[’soustitre’]);$message .= "Sous-titres : ".$str_soustitre✂ ." \n";$message .= "</body></html>\n";$message .= "\n--$boundary--\n end of the multi-part";



if (mail($destinataire,$titre,$message,$header)==true) {print("<hr/>Les informations ont bien été transmises.");

}else {

die("<hr/>L’envoi du courriel a échoué.");}

Tous les champs sont maintenant bien renseignés (voir le champ From).

Le cinquième paramètre

Les versions les plus récentes de PHP (supérieures à 4.0.5) ajoutent uncinquième paramètre optionnel à la fonction mail(). Ce paramètrepermet de transmettre des « instructions » au logiciel qui va se chargerd’envoyer le courriel sur le Net. Parmi les commandes intéressantes, ontrouve essentiellement "−f$adr", où $adr correspond à l’e-mail de lapersonne qui recevra un message d’erreur si le courriel ne peut arriver àdestination. La fonction mail() s’utilise alors comme suit :mail($destinataire,$titre,$message,$header,"−f$adr");.Ce paramètre permet aussi d’éviter certaines erreurs avec les serveursSMTP qui refusent les courriels dont l’origine n’est pas précisée. Ceparamètre n’est pas disponible si PHP est configuré en safe_mode.

Figure 9.7 : Courriel en HTML


247LE GUIDE COMPLET

9.4. Check-listj L’envoi de courriels en PHP est une opération très simple.j Les courriels contenant de la couleur ou des images nécessitent la

modification de l’en-tête du courriel.j L’en-tête du courriel permet également de préciser son origine

(From), l’adresse e-mail de retour et une multitude d’autresinformations.

j Le cinquième paramètre de la fonction mail() est très utile pourrécupérer les messages d’erreur.

Documents

L’envoid’un formulaire parcourriel