Mail_RFC822::parseAddressList()
Prev Next

Mail_RFC822::parseAddressList()

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

Synopsis

require_once 'Mail/RFC822.php';

array parseAddressList ( string $address = '' , string $defaultDomain = 'localhost' , boolean $nestGroups = = null , boolean $validate = = null )

Description

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

Parameter

  • string $address - les adresses à valider.

  • string $defaultDomain - le domaine par défaut si une adresse donnée sans.

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

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

Return value

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 @

Throws

Possible PEAR_Error values
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

This function can be called statically.

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

Example

Extrait des adresses

<?php
$adresse = 'Mon groupe: "Richard" <richard@localhost>;, [email protected] (un commentaire)';
$adresses = Mail_RFC822::parseAddressList($adresse, 'phpguru.org', TRUE);
var_export($adresses);
?>

Prev Mail Next
RFC822 - Introduction PEAR Manual Mail_IMAP