Manuel Pear

Mail_RFC822::parseAddressList()

Mail_RFC822::parseAddressList() -- Décompose les adresses emails d'une liste d'email

Synopsis

  1. <?php
  2. require_once 'Mail/RFC822.php
  3. ?> 

array parseAddressList ([chaîne de caractères $address = '', chaîne de caractères [$defaultDomain = 'localhost'] [, booléen $nestGroups = NULL [, booléen $validate = NULL]]])

Description

Décompose les adresses données en leurs parties.

Paramètres

  • chaîne de caractères $address - les adresses à valider.

  • chaîne de caractères $defaultDomain - le domaine par défaut si une adresse donnée sans.

  • booléen $nestGroups - indique si une structure avec les groupes imbriqués doit être retourneé pour une visualisation plus aisée.

  • booléen $validate - whether to validate atoms. Turn this off if you need to run addresses through before encoding the personal names, for instance.

Valeur retournée

array - un tableau imbriqué d'objets.

Si $nestGroups est à FALSE, vous pouvez passer au paragraphe suivant.

Chaque entrée du tableau contient un objet par groupe Chaque objet à deux attributs:

groupname - le nom du groupe
addresses - un tableau de toutes les adresses du groupe

Le tableau d'adresses consiste en un tableau d'objets anonymes pour chaque adresse. Ces objets comprennent les attributs suivants:

personal - le nom du propriétaire de l'adresse
comment - un tableau, une entree pour chaque commentaire par adresse
mailbox - le nom de la boite mail, la partie devant le @
host - le nom du serveur, parte après @

Valeurs renvoyées

Tableau 52-1. Valeurs PEAR_Error possibles

code message message cause solution
NULL every The given address string is not RFC822 compliant l'adresse fournie n'est pas conforme RFC822 Le code d'erreur contient la description de l'erreur.

Note

Cette fonction peut être appelée de façon statique.

Avertissement

Cette classe ne vérifie que la chaine. L'existence de l'adresse n'est pas vérifiée.

Exemple

Exemple 52-1. Extrait des adresses

  1. <?php
  2. $adresse = 'Mon groupe: "Richard" <richard@localhost>;, ted@exemple.com (un commentaire)';  
  3. $adresses = Mail_RFC822::parseAddressList($adresse, 'phpguru.org', TRUE);  
  4. var_export($adresses);  
  5.  
  6. ?> 

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique