ZF Zend Framework

Behind the Site

Programmer's Reference Guide

Sécuriser les transports SMTP
Zend_Mail
Guide de référence du programmeur

Lire des courriels

Zend_Mail peut lire des courriels provenant de différents stockages locaux ou distants. Tous bénéficient de la même API pour compter et extraire les messages, certains implémentent des interfaces additionnelles pour des fonctionnalités moins communes. Pour une vue d'ensemble des fonctionnalités des stockages implémentés voir la table suivante.

Vue d'ensemble des fonctionnalités de lecture de courriels
Fonctionnalité Mbox Maildir Pop3 IMAP
Type de stockage local local distant distant
Extraction des messages Oui Oui Oui Oui
Extraction des parties mimes émulé émulé émulé émulé
Dossiers Oui Oui Non Oui
Créer des messages/dossiers Non A faire Non A faire
Flags Non Oui Non Oui
Quota Non Oui Non Non

Exemple simple avec Pop3

  1. $mail = new Zend_Mail_Storage_Pop3(array('host'     => 'localhost',
  2.                                          'user'     => 'test',
  3.                                          'password' => 'test'));
  4.  
  5. echo $mail->countMessages() . " messages trouvés\n";
  6. foreach ($mail as $message) {
  7.     echo "Mail from '{$message->from}': {$message->subject}\n";
  8. }

Ouvrir un stockage local

Mbox et Maildir sont les deux formats supportés pour le stockage local des courriels, tous les deux dans leurs formats le plus simple.

Si vous voulez lire un fichier Mbox, vous devez juste donner le nom du fichier au constructeur de Zend_Mail_Storage_Mbox:

  1. $mail =
  2.     new Zend_Mail_Storage_Mbox(array('filename' => '/home/test/mail/inbox'));

Maildir est très similaire mais nécessite un nom de dossier :

  1. $mail =
  2.     new Zend_Mail_Storage_Maildir(array('dirname' => '/home/test/mail/'));

Ces deux constructeurs lèvent une exception Zend_Mail_Exception si le stockage ne peut pas être lu.

Ouvrir un stockage distant

Pour les stockages distants les deux protocoles les plus populaires sont supportés : Pop3 et Imap. Les deux nécessitent au moins un hôte et un utilisateur pour se connecter et s'identifier. Le mot de passe par défaut est une chaîne vide et le port par défaut celui donné dans la RFC du protocole.

  1. // connexion à Pop3
  2. $mail = new Zend_Mail_Storage_Pop3(array('host'     => 'exemple.com'
  3.                                          'user'     => 'test',
  4.                                          'password' => 'test'));
  5.  
  6. // connexion à Imap
  7. $mail = new Zend_Mail_Storage_Imap(array('host'     => 'exemple.com'
  8.                                          'user'     => 'test',
  9.                                          'password' => 'test'));
  10.  
  11. // exemple à un port non standard
  12. $mail = new Zend_Mail_Storage_Pop3(array('host'     => 'exemple.com',
  13.                                          'port'     => 1120
  14.                                          'user'     => 'test',
  15.                                          'password' => 'test'));

Pour ces deux stockages SSL et TLS sont supportés. Si vous utilisez SSL le port par défaut change comme indiqué dans la RFC.

  1. // exemples pour Zend_Mail_Storage_Pop3,
  2. // identique à Zend_Mail_Storage_Imap
  3.  
  4. // utiliser SSL avec un port différent
  5. // (par défaut 995 pour Pop3 et 993 pour Imap)
  6. $mail = new Zend_Mail_Storage_Pop3(array('host'     => 'exemple.com'
  7.                                          'user'     => 'test',
  8.                                          'password' => 'test',
  9.                                          'ssl'      => 'SSL'));
  10.  
  11. // utiliser TLS
  12. $mail = new Zend_Mail_Storage_Pop3(array('host'     => 'exemple.com'
  13.                                          'user'     => 'test',
  14.                                          'password' => 'test',
  15.                                          'ssl'      => 'TLS'));

Les deux constructeurs peuvent lever une exception Zend_Mail_Exception ou Zend_Mail_Protocol_Exception(étendant Zend_Mail_Exception), en fonction du type de l'erreur.

Extraire des messages et autres méthodes simples

Dès que vous avez ouvert l'accès, les messages peuvent être extraits. Vous devez fournir un numéro de message, qui est un compteur qui démarre à 1 pour le premier message. Pour extraire le message vous utilisez la méthode getMessage() :

  1. $message = $mail->getMessage($numeroDeMessage);

