tck / human-name-parser

v0.1.6 2018-07-02 10:17 UTC

Requires

• php: ^7.1.3
• phpunit/phpunit: ~7.0

Unknown License

Published on Packagist.org on 2018-07-02 10:21 UTC

README

Forked from [https://github.com/jasonpriem/HumanNameParser.php]

Description

Takes human names of arbitrary complexity and various wacky formats like:

• J. Walter Weatherman
• de la Cruz, Ana M.
• James C. ('Jimmy') O'Dell, Jr.

and parses out the:

• leading initial (Like "J." in "J. Walter Weatherman")
• first name (or first initial in a name like 'R. Crumb')
• nicknames (like "Jimmy" in "James C. ('Jimmy') O'Dell, Jr.")
• middle names
• surname (including compound ones like "van der Sar' and "Ortega y Gasset"), and
• suffix (like 'Jr.', 'III')

Example Usage

$parser = new Tck\HumanNameParser\Parser("John Q. Smith");
echo  $parser->surname() . ", " . $parser->firstName();
// returns "Smith, John"