davidgorges / HumanNameParser.php

Returns the parts (leading initial, first, middle, last, suffix) of a name from a string.

---

Note: The 1.0 release requires PHP > 7.1.

Description

Fork from HumanNameParser.php origninally by Jason Priem [e-mail]. 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.
• Dr. 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
• last name (including compound ones like "van der Sar' and "Ortega y Gasset"), and
• suffix (like 'Jr.', 'III')
• title (like 'Dr.', 'Prof') new

How to use

use HumanNameParser\Parser;

$nameparser = new Parser();
$name = $nameparser->parse("Alfonso Ribeiro");

echo "Hello " . $name->getFirstName();