L'accès sous forme de tableau est aussi supporté, mais cet méthode d'accès ne supporte pas les paramètres additionnels qui aurait pu être ajouté à getMessage(). Tant que vous n'en n'avez pas besoin et que vous pouvez vivre avec les valeurs par défaut, vous pouvez utiliser :

  1. $message = $mail[$numeroDeMessage];

Pour itérer tous les messages, l'interface Iterator est implémentée :

  1. foreach ($mail as $numeroDeMessage => $message) {
  2.     // faire qqch ...
  3. }

Pour compter les messages dans le stockage, vous pouvez soit utiliser la méthode countMessages() ou utiliser l'accès de type tableau :

  1. // par méthode
  2. $maxMessage = $mail->countMessages();
  3.  
  4. // type tableau
  5. $maxMessage = count($mail);

Pour supprimer un mail vous pouvez utiliser la méthode removeMessage() ou l'accès de type tableau :

  1. // méthode
  2. $mail->removeMessage($numeroDeMessage);
  3.  
  4. // type tableau
  5. unset($mail[$messageNum]);

Travailler avec les messages

Après avoir extrait les messages avec getMessage() vous voulez extraire les en-têtes, le contenu ou une partie d'un message multipart. Tous les en-têtes peuvent être accédés via les propriétés ou la méthode getHeader() si vous voulez plus de contrôle ou avoir accès à des en-têtes peu communs. Les noms des en-têtes gérés en interne avec une casse minuscule, ainsi la casse du nom de l'en-tête importe peu. En outre les en-têtes avec un tiret-bas peuvent être écrit avec la » notation Camel. Si aucun en-tête n'est trouvé pour les deux notations, une exception est levée. Pour éviter ceci, la méthode headerExists() peut être utilisée pour vérifier l'existence d'un en-tête.

  1. // récupérer l'objet message
  2. $message = $mail->getMessage(1);
  3.  
  4. // afficher le sujet du message
  5. echo $message->subject . "\n";
  6.  
  7. // récupérer l'en-tête content-type
  8. $type = $message->contentType;
  9.  
  10. // vérifier si CC est spécifié :
  11. if( isset($message->cc) ) { // ou $message->headerExists('cc');
  12.     $cc = $message->cc;
  13. }

Si vous avez plusieurs en-têtes avec le même nom, par exemple les en-têtes "Received", vous pourriez les vouloir sous la forme d'un tableau plutôt qu'en tant que chaîne. Ceci est possible avec la méthode getHeader().

  1. // récupérer l'en-tête comme une propriété - le résultat est toujours
  2. // une chaîne, avec de nouvelles lignes entre chaque occurence
  3. // dans le message
  4. $received = $message->received;
  5.  
  6. // la même chose avec la méthode getHeader()
  7. $received = $message->getHeader('received', 'string');
  8.  
  9. // ou mieux un tableau avec une entrée pour chaque occurence
  10. $received = $message->getHeader('received', 'array');
  11. foreach ($received as $line) {
  12.     // faire qqch
  13. }
  14.  
  15. // si vous ne définissez pas de format vous récupérerez la représentation
  16. // interne (chaîne pour en-têtes uniques, tableau pour en-têtes multiples
  17. $received = $message->getHeader('received');
  18. if (is_string($received)) {
  19.     // seulement un en-tête received trouvé dans le message
  20. }

La méthode getHeaders() retourne tous les headers sous forme de tableau avec des clés en minuscules et des valeurs en tant que tableau pour des en-têtes multiples ou une chaîne pour des en-têtes uniques.

  1. // récupère tous les en-têtes
  2. foreach ($message->getHeaders() as $name => $value) {
  3.     if (is_string($value)) {
  4.         echo "$name: $value\n";
  5.         continue;
  6.     }
  7.     foreach ($value as $entry) {
  8.         echo "$name: $entry\n";
  9.     }
  10. }

Si vous n'avez pas de message de type multipart, extraire le contenu est facilité avec getContent(). A la différence des en-têtes, le contenu est seulement extrait en cas de besoin (alias late-fetch).

  1. // affiche le contenu du message
  2. echo '<pre>';
  3. echo $message->getContent();
  4. echo '</pre>';

Vérifier si un message est de type multipart est réalisé avec la méthode isMultipart(). Si vous avez un message de type multipart vous pouvez récupérer une instance de Zend_Mail_Part avec la méthode getPart(). Zend_Mail_Part est la classe de base de Zend_Mail_Message, donc vous avez les mêmes méthodes : getHeader(), getHeaders(), getContent(), getPart(), isMultipart et les propriétés pour les en-têtes.

  1. // récupérer la première partie non-multipart
  2. $part = $message;
  3. while ($part->isMultipart()) {
  4.     $part = $message->getPart(1);
  5. }
  6. echo 'Le type de cette partie est '
  7.    . strtok($part->contentType, ';')
  8.    . "\n";
  9. echo "Contenu :\n";
  10. echo $part->getContent();

Zend_Mail_Part implémente aussi RecursiveIterator, qui rend facile le scan de toutes les parties. Et pour un affichage facile, il implémente de plus la méthode magique __toString() qui retourne le contenu.

  1. // affiche la première partie de type text/plain=
  2. $foundPart = null;
  3. foreach (new RecursiveIteratorIterator($mail->getMessage(1)) as $part) {
  4.     try {
  5.         if (strtok($part->contentType, ';') == 'text/plain') {
  6.             $foundPart = $part;
  7.             break;
  8.         }
  9.     } catch (Zend_Mail_Exception $e) {
  10.         // ignore
  11.     }
  12. }
  13. if (!$foundPart) {
  14.     echo 'Aucune partie "plain text" trouvés';
  15. } else {
  16.     echo "Partie \"plain text\" : \n" . $foundPart;
  17. }

Vérifier les drapeaux ("flags")

Maildir et IMAP supporte l'enregistrement de drapeaux. La classe Zend_Mail_Storage possède des constantes pour tous les drapeaux maildir et IMAP connus, nommés Zend_Mail_Storage::FLAG_<nomdudrapeau>. Pour vérifier les drapeaux Zend_Mail_Message possède une méthode hasFlag(). Avec getFlags() vous récupérez tous les drapeaux existants.

  1. // trouvé les messages non lus
  2. echo "Emails non lus :\n";
  3. foreach ($mail as $message) {
  4.     if ($message->hasFlag(Zend_Mail_Storage::FLAG_SEEN)) {
  5.         continue;
  6.     }
  7.     // marque les emails récents/nouveaux
  8.     if ($message->hasFlag(Zend_Mail_Storage::FLAG_RECENT)) {
  9.         echo '! ';
  10.     } else {
  11.         echo '  ';
  12.     }
  13.     echo $message->subject . "\n";
  14. }
  15.  
  16. // vérifie les drapeaux connus
  17. $flags = $message->getFlags();
  18. echo "Le message est marqué comme : ";
  19. foreach ($flags as $flag) {
  20.     switch ($flag) {
  21.         case Zend_Mail_Storage::FLAG_ANSWERED:
  22.             echo 'Réponse ';
  23.             break;
  24.         case Zend_Mail_Storage::FLAG_FLAGGED:
  25.             echo 'Marqués ';
  26.             break;
  27.  
  28.         // ...
  29.         // vérifie d'autres drapeaux
  30.         // ...
  31.  
  32.         default:
  33.             echo $flag . '(drapeau inconnu) ';
  34.     }
  35. }

Comme IMAP autorise les drapeaux définis par client ou l'utilisateur, vous pouvez obtenir ces drapeaux même s'ils n'ont pas de constante dans Zend_Mail_Storage. Au lieu de cela ils sont retournés comme une chaîne et peuvent être vérifiés de la même manière avec hasFlag().

  1. // Vérifie le message avec les drapeaux $EstUnSpam, $SpamTeste
  2. if (!$message->hasFlag('$SpamTeste')) {
  3.     echo 'ce message n\'est pas considéré comme un spam';
  4. } else if ($message->hasFlag('$EstUnSpam')) {
  5.     echo 'ce message est un spam';
  6. } else {
  7.     echo 'ce message est sûr';
  8. }

Utiliser les dossiers

Tous les stockages, excepté Pop3, supportent les dossiers, également appelés boîtes aux lettres. L'interface implémentée par tous les stockages supportant les dossiers s'appelle Zend_Mail_Storage_Folder_Interface. En outre toutes ces classes ont un paramètre facultatif additionnel appelé folder, qui est le dossier choisi après ouverture, dans le constructeur.

Pour les stockages locaux vous devez employer les classes séparées appelées Zend_Mail_Storage_Folder_Mbox ou Zend_Mail_Storage_Folder_Maildir. Tous les deux ont besoin d'un paramètre nommé dirname avec le nom du dossier de base. Le format pour le maildir est comme définie dans maildir++ (avec un point comme délimiteur par défaut), Mbox est une hiérarchie de dossiers avec des fichiers Mbox. Si vous n'avez pas un dossier de Mbox appelé INBOX dans votre dossier de base Mbox vous devez placer un autre dossier dans le constructeur.

Zend_Mail_Storage_Imap supporte déjà des dossiers par défaut. Exemples pour ouvrir ces stockages :

  1. // mbox avec dossiers
  2. $mail = new Zend_Mail_Storage_Folder_Mbox(
  3.             array('dirname' => '/home/test/mail/')
  4.         );
  5.  
  6. // mbox avec un dossier par défaut nommé INBOX, fontionne aussi
  7. // avec Zend_Mail_Storage_Folder_Maildir et Zend_Mail_Storage_Imap
  8. $mail = new Zend_Mail_Storage_Folder_Mbox(
  9.             array('dirname' => '/home/test/mail/', 'folder'  => 'Archive')
  10.         );
  11.  
  12. // maildir avec dossiers
  13. $mail = new Zend_Mail_Storage_Folder_Maildir(
  14.             array('dirname' => '/home/test/mail/')
  15.         );
  16.  
  17. // maildir avec deux-points comme délimiteur,
  18. // comme suggéré dans Maildir++
  19. $mail = new Zend_Mail_Storage_Folder_Maildir(
  20.             array('dirname' => '/home/test/mail/', 'delim'   => ':')
  21.         );
  22.  
  23. // imap est le même avec ou sans dossier
  24. $mail = new Zend_Mail_Storage_Imap(array('host'     => 'example.com',
  25.                                          'user'     => 'test',
  26.                                          'password' => 'test'));

Avec la méthode getFolders($root = null) vous pouvez obtenir la hiérarchie des dossiers en commençant par le dossier racine ou le dossier fourni. Elle est retournée comme instance de Zend_Mail_Storage_Folder, qui implémente RecursiveIterator et tous ses enfants sont également des instances de Zend_Mail_Storage_Folder. Chacune de ces instances à des noms locaux et globaux retournés par les méthodes getLocalName() et getGlobalName(). Le nom global est le nom absolu du dossier racine (délimiteurs y compris), le nom local est le nom dans le dossier parent.

Noms de dossiers
Nom global Nom local
/INBOX INBOX
/Archive/2005 2005
List.ZF.General General

Si vous employez l'itérateur, la clé de l'élément courant est le nom local. Le nom global est également retourné par la méthode magique __toString(). Quelques dossiers peuvent ne pas être sélectionnables, ce qui veut dire qu'ils ne peuvent pas stocker des messages et les choisir entraînerait une erreur. Ceci peut être vérifié avec la méthode isSelectable(). Ainsi il est très facile de produire l'arbre entier dans une vue :

  1. $folders = new RecursiveIteratorIterator(
  2.                     $this->mail->getFolders(),
  3.                     RecursiveIteratorIterator::SELF_FIRST
  4.                 );
  5. echo '<select name="folder">';
  6. foreach ($folders as $localName => $folder) {
  7.     $localName = str_pad('', $folders->getDepth(), '-', STR_PAD_LEFT)
  8.                . $localName;
  9.     echo '<option';
  10.     if (!$folder->isSelectable()) {
  11.         echo ' disabled="disabled"';
  12.     }
  13.     echo ' value="' . htmlspecialchars($folder) . '">'
  14.         . htmlspecialchars($localName) . '</option>';
  15. }
  16. echo '</select>';

Les dossiers choisis courants sont retournés par la méthode getCurrentFolder(). Changer de dossier est fait avec la méthode selectFolder(), qui a besoin du nom global comme paramètre. Si vous voulez éviter d'écrire des délimiteurs vous pouvez également employer les propriétés d'une instance de Zend_Mail_Storage_Folder :

  1. // selon votre stockage et ses réglages $rootFolder->Archive->2005
  2. // est la même chose que :
  3. //   /Archive/2005
  4. //  Archive:2005
  5. //  INBOX.Archive.2005
  6. //  ...
  7. $folder = $mail->getFolders()->Archive->2005;
  8. echo 'Le précédent dossier était '
  9.    . $mail->getCurrentFolder()
  10.    . "Le nouveau dossier est $folder\n";
  11. $mail->selectFolder($folder);

Utilisation avancée

Utiliser NOOP

Si vous employez un stockage distant et avez une longue tâche vous pourriez devoir maintenir la connexion persistante par l'intermédiaire du noop :

  1. foreach ($mail as $message) {
  2.  
  3.     // faire qqch...
  4.  
  5.     $mail->noop(); // maintient la connexion
  6.  
  7.     // faire autre chose...
  8.  
  9.     $mail->noop(); // maintient la connexion
  10. }

