imap_rfc822_parse_adrlist

(PHP 4, PHP 5)

imap_rfc822_parse_adrlist — 주소 문자열을 해석한다

Description

array imap_rfc822_parse_adrlist ( string $address , string $default_host )

이 함수는 » RFC822문서에 정의된대로 각 주소에 대해 주소 문자열을 해석하고 객체의 문자열을 돌려준다. 객체의 속성은 다음과 같다:

mailbox - the mailbox name (username)
host - the host name
personal - the personal name
adl - at domain source route

Example#1 imap_rfc822_parse_adrlist() example


$address_string = "Hartmut Holzgraefe <hartmut@cvs.php.net>, postmaster@somedomain.net, root";
$address_array  = imap_rfc822_parse_adrlist($address_string,"somedomain.net");
if(! is_array($address_array)) die("somethings wrong\n");
 
reset($address_array);
while(list($key,$val)=each($address_array)){
  print "mailbox : ".$val->mailbox."<br>\n";
  print "host    : ".$val->host."<br>\n";
  print "personal: ".$val->personal."<br>\n";
  print "adl     : ".$val->adl."<p>\n";
}

add a note User Contributed Notes
imap_rfc822_parse_adrlist

Ian Eiloart
17-Oct-2005 06:50


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.';

  },

)

Rainer Perske
04-Jan-2005 08:20


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

imap_rfc822_parse_headers

imap_reopen

Last updated: Sun, 25 Nov 2007