PHPackages rmitvn/oodle-email-parse - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. rmitvn/oodle-email-parse ActiveLibrary[Mail & Notifications](/categories/mail) rmitvn/oodle-email-parse ======================== email-parse a (reasonably) RFC822 / RF2822-compliant library for parsing multiple (and single) email addresses 1.0.0(12y ago)04.7kTBDPHPPHP >=5.3.17 Since Mar 10Pushed 12y ago1 watchersCompare [ Source](https://github.com/rmitvn/oodle-email-parse)[ Packagist](https://packagist.org/packages/rmitvn/oodle-email-parse)[ RSS](/packages/rmitvn-oodle-email-parse/feed)WikiDiscussions master Synced 3d ago READMEChangelog (1)Dependencies (4)Versions (2)Used By (0) email-parse =========== [](#email-parse) Email\\Parse is a multiple (and single) email address parser that is reasonably RFC822 / RFC2822 compliant. It parses a list of 1 to n email addresses separated by space or comma Installation: ------------- [](#installation) Add this line to your composer.json "require" section: ### composer.json [](#composerjson) ``` "require": { ... "oodle/email-parse": "*" ``` Usage: ------ [](#usage) ``` use Email\Parse; $result = Parse::getInstance()->parse("a@aaa.com b@bbb.com"); ``` Notes: ====== [](#notes) This should be RFC 2822 compliant, although it will let a few obsolete RFC 822 addresses through such as test"test" (note the quoted string in the middle of the address, which may be obsolete as of RFC 2822). However it wont allow escaping outside of quotes such as test@. This would have to be written as "test@test"@xyz.com Here are a few other examples: ``` "John Q. Public" this.is.an.address@xyz.com how-about-an-ip@[10.0.10.2] how-about-comments(this is a comment!!)@xyz.com ``` \####Function Spec#### ``` /** * function parse($emails, $multiple = true, $encoding = 'UTF-8') * @param string $emails List of Email addresses separated by comma or space if multiple * @param bool $multiple (optional, default: true) Whether to parse for multiple email addresses or not * @param string $encoding (optional, default: 'UTF-8')The encoding if not 'UTF-8' * @return: see below: */ if ($multiple): array('success' => boolean, // whether totally successful or not 'reason' => string, // if unsuccessful, the reason why 'email_addresses' => array('address' => string, // the full address (not including comments) 'original_address' => string, // the full address including comments 'simple_address' => string, // simply local_part@domain_part (e.g. someone@oodle.com) 'name' => string, // the name on the email if given (e.g.: John Q. Public), including any quotes 'name_parsed' => string, // the name on the email if given (e.g.: John Q. Public), excluding any quotes 'local_part' => string, // the local part (before the '@' sign - e.g. johnpublic) 'local_part_parsed' => string, // the local part (before the '@' sign - e.g. johnpublic), excluding any quotes 'domain' => string, // the domain after the '@' if given 'ip' => string, // the IP after the '@' if given 'domain_part' => string, // either domain or IP depending on what given 'invalid' => boolean, // if the email is valid or not 'invalid_reason' => string), // if the email is invalid, the reason why array( .... ) // the next email address matched ) else: array('address' => string, // the full address including comments 'name' => string, // the name on the email if given (e.g.: John Q. Public) 'local_part' => string, // the local part (before the '@' sign - e.g. johnpublic) 'domain' => string, // the domain after the '@' if given 'ip' => string, // the IP after the '@' if given 'invalid' => boolean, // if the email is valid or not 'invalid_reason' => string) // if the email is invalid, the reason why endif; ``` Other Examples: --------------- [](#other-examples) ``` $email = "\"J Doe\" "; $result = Email\Parse->getInstance()->parse($email, false); $result == array('address' => '"JD" ', 'original_address' => '"JD" ', 'name' => '"JD"', 'name_parsed' => 'J Doe', 'local_part' => 'johndoe', 'local_part_parsed' => 'johndoe', 'domain_part' => 'xyz.com', 'domain' => 'xyz.com', 'ip' => '', 'invalid' => false, 'invalid_reason' => ''); $emails = "testing@[10.0.10.45] testing@xyz.com, testing-"test...2"@xyz.com (comment)"; $result = Email\Parse->getInstance()->parse($emails); $result == array( 'success' => boolean true 'reason' => null 'email_addresses' => array( array( 'address' => 'testing@[10.0.10.45]', 'original_address' => 'testing@[10.0.10.45]', 'name' => '', 'name_parsed' => '', 'local_part' => 'testing', 'local_part_parsed' => 'testing', 'domain_part' => '10.0.10.45', 'domain' => '', 'ip' => '10.0.10.45', 'invalid' => false, 'invalid_reason' => ''), array( 'address' => 'testing@xyz.com', 'original_address' => 'testing@xyz.com', 'name' => '', 'name_parsed' => '', 'local_part' => 'testing', 'local_part' => 'testing', 'domain_part' => 'xyz.com', 'domain' => 'xyz.com', 'ip' => '', 'invalid' => false, 'invalid_reason' => '') array( 'address' => '"testing-test...2"@xyz.com', 'original_address' => 'testing-"test...2"@xyz.com (comment)', 'name' => '', 'name_parsed' => '', 'local_part' => '"testing-test2"', 'local_part_parsed' => 'testing-test...2', 'domain_part' => 'xyz.com', 'domain' => 'xyz.com', 'ip' => '', 'invalid' => false, 'invalid_reason' => '') ) ); ``` ### Health Score 29 — LowBetter than 59% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community9 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 87.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 4449d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7682e48422f01096d36798ebb35346b78742ad54ace87e869bc9c2b0561f4b1a?d=identicon)[rmitvn](/maintainers/rmitvn) --- Top Contributors [![mmucklo](https://avatars.githubusercontent.com/u/245122?v=4)](https://github.com/mmucklo "mmucklo (7 commits)")[![rmitvn](https://avatars.githubusercontent.com/u/6902887?v=4)](https://github.com/rmitvn "rmitvn (1 commits)") --- Tags emailparseRFC822RFC2822email-parse ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/rmitvn-oodle-email-parse/health.svg) ``` [![Health](https://phpackages.com/badges/rmitvn-oodle-email-parse/health.svg)](https://phpackages.com/packages/rmitvn-oodle-email-parse) ``` ### Alternatives [mmucklo/email-parse email-parse a (reasonably) RFC822 / RF2822-compliant library for batch parsing multiple (and single) email addresses 46837.3k2](/packages/mmucklo-email-parse)[zbateson/mail-mime-parser MIME email message parser 53949.2M79](/packages/zbateson-mail-mime-parser)[omnimail/omnimail PHP Library to send email across all platforms using one interface. 32934.3k](/packages/omnimail-omnimail)[vaibhavpandeyvpz/phemail A pure PHP MIME parser for parsing raw email files (.eml) with full support for multipart messages, nested structures, and RFC 2046 compliance. 33121.7k1](/packages/vaibhavpandeyvpz-phemail)[thefox/smtpd SMTP server (library) written in pure PHP. 1302.4k1](/packages/thefox-smtpd)[mtymek/mt-mail Zend Framework e-mail module. Using this library can easily create e-mail messages from PHTML templates (with optional layouts) and send them using configurable transports. Pluggable, EventManager-driven architecture allows you to customize every aspect of the process. 1839.2k3](/packages/mtymek-mt-mail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)