rodrom / onomastica
Library for normalization of personal names
v0.2.1
2025-10-23 14:32 UTC
Requires
- php: >=8.3
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.89
- phpunit/phpunit: ^12.0
README
Lightweight, framework/agnostic PHP Library to normalize personal names following Spanish, Catalan, French and other languages conventions (apostrophes, connectors like
de,d’,del,y,i, etc.). Designed to be suitable for use in any PHP project.
Features
- Trim and collapse whitespace.
- Correct casing (taking into account multibyte characters.)
- Handle language-specific particles and connectors (
de,d’,del,y,von, etc.) - Normalize different apostrophe characters and fix spacing around them.
Installation
Require via Composer:
composer require rodrom/onomastica
Quick Usage
use Rodrom\Onomastica\NameNormalizer; echo NameNormalizer::normalize(' Ignacio DE loYOla '); // "Ignacio de Loyola" echo NameNormalizer::normalize('IÑIGO López DE OÑAZ Y Loyola'); // "Iñigo López de Oñaz y Loyola" echo NameNormalizer::normalize('María DE LAS Mercedes GARCÍA Y García'); // "José Antonio García y García" echo NameNormalizer::normalize("JAUME D'ARAGó-URGELL I MONTFERRAT"); // "Jaume d’Aragó-Urgell i Montferrat"
Changelog
License
Copyright © 2025 rodrom