rodrom/onomastica

Library for normalization of personal names

Maintainers

Package info

github.com/rodrom/onomastica

Documentation

pkg:composer/rodrom/onomastica

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.2.1 2025-10-23 14:32 UTC

This package is auto-updated.

Last update: 2026-03-23 15:30:47 UTC


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

Changelog

License

MIT License

Copyright © 2025 rodrom