imap_rfc822_parse_adrlist

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_rfc822_parse_adrlist — Analyse une adresse email

Description

imap_rfc822_parse_adrlist(string $string, string $default_hostname): array

Analyse la chaîne address, tel que définie dans la » RFC2822.

Liste de paramètres

string: Une chaîne de caractères contenant les adresses
default_hostname: Le nom de l'hôte par défaut

Valeurs de retour

Retourne un tableau d'objets. Les propriétés des objets sont :

"mailbox" : Le nom de la boîte aux lettres (nom d'utilisateur)
"host" : Le nom de l'hôte
"personal" : Le nom personnel
"adl" : at domain source route (NDT : ???)

Exemples

Exemple #1 Exemple avec imap_rfc822_parse_adrlist()

<?php

$address_string = "Joe Doe <doe@example.com>, postmaster@example.com, root";
$address_array  = imap_rfc822_parse_adrlist($address_string, "example.com");
if (!is_array($address_array) || count($address_array) < 1) {
    die("Erreur !\n");
}

foreach ($address_array as $id => $val) {
    echo "# $id\n";
    echo "  Boîte   : " . $val->mailbox . "\n";
    echo "  Hôte    : " . $val->host . "\n";
    echo "  Nom    : " . $val->personal . "\n";
    echo "  adl      : " . $val->adl . "\n";
}
?>

L'exemple ci-dessus va afficher :

# 0
  Boîte   : doe
  Hôte    : example.com
  Nom    : Joe Doe
  adl      :
# 1
  Boîte   : postmaster
  hôte    : example.com
  Nom    :
  adl      :
# 2
  Boîte   : root
  Hôte    : example.com
  Nom    :
  adl      :

Voir aussi

imap_rfc822_parse_headers() - Analyse un en-tête mail

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

Ian Eiloart ¶

19 years ago

This function does NOT test the syntax of either the local part, or the host part, it will permit illegal characters on either side. 

Note that 'host' refers to the email domain, not actually to any host.

The at domain list is an obsolete addressing method which was available for routing email. RFC2822 says that it must be accepted, but should be ignored in routing.

Note that if an address doesn't contain a personal part, or an "at domain list", that part of the array will be missing.

Although RFC2822 permits consecutive comma separators in a list of email addresses, this function does not. That's probably a bug.

In the following list of examples, #4 uses an "at domain list",  #5 and after are illegal domains, but only the last actually generates an error.

$adds = 'ian eiloart <iane@example.ac.uk>, 
        shuf6@example.ac.uk, 
        blobby, 
        "ian,eiloart"<ian@example.ac.uk>,
        <@example.com:foo@example.ac.uk>,
        foo@#,
        ian@-example.com,
        ian@one@two';
$add_arr = imap_rfc822_parse_adrlist($adds, 'example.com');
var_export ($add_arr);

array (
  0 => 
  class stdClass {
    var $mailbox = 'iane';
    var $host = 'example.ac.uk';
    var $personal = 'ian eiloart';
  },
  1 => 
  class stdClass {
    var $mailbox = 'shuf6';
    var $host = 'example.ac.uk';
  },
  2 => 
  class stdClass {
    var $mailbox = 'blobby';
    var $host = 'example.ac.uk';
  },
  3 => 
  class stdClass {
    var $mailbox = 'ian';
    var $host = 'example.ac.uk';
    var $personal = 'ian,eiloart';
  },
  4 => 
  class stdClass {
    var $mailbox = 'foo';
    var $host = 'example.ac.uk';
    var $adl = '@example.com';
  },
  5 => 
  class stdClass {
    var $mailbox = 'foo';
    var $host = '#';
  },
  6 => 
  class stdClass {
    var $mailbox = 'ian';
    var $host = '-example.com';
  },
  7 => 
  class stdClass {
    var $mailbox = 'ian';
    var $host = 'one';
  },
  8 => 
  class stdClass {
    var $mailbox = 'UNEXPECTED_DATA_AFTER_ADDRESS';
    var $host = '.SYNTAX-ERROR.';
  },
)

down

Rainer Perske ¶

19 years ago

Invalid addresses, if detected, set host to '.SYNTAX-ERROR.'; but not all invalid addresses get detected as such, e.g. <.@host.do.main> is considered
valid though a single dot is not a valid local part without using quotation marks.

＋add a note