naviocean / laravel-nameparser by naviocean

PHP library to split names into their respective components. Besides detecting first and last names, this library attempts to handle prefixes, suffixes, initials and compound last names like 'Von Fange'. It also normalizes prefixes (Mister -> Mr.) and fixes capitalization (JOHN SMITH -> John Smith).
5,450
1
1
Package Data
Maintainer Username: naviocean
Maintainer Contact: navi.ocean@outlook.com (NaviOcean)
Package Create Date: 2015-12-07
Package Last Update: 2015-12-07
Language: PHP
License: MIT
Last Refreshed: 2021-09-25 03:18:38
Package Statistics
Total Downloads: 5,450
Monthly Downloads: 4
Daily Downloads: 0
Total Stars: 1
Total Watchers: 1
Total Forks: 1
Total Open Issues: 0

PHP-Name-Parser For Laravel 5

PHP library to split names into their respective components. Besides detecting first and last names, this library attempts to handle prefixes, suffixes, initials and compound last names like "Von Fange". It also normalizes prefixes (Mister -> Mr.) and fixes capitalization (JOHN SMITH -> John Smith).

Usage: Enter command

"composer require naviocean/laravel-nameparser:dev-master"

Results:

Array (
	[nickname] =>
    [salutation] => Mr.
    [fname] => Anthony
    [initials] => R
    [lname] => Von Fange
    [suffix] => III
)

The algorithm:

We start by splitting the full name into separate words. We then do a dictionary lookup on the first and last words to see if they are a common prefix or suffix. Next, we take the middle portion of the string (everything minus the prefix & suffix) and look at everything except the last word of that string. We then loop through each of those words concatenating them together to make up the first name. While we’re doing that, we watch for any indication of a compound last name. It turns out that almost every compound last name starts with 1 of 16 prefixes (Von, Van, Vere, etc). If we see one of those prefixes, we break out of the first name loop and move on to concatenating the last name. We handle the capitalization issue by checking for camel-case before uppercasing the first letter of each word and lowercasing everything else. I wrote special cases for periods and dashes. We also have a couple other special cases, like ignoring words in parentheses all-together.

Check examples.php for the test suite and examples of how various name formats are parsed.

To-do

  • Handle the "Lname, Fname" format
  • Support non-English names (handle unicode characters & better understand global naming rules)
  • Separate the parsing of the name from the normalization & capitalization & make those optional.
  • Add common name libraries to allow for things like gender detection

Credits & license: