PHPackages                             bokhanmax/namecaselib2 - 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. bokhanmax/namecaselib2

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

bokhanmax/namecaselib2
======================

Laravel-ready fork of seagullua/NameCaseLib — PHP library for inflecting Russian and Ukrainian full names

v1.0.3(1mo ago)07↓60%MITPHPPHP ^8.0

Since Jun 10Pushed 1mo agoCompare

[ Source](https://github.com/BokhanMax/namecaselib2)[ Packagist](https://packagist.org/packages/bokhanmax/namecaselib2)[ RSS](/packages/bokhanmax-namecaselib2/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (6)Versions (5)Used By (0)

NameCaseLib2
============

[](#namecaselib2)

**NameCaseLib2** — Laravel-пакет для автоматичного відмінювання ПІБ (прізвище, ім'я, по-батькові) у російській та українській мовах.

Це адаптована для PHP 8.x та Laravel версія бібліотеки [NameCaseLib](https://github.com/seagullua/NameCaseLib), оригінально написаної Андрієм Чайкою.

Встановлення
------------

[](#встановлення)

```
composer require bokhanmax/namecaselib2
```

Публікація конфігу (опціонально):

```
php artisan vendor:publish --tag=namecaselib-config
```

Конфігурація
------------

[](#конфігурація)

Файл `config/namecaselib.php`:

```
return [
    'locale'  => 'ua',   // 'ua' — українська, 'ru' — російська
    'charset' => 'utf-8',
];
```

Інструкція
----------

[](#інструкція)

### Константи падежів

[](#константи-падежів)

```
use NameCaseLib2\NCL;

NCL::$IMENITLN  // 0 — Називний:    Іваненко Іван  (Хто?)
NCL::$RODITLN   // 1 — Родовий:     Іваненка Івана (Кого?)
NCL::$DATELN    // 2 — Давальний:   Іваненку Івану (Кому?)
NCL::$VINITELN  // 3 — Знахідний:   Іваненка Івана (Кого?)
NCL::$TVORITELN // 4 — Орудний:     Іваненком Іваном (Ким?)
NCL::$PREDLOGN  // 5 — Місцевий:    Іваненку Івану (Про кого?)

// Лише для української мови:
NCL::$UaKlychnyi // 6 — Кличний: Іване!
```

### Методи

[](#методи)

```
use NameCaseLib2\Laravel\Facades\NameCase;
use NameCaseLib2\NCL;

// Усе ПІБ одразу (найзручніший спосіб):
NameCase::q('Іваненко Іван Іванович', NCL::$RODITLN, NCL::$MAN);
// → "Іваненка Івана Івановича"

// Тільки ім'я:
NameCase::qFirstName('Іван', NCL::$TVORITELN);

// Тільки прізвище:
NameCase::qSecondName('Іваненко', NCL::$RODITLN, NCL::$MAN);

// Тільки по-батькові:
NameCase::qFatherName('Іванович', NCL::$DATELN, NCL::$MAN);

// Флюент-стиль:
NameCase::setSecondName('Іваненко')
        ->setFirstName('Іван')
        ->setFatherName('Іванович')
        ->setGender(NCL::$MAN)
        ->getFormatted(NCL::$PREDLOGN);
// → "Іваненку Івану Івановичу"

// Змінити порядок виводу (S=прізвище, N=ім'я, F=по-батькові):
NameCase::setSecondName('Іваненко')
        ->setFirstName('Іван')
        ->setGender(NCL::$MAN)
        ->getFormatted(NCL::$DATELN, 'N S');
// → "Івану Іваненку"
```

### Визначення статі

[](#визначення-статі)

```
// З рядка ПІБ — повертає NCL::$MAN (1) або NCL::$WOMAN (2):
$gender = NameCase::genderDetect('Іваненко Іван Іванович');  // → 1
$gender = NameCase::genderDetect('Іваненко Олена Петрівна'); // → 2

if ($gender === NCL::$MAN) {
    echo 'чоловік';
} elseif ($gender === NCL::$WOMAN) {
    echo 'жінка';
}

// Флюент-стиль — якщо слова вже встановлені:
$gender = NameCase::setFirstName('Олена')
                  ->setSecondName('Петренко')
                  ->genderAutoDetect(); // → 2
```

**Надійність визначення:**

- По-батькові → ~100%
- Ім'я + прізвище → ~100%
- Тільки ім'я → ~98.5%
- Тільки прізвище → ~96%

Історія версій
--------------

[](#історія-версій)

### 1.0.0 (2026-06-10)

[](#100-2026-06-10)

- Адаптація для PHP 8.x та Laravel
- Додано неймспейси, ServiceProvider, Facade, конфіг
- Виправлено сумісність з PHP 8.4
- Адаптовано тести
- Пакет протестовано на Laravel

### 0.4.1 (2016-11-23) — оригінальна бібліотека

[](#041-2016-11-23--оригінальна-бібліотека)

- Rules updates (5 years of work)

### 0.4 (2011-07-09)

[](#04-2011-07-09)

- Повна переробка коду
- Підтримка різних регістрів слів

### 0.3 (2011-07-02)

[](#03-2011-07-02)

- Кличний відмінок для української

### 0.1.0 (2011-05-01)

[](#010-2011-05-01)

- Перша версія бібліотеки

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance93

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

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

Every ~4 days

Total

4

Last Release

33d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11696527?v=4)[Max Bokhan](/maintainers/BokhanMax)[@BokhanMax](https://github.com/BokhanMax)

---

Top Contributors

[![Rabotyahoff](https://avatars.githubusercontent.com/u/1113031?v=4)](https://github.com/Rabotyahoff "Rabotyahoff (19 commits)")[![BokhanMax](https://avatars.githubusercontent.com/u/11696527?v=4)](https://github.com/BokhanMax "BokhanMax (7 commits)")

---

Tags

anthroponym-declensiondeclensionfamily-name-declensionfirst-name-declensiongiven-name-declensioninflectionlaravellinguisticsnamecaselibnlppatronymic-declensionpatronymic-name-declensionpersonal-name-declensionphpstandwithukrainesurname-declensionukraineukrainianword-declensionword-inflectionphplaravelinflectionnlpdeclensionnamecaseukrainianNameCaseLiblinguisticsukrainestandwithukraineanthroponym-declensionpersonal-name-declensiongiven-name-declensionfirst-name-declensionpatronymic-name-declensionpatronymic-declensionfamily-name-declensionsurname-declensionword-declensionword-inflectionnamecaselib2

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bokhanmax-namecaselib2/health.svg)

```
[![Health](https://phpackages.com/badges/bokhanmax-namecaselib2/health.svg)](https://phpackages.com/packages/bokhanmax-namecaselib2)
```

###  Alternatives

[heureka/inflection

Czech inflection library

6368.6k](/packages/heureka-inflection)[mikulas/inflection

Czech inflection library

2960.1k](/packages/mikulas-inflection)[amranidev/laracombee

Recommendation system for laravel

11538.8k1](/packages/amranidev-laracombee)[yieldstudio/tailwind-merge-php

Merge Tailwind CSS classes without style conflicts

4975.4k1](/packages/yieldstudio-tailwind-merge-php)[wujunze/money-wrapper

MoneyPHP Wrapper

103.8k](/packages/wujunze-money-wrapper)

PHPackages © 2026

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