Mettre en cache des instances

Zend_Mail_Storage_Mbox, Zend_Mail_Storage_Folder_Mbox, Zend_Mail_Storage_Maildir et Zend_Mail_Storage_Folder_Maildir implémentant les méthodes magiques __sleep() et __wakeup(), ce qui veut dire qu'ils sont sérialisable. Ceci évite d'analyser les dossiers ou l'arbre des dossiers plus d'une fois. L'inconvénient est que votre stockage de Mbox ou de Maildir ne doit pas changer. Quelques contrôles faciles sont faits, comme ré-analyser le dossier courant de Mbox si le temps de modification change ou ré-analysé la structure du dossier si un dossier a disparu (ce qui a toujours comme conséquence une erreur, mais vous pouvez rechercher un autre dossier après). Il est meilleur si vous avez quelque chose comme un fichier de signal pour des changements et la vérifiez avant d'employer l'instance caché.

  1. // il n'y a pas de gestionnaire spécifique de cache utilisé ici,
  2. // changer le code pour utiliser votre gestionnaire de cache
  3. $signal_file = '/home/test/.mail.last_change';
  4. $mbox_basedir = '/home/test/mail/';
  5. $cache_id = 'exemple de mail en cache ' . $mbox_basedir . $signal_file;
  6.  
  7. $cache = new Your_Cache_Class();
  8. if (!$cache->isCached($cache_id) ||
  9.     filemtime($signal_file) > $cache->getMTime($cache_id)) {
  10.     $mail = new Zend_Mail_Storage_Folder_Pop3(
  11.                 array('dirname' => $mbox_basedir)
  12.             );
  13. } else {
  14.     $mail = $cache->get($cache_id);
  15. }
  16.  
  17. // faire qqch ...
  18.  
  19. $cache->set($cache_id, $mail);

Étendre les classes de protocoles

Les stockages distants utilisent deux classes : Zend_Mail_Storage_<NOM> et Zend_Mail_Protocol_<NOM>. La classe de protocole traduit les commandes et les réponses de protocole et issu de ou pour PHP, comme des méthodes pour les commandes ou les variables avec différentes structures pour les données. L'autre/classe principale met en application l'interface commune.

Si vous avez besoin de fonctionnalités additionnelles de protocole vous pouvez étendre la classe de protocole et l'employer dans le constructeur de la classe principale. Supposer par exemple que nous devons joindre différents ports avant que nous puissions nous relier à POP3.

  1. Zend_Loader::loadClass('Zend_Mail_Storage_Pop3');
  2.  
  3. class Example_Mail_Exception extends Zend_Mail_Exception
  4. {}
  5.  
  6. class Example_Mail_Protocol_Exception extends Zend_Mail_Protocol_Exception
  7. {}
  8.  
  9. class Example_Mail_Protocol_Pop3_Knock extends Zend_Mail_Protocol_Pop3
  10. {
  11.     private $host, $port;
  12.  
  13.     public function __construct($host, $port = null)
  14.     {
  15.         // pas d'auto-connexion dans cette classe
  16.         $this->host = $host;
  17.         $this->port = $port;
  18.     }
  19.  
  20.     public function knock($port)
  21.     {
  22.         $sock = @fsockopen($this->host, $port);
  23.         if ($sock) {
  24.             fclose($sock);
  25.         }
  26.     }
  27.  
  28.     public function connect($host = null, $port = null, $ssl = false)
  29.     {
  30.         if ($host === null) {
  31.             $host = $this->host;
  32.         }
  33.         if ($port === null) {
  34.             $port = $this->port;
  35.         }
  36.         parent::connect($host, $port);
  37.     }
  38. }
  39.  
  40. class Example_Mail_Pop3_Knock extends Zend_Mail_Storage_Pop3
  41. {
  42.     public function __construct(array $params)
  43.     {
  44.         // ... vérifier les $params ici ! ...
  45.         $protocol =
  46.             new Example_Mail_Protocol_Pop3_Knock($params['host']);
  47.  
  48.         // faire votre fonction "spéciale"
  49.         foreach ((array)$params['knock_ports'] as $port) {
  50.             $protocol->knock($port);
  51.         }
  52.  
  53.         // récupérer l'état coorect
  54.         $protocol->connect($params['host'], $params['port']);
  55.         $protocol->login($params['user'], $params['password']);
  56.  
  57.         // initialise le parent
  58.         parent::__construct($protocol);
  59.     }
  60. }
  61.  
  62. $mail = new Example_Mail_Pop3_Knock(
  63.             array('host'        => 'localhost',
  64.                                    'user'        => 'test',
  65.                                    'password'    => 'test',
  66.                                    'knock_ports' => array(1101,
  67.                                                           1105,
  68.                                                           1111))
  69.         );

