{"id":59,"date":"2013-10-10T21:53:35","date_gmt":"2013-10-10T20:53:35","guid":{"rendered":"http:\/\/louis.hatier.me\/blog\/?p=59"},"modified":"2015-08-12T17:42:43","modified_gmt":"2015-08-12T16:42:43","slug":"quickmail-email-zendframework","status":"publish","type":"post","link":"https:\/\/louis.hatier.me\/blog\/quickmail-email-zendframework\/","title":{"rendered":"Email avec Zend Framework"},"content":{"rendered":"

\"Email<\/a>La classe Zend_Mail<\/a> de Zend Framework permet d’envoyer des emails avec toutes les fonctionnalit\u00e9s utiles habituelles : ajout de destinataires en copie ou en copie cach\u00e9e, ajout de pi\u00e8ces jointes, envoie de headers suppl\u00e9mentaires, ajout d’un relai SMTP etc.<\/p>\n

Si dans un projet vous avez r\u00e9guli\u00e8rement besoin d’utiliser cette classe, certains aspects peuvent \u00eatre r\u00e9barbatifs, pour les pi\u00e8ces jointes notamment.<\/p>\n

 <\/p>\n

 <\/p>\n

<\/h2>\n

<\/p>\n

QuickMail<\/h2>\n

En tout cas c’est l’impression que j’ai eu, c’est pourquoi j’ai cr\u00e9\u00e9 une classe qui \u00e9tend la classe Zend_Mail<\/em> et qui permet d’envoyer en quelques lignes de code des emails complets.<\/p>\n

La classe est disponible sur GitHub : QuickMail<\/a>.<\/p>\n

Voici un aper\u00e7u d’un envoie d’email avec Cc, Bcc, pi\u00e8ce jointe, image et header suppl\u00e9mentaire :<\/p>\n

$content = '<p>Bonjour, voici ma photo : <img src=\"cid:maphoto.jpg\" alt=\"Ma photo\" \/><\/p>';\r\n$subject = 'Mon sujet';\r\n$recipients = array(\r\n    'friend@domain.com'\r\n);\r\n$from = 'mymail@domain.com';\r\n$fromName = 'Louis';\r\n$recipientsCc = array(\r\n    'copy.friend@domain.com',\r\n    'anothercopy.friend@domain.com'\r\n);\r\n$recipientsBcc = array(\r\n    'hidden.friend@domain.com'\r\n);\r\n$attachments = array(\r\n    '\/tmp\/maphoto.jpg',\r\n    '\/tmp\/random-pdf.pdf'\r\n);\r\n$headers = array(\r\n    'X-Mailer' => 'QuickMail'\r\n);\r\n\r\nif (QuickMail::isValid($recipients)) {\r\n    $mail = new QuickMail();\r\n    $mail->feed(\r\n        $content,\r\n        $subject,\r\n        $recipients,\r\n        $from,\r\n        $fromName,\r\n        $recipientsCc,\r\n        $recipientsBcc,\r\n        $attachments,\r\n        $headers\r\n    );\r\n    $mail->send();\r\n} else {\r\n    echo 'Un email est invalide';\r\n}\r\n<\/code><\/pre>\n
 <\/p>\n
Tester la validit\u00e9 des emails<\/h2>\n
La fonction QuickMail::isValid<\/code> est statique et permet donc de tester la validit\u00e9 d’un email n’importe o\u00f9 dans votre code sans instancier d’objet. Vous pouvez lui passer un email ou un tableau d’emails.<\/p>\n
Elle teste dans un premier temps si le format de l’email est valide, et dans un deuxi\u00e8me temps la validit\u00e9 du domaine.<\/p>\n
 <\/p>\n
Les images dans le corps de l’email<\/h2>\n
Pour afficher une image dans un email vous avez plusieurs solutions.<\/p>\n
Vous pouvez indiquer un lien HTTP de l’emplacement de l’image sur votre serveur : <img src=\"http:\/\/www.monserveur.com\/maphoto.jpg\" alt=\"Ma photo\" \/><\/code><\/p>\n
Vous pouvez \u00e9galement encoder l’image en base64 : <img src=\"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgA...AAAABJRU5ErkJggg==\" alt=\"Ma photo\" \/><\/code><\/p>\n
Ou bien vous pouvez joindre l’image \u00e0 l’email et lui renseigner\u00a0un CID comme ceci : <img src=\"cid:maphoto.jpg\" alt=\"Ma photo\" \/><\/code><\/p>\n
La premi\u00e8re solution est la plus simple mais n\u00e9cessite de mettre \u00e0 disposition les images sur un serveur. La deuxi\u00e8me solution est tr\u00e8s pratique mais n’ai pas support\u00e9e par tous les clients de messagerie. La derni\u00e8re solution permet de s’affranchir du serveur.<\/p>\n
Dans tous les cas l’affichage des images sera potentiellement bloqu\u00e9 par d\u00e9faut. L’encodage en base64 est \u00e0 proscrire si vous comptez \u00eatre lu par tous les clients, apr\u00e8s \u00e0 vous de choisir entre les deux autres solutions en fonction de vos besoins.<\/p>\n
En ce qui concerne la classe QuickMail<\/em>, vous pouvez soit ins\u00e9rer un lien HTTP vers une image directement, soit passer l’image en pi\u00e8ce jointe et indiquer dans l’attribut src<\/em> de l’image cid:maphoto.jpg<\/code><\/p>\n
Si vous travaillez avec Zend Framework et que cette classe vous int\u00e9resse, n’h\u00e9sitez pas \u00e0 la t\u00e9l\u00e9charger et \u00e0 me faire part de vos remarques !<\/p>\n
\"Share<\/a>