PHPackages                             phabloraylan/human-name-parser - 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. [Utility & Helpers](/categories/utility)
4. /
5. phabloraylan/human-name-parser

ActiveLibrary[Utility & Helpers](/categories/utility)

phabloraylan/human-name-parser
==============================

Parses a human name

1.0.0(6y ago)081MITPHPPHP >=7.1

Since Aug 15Pushed 6y ago1 watchersCompare

[ Source](https://github.com/phabloraylan/human-name-parser)[ Packagist](https://packagist.org/packages/phabloraylan/human-name-parser)[ RSS](/packages/phabloraylan-human-name-parser/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

*Note*: The 1.0 release requires PHP > 7.1.

Description
===========

[](#description)

Fork from HumanNameParser.php origninally by Jason Priem  and @davidgorges. 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
==========

[](#how-to-use)

Composer
--------

[](#composer)

```
composer require phabloraylan/human-name-parser
```

Example
-------

[](#example)

```
use HumanNameParser\Parser;

try {

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

	echo "Hello " . $name->getFirstName();
	echo "Hello " . $name->getLeadingInitial();
	echo "Hello " . $name->getFirstName();
	echo "Hello " . $name->getNickNames();
	echo "Hello " . $name->getMiddleName();
	echo "Hello " . $name->getLastName();
	echo "Hello " . $name->getSuffix();

} catch(HumanNameParser\Exception\FirstNameNotFoundException $e) {
	// catch body
} catch(HumanNameParser\Exception\LastNameNotFoundException $e) {
	// catch body
}
```

Tests
-----

[](#tests)

```
composer test
```

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

2459d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6d083bcdbf5d842afa893f765778378c29ac15c0b9cc829fc7cd66bdf763aa1e?d=identicon)[phabloraylan](/maintainers/phabloraylan)

---

Top Contributors

[![phabloraylan](https://avatars.githubusercontent.com/u/21280189?v=4)](https://github.com/phabloraylan "phabloraylan (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/phabloraylan-human-name-parser/health.svg)

```
[![Health](https://phpackages.com/badges/phabloraylan-human-name-parser/health.svg)](https://phpackages.com/packages/phabloraylan-human-name-parser)
```

###  Alternatives

[ozdemir/datatables

Simplify your Datatables server-side processing effortlessly using our lightning-fast PHP library, streamlining your workflow seamlessly.

273158.4k](/packages/ozdemir-datatables)[that0n3guy/transliteration

Transliteration provides one-way string transliteration (romanization) and cleans text by replacing unwanted characters.

1296.5k4](/packages/that0n3guy-transliteration)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)