Comme vous voyez nous supposons toujours que nous sommes reliés, identifiés et, si supporté, un dossier est choisi dans le constructeur de la classe principale. Ainsi si vous assignez votre propre classe de protocole vous devez toujours vous assurer que c'est fait ou la prochaine méthode échouera si le serveur ne la permet pas dans l'état actuel.

Utilisation des Quotas (avant 1.5)

Zend_Mail_Storage_Writable_Maildir supporte les quotas Maildir++. Ceci est désactivé par défaut, mais il est possible de l'utiliser manuellement, si la vérification automatique n'est pas souhaitée (ce qui veut dire que appendMessage(), removeMessage() et copyMessage() ne vérifie pas et n'ajoute pas d'entrée dans le fichier de contrôle de la taille du dossier de mails). Si vous l'activez une exception sera levée si vous tentez d'écrire dans le dossier de mails et qu'il a déjà atteint son quota.

Il existe trois méthodes pour les quotas : getQuota(), setQuota() et checkQuota():

  1. $mail = new Zend_Mail_Storage_Writable_Maildir(
  2.             array('dirname' => '/home/test/mail/')
  3.         );
  4. $mail->setQuota(true); // true pour activer, false pour désactiver
  5. echo 'La vérification du quota est maintenant ',
  6.      $mail->getQuota() ? 'active' : 'inactive',
  7.      "\n";
  8. // la vérification du quota peut être utilisée
  9. // si celle-ci est désactivée
  10. echo 'Vous êtes ',
  11.      $mail->checkQuota() ? 'hors quota' : 'dans le quota',
  12.      "\n";

checkQuota() peut aussi retournée une réponse plus détaillée :

  1. $quota = $mail->checkQuota(true);
  2. echo 'Vous êtes ',
  3.      $quota['over_quota'] ? 'hors quota' : 'dans le quota',
  4.      "\n";
  5. echo 'Vous avez ',
  6.      $quota['count'],
  7.      ' de ',
  8.      $quota['quota']['count'],
  9.      ' messages et vous utilisez ';
  10. echo $quota['size'], ' de ', $quota['quota']['size'], ' octets';

Si vous voulez spécifier votre propre quota plutôt que d'utiliser celui spécifié dans le fichier de contrôle de la taille du dossier de mails, vous pouvez le faire avec setQuota() :

  1. // le nombre de messages et la taille en octet sont supportés,
  2. // l'ordre est important
  3. $quota = $mail->setQuota(array('size' => 10000, 'count' => 100));

Pour ajouter vos propres vérifications de quota, utilisez des caractères uniques en tant que clé et ils seront préservés (mais évidemment non vérifié). Il est aussi possible d'étendre Zend_Mail_Storage_Writable_Maildir pour définir votre propre quota seulement si le fichier de contrôle de la taille du dossier de mails est absent (qui peut se produire dans Maildir++) :

  1. class Exemple_Mail_Storage_Maildir extends Zend_Mail_Storage_Writable_Maildir {
  2.     // getQuota est appelé avec $fromStorage = true
  3.     // par la vérification de quota
  4.     public function getQuota($fromStorage = false) {
  5.         try {
  6.             return parent::getQuota($fromStorage);
  7.         } catch (Zend_Mail_Storage_Exception $e) {
  8.             if (!$fromStorage) {
  9.                 // Erreur inconnue
  10.                 throw $e;
  11.             }
  12.             // le fichier de contrôle de la taille du dossier de mails
  13.             // doit être absent
  14.  
  15.             list($count, $size) = get_un_autre_quota();
  16.             return array('count' => $count, 'size' => $size);
  17.         }
  18.     }
  19. }
Sécuriser les transports SMTP
Zend_Mail
Guide de référence du programmeur

Comments

Posted by: Simon on: 2010-05-04 01:54:50 ⁋
In order to delete an email from a maildir or mbox storage one must use:
Zend_Mail_Storage_Writable_Maildir
or
Zend_Mail_Storage_Writable_Mbox

There are historical reasons for this and they should be addressed and standardised. For now the above classes must be used or an exception will be thrown with a message that is a bit misleading.

Please refer to:
http://framework.zend.com/issues/browse/ZF-9574
for more details.
Posted by: Simon on: 2010-05-04 01:55:00 ⁋
In order to delete an email from a maildir or mbox storage one must use:
Zend_Mail_Storage_Writable_Maildir
or
Zend_Mail_Storage_Writable_Mbox

There are historical reasons for this and they should be addressed and standardised. For now the above classes must be used or an exception will be thrown with a message that is a bit misleading.

Please refer to:
http://framework.zend.com/issues/browse/ZF-9574
for more details.
Posted by: Duccio Gasparri on: 2010-05-04 10:15:13 ⁋
Iterator interface used in


foreach($mail as $messageId => $message) {
    //... do stuff here
    $mail->moveMessage($messageId,$anotherFolder);
} 

will not work properly and throw an exception if during the loop messages are deleted or moved to other folders. The only way to perform a safe loop through the messages is:


$messageId=1;
$numMessages = $mail->countMessages();
for($i=0 ; $i<$numMessages ; $i++) {

    $message = $mail->getMessage($messageId);

    //... do stuff here

    if($toBeMoved) {
        //Move message and leave messageId unchanged
        $mail->moveMessage($messageId,$anotherFolder);
    } elseif($toBeRemoved) {
        //Remove message and leave messageId unchanged
        $mail->removeMessage($messageId);
    } else {
        //Leave message alone and increase messageId
        $messageId++;
    }
    
}
Posted by: Clay Hinson on: 2010-06-05 04:54:09 ⁋
@Duccio,

Using the iterator does in fact work, but according to the API documentation [1] you have to use $mail->getNumberByUniqueId() before moving the message, so that the current message number is updated to prevent throwing the exception.

Example:

foreach ($mail as $messageId => $message) {
    // get the unique id of the current message before any operations
     $messageUniqueId = $mail->getUniqueId($messageId);
    
    /**
    *  other operations..
    */

    /**
    * move message
    */
    // first get the message's current imap id
    $currentMessageId = $mail->getNumberByUniqueId($messageUniqueId);
    // then move it to its destination
    $mail->moveMessage($currentMessageId, '/Deleted Items');
    
    /** 
    * or remove it:
    * $mail->removeMessage($currentMessageId);
    */
}

[1] http://framework.zend.com/apidoc/1.10/Zend_Mail/Storage/Zend_Mail_Storage_Abstract.html#getNumberByUniqueId
Posted by: Ian Briggs on: 2010-06-23 00:02:13 ⁋
I am using a wildcard redirect to save users email to a database. Example:

*@example.com

The whole body of the email is saved in a database, can I retrieve the body and pass it thought this function to actually read it.

Right now its (of course) coming out in blob data and I just need to read the body of the message.

How can I do this?
Posted by: Nawar Nory on: 2010-08-20 20:13:39 ⁋
Just a note about the moving the message for Maildir type of inbox.

It is not clearly mentioned in the documentation that if you want to move the message to the /cur from /new folder, you need to use the function setFlag, that is to change the flag of the message from Recent to Seen and as follows:


foreach ($mail as $messageId => $message) {
    // get the unique id of the current message before any operations
     $messageUniqueId = $mail->getUniqueId($messageId);
    
    /*
    *  go hug some teddy bears
    */
    /*
    * move message from /new to /cur
    */
    // first get the message's current imap id
    $currentMessageId = $mail->getNumberByUniqueId($messageUniqueId);
    // then move it to its destination
$mail->setFlags($currentMessageId, array(Zend_Mail_Storage::FLAG_SEEN));
    
} 

That will do the trick as setFlag will add the suffix ":2,S" to the end of the message name and move it to the /cur folder. Hope this will help someone there!

Nawar

Posted by: offspring on: 2010-10-01 08:44:20 ⁋
Hello,
I'm trying to get all messages from Gmail Imap account labelled with "PHP".
But I really don't know how to achieve that.

I can access those messages using this as host:
$host = '{imap.gmail.com:993/ssl/novalidate-cert}PHP';
in standard PHP fucntion:
$mbox = imap_open($host, $username, $password);
Posted by: Burak on: 2010-10-06 07:55:41 ⁋
ummmmm.
Zend_Mail_Storage_Pop3 class no where to be found?
Posted by: Sondra Russell on: 2010-12-30 23:10:02 ⁋
On deleting from Mbox, I see Zend_Mail_Storage_Writable_Maildir in the latest framework download, but I don't see Zend_Mail_Storage_Writable_Mbox.

Am I missing something?

