array parseAddressList (
string $address = ''
,
string $defaultDomain = 'localhost'
,
boolean $nestGroups
= = null
,
boolean $validate
= = null
)
指定したアドレスを各部分に展開します。
string $address -
検証するアドレス。
string $defaultDomain -
指定されたアドレスでドメインが指定されていない場合に使用する、
デフォルトのドメイン。
boolean $nestGroups -
結果を入れ子構造の見やすい形式で返すかどうか。
boolean $validate -
atom の検証を行うかどうか。
例えば、名前をエンコードする前にアドレスの検証をしたい場合などにこれを
Off にします。
array -
入れ子状の配列、あるいは無名オブジェクトの配列を返します。
$nestGroups が FALSE の場合は、
次の段落を読み飛ばしてください。
配列のエントリはグループ単位のオブジェクトとなっています。 このオブジェクトは二つの属性を持っています。
groupname -
グループの名前。
addresses -
グループ内のすべてのアドレスの配列。
配列 addresses は、
各アドレスを表す無名オブジェクトの配列です。
このオブジェクトは次の属性を持っています。
personal -
アドレスの所有者名。
comment -
アドレスについてのコメントを保持する配列。
mailbox -
メールボックスの名前。@ の前の部分。
host -
サーバの名前。@ の後の部分。
| エラーコード | エラーメッセージ | 原因 | 対応 |
|---|---|---|---|
| NULL | すべて | 指定した文字列は RFC822 に準拠していません。 | エラーの内容がエラーコードに含まれます。 |
This function can be called statically.
このクラスがチェックするのは文字列だけです。 そのアドレスが実際に存在するかどうかはチェックしません。
アドレスの展開
<?php
$address = 'My group: "Richard" <richard@localhost>;, [email protected] (A comment)';
$addresses = Mail_RFC822::parseAddressList($address, 'phpguru.org', TRUE);
print_r($addresses);
?>