davidgorges/human-name-parser

Parses a human name

1.0.0 2019-03-10 15:43 UTC

Requires

• php: >=7.1

Requires (Dev)

• phpstan/phpstan-shim: ^0.11.2
• phpunit/phpunit: 7.*

MIT

• David Gorges
• Jason Priem

README

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();