thanks,
-S.
Posted by: Ilya on: 2011-08-05 13:42:25 ⁋
Thanks, Andrew.
Posted by: Junrey on: 2011-06-16 16:49:57 ⁋
Does anyone has an example in saving an image or pdf attachment?
Posted by: Andrew on: 2011-06-17 21:10:04 ⁋
Not sure why the framework isn't doing this by default, but you will need to manually reassemble line breaks. If you notice your email text lines ending with equals signs, it means they are continued onto the following line. Simply replace all occurrances of equals sign followed by line breaks. For example:

$plainTextPart = 'My long line continu=
es onto the next line';
$content = str_replace("=\n", '', $plainTextPart);
Posted by: Andrew on: 2011-07-06 23:24:05 ⁋
Also, beware of "text/plain" parts that are base64 encoded. You will have to manually decode those ones. Here's what I have in my script:


// search for first text/plain part
$foundPart = null;
foreach (new RecursiveIteratorIterator($message) as $part) {
    try {
        if (strtok($part->contentType, ';') == 'text/plain') {
            $foundPart = $part;
            break;
        }
    } catch (Zend_Mail_Exception $e) {
        // ignore
    }
}
if (!$foundPart) {
    throw new Exception('no plain text part found');
}
$content = $foundPart->getContent();
if ($foundPart->contentTransferEncoding == 'base64') {
    $content = base64_decode($content);
}
Posted by: Andrew on: 2011-07-11 22:37:06 ⁋
I was wrong...there is even more that you need to do. You need to decode pretty much every email yourself. Here is the code that I'm using so far:


if ($message->isMultipart()) {
    $foundPart = $this->get_plain_text_part_from_multipart($message);
} else {
    $foundPart = $message;
}
$content = $foundPart->getContent();

switch ($foundPart->contentTransferEncoding) {
    case 'base64':
        $content = base64_decode($content);
        break;
    case 'quoted-printable':
        $content = quoted_printable_decode($content);
        break;
}

preg_match('/charset="(.+)"$/', $foundPart->contentType, $matches);
$charset = $matches[1];
if ($charset == 'iso-8859-1') {
    $content = utf8_encode($content);
}
Posted by: Andrew on: 2011-07-12 21:32:56 ⁋
...and here's a cleaner way to get the charset from the email:


$charset = $foundPart->getHeaderField('content-type', 'charset');
Posted by: Juan Calvo on: 2011-10-21 15:08:59 ⁋
Hello!
I need help, I'm changing php_imap by Zend_Mail, I used imap_search, but can not find how to do Zend_Mail remote.
Can anyone help me?
Thank you!
Posted by: Juan Calvo on: 2011-10-21 15:30:48 ⁋
Hola,
Agregué la funcion buscar with parameter criteria, en Zend_Mail_Storage_Imap Class.
Saludos!

public function Search($criteria){
if (!$this->_currentFolder) {
/**
* @see Zend_Mail_Storage_Exception
*/
require_once 'Zend/Mail/Storage/Exception.php';
throw new Zend_Mail_Storage_Exception('No selected folder to search');
}

return $this->_protocol->search(array($criteria));

}
Posted by: Michael on: 2011-11-04 17:01:50 ⁋
Using $message->from , it is only returning the name part of the from, not the from email address. How would I get this?

I tried using getHeaders() and in the array it is still [from]=>"Name" not [from]=>"EmailAddress@email.com"

Thank you.
Posted by: Riccardo Tempesta on: 2011-11-12 19:24:09 ⁋
Beware... don't do the same error as me:
If you just echo $message->from your HTML will display only the name because of the "<" and ">" encapsulating the mail address. Check your HTML source.
Posted by: nicl on: 2012-01-03 11:19:27 ⁋
Re: @Clay Hinson and @Duccio above:

even following the advice of Clay Hinson I still get 'the single id was not found in response' exceptions when attempting to loop through (and move) multiple emails.

I haven't worked out a solution yet (at least, one that uses the iterator approach) but perhaps I am doing something wrong?

One approach I have seen mentioned is to use 2 loops. The first to collect unique message IDs and the second to operate - based off the unique ids.

This is done here: http://www.devcha.com/2010/06/how-to-removemove-messages-using-zend.html

But I haven't managed to find much support on this issue - even after a lot of searching (and asking in irc - to no response alas).

+ Add A Comment

Please do not report issues via comments; use the ZF Issue Tracker.

If you have a JIRA/Crowd account, we suggest you login first before commenting.

  • BBCode is allowed in the comment markup

    • Select a Version

    Languages Available

    Components

    Search the Manual

    • Navigation