PHPackages                             medcore-ua/ukrainian-anthroponyms - 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. medcore-ua/ukrainian-anthroponyms

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

medcore-ua/ukrainian-anthroponyms
=================================

A PHP library for declension of Ukrainian anthroponyms in all 7 grammatical cases, with automatic gender detection.

00PHPCI passing

Since May 3Pushed 1mo agoCompare

[ Source](https://github.com/medcore-ua/ukrainian-anthroponyms)[ Packagist](https://packagist.org/packages/medcore-ua/ukrainian-anthroponyms)[ RSS](/packages/medcore-ua-ukrainian-anthroponyms/feed)WikiDiscussions main Synced 4w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Ukrainian Anthroponyms PHP
==========================

[](#ukrainian-anthroponyms-php)

[![Latest Stable Version](https://camo.githubusercontent.com/3887de89f782f100cb1f3a1ab83caedfff15a243779ac6b5e5b1765966d55a4e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6564636f72652d75612f756b7261696e69616e2d616e7468726f706f6e796d732e7376673f6c6162656c3d5061636b6167697374266c6f676f3d7061636b6167697374)](https://packagist.org/packages/medcore-ua/ukrainian-anthroponyms)[![Total Downloads](https://camo.githubusercontent.com/a06f6993db34d9730d7b29b57b5072aa96a6153affa5fa74a9cdfbc38876da81/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6564636f72652d75612f756b7261696e69616e2d616e7468726f706f6e796d732e7376673f6c6162656c3d446f776e6c6f616473266c6f676f3d7061636b6167697374)](https://packagist.org/packages/medcore-ua/ukrainian-anthroponyms)[![License](https://camo.githubusercontent.com/a0f7b74889905c1b2cdf04053e42c44a292ec8a7cb6faab41973d38a9e85087a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d6564636f72652d75612f756b7261696e69616e2d616e7468726f706f6e796d732e7376673f6c6162656c3d4c6963656e6365266c6f676f3d6f70656e2d736f757263652d696e6974696174697665)](https://packagist.org/packages/medcore-ua/ukrainian-anthroponyms)

A PHP library for declension of Ukrainian anthroponyms (names, patronymics, and surnames) in all 7 grammatical cases. This is a PHP port of the original JavaScript library [shevchenko-js](https://github.com/tooleks/shevchenko-js).

Features
--------

[](#features)

- **Grammatical Cases**: Supports all 7 Ukrainian grammatical cases (nominative, genitive, dative, accusative, ablative, locative, vocative).
- **Gender Detection**: Automatic gender detection based on given name and patronymic endings.
- **Multiple Name Types**: Handles given names, patronymics, and family names.
- **Ukrainian Rules**: Built-in declension rules for Ukrainian language patterns.
- **PSR-16 Compatible**: Follows PHP-FIG standards for interoperability.

Installation
------------

[](#installation)

To install the Ukrainian Anthroponyms library, run the following command in your terminal:

```
composer require medcore-ua/ukrainian-anthroponyms
```

Usage
-----

[](#usage)

### Basic Setup

[](#basic-setup)

```
use MedCore\UkrainianAnthroponyms\Inflector;
use MedCore\UkrainianAnthroponyms\Contracts\DeclensionInput;
use MedCore\UkrainianAnthroponyms\Language\GrammaticalGender;

$inflector = new Inflector();
```

### Declension in Vocative Case

[](#declension-in-vocative-case)

```
$input = new DeclensionInput(
    GrammaticalGender::MASCULINE,
    'Тарас',
    'Григорович',
    'Шевченко'
);

$result = $inflector->inVocative($input);

echo $result->givenName;      // Тарасе
echo $result->patronymicName; // Григоровичу
echo $result->familyName;     // Шевченку
```

### Declension in All Cases

[](#declension-in-all-cases)

```
$input = new DeclensionInput(
    GrammaticalGender::MASCULINE,
    'Олександр',
    'Сергійович',
    'Коваленко'
);

echo $inflector->inNominative($input)->givenName; // Олександр
echo $inflector->inGenitive($input)->givenName;   // Олександра
echo $inflector->inDative($input)->givenName;     // Олександру
echo $inflector->inAccusative($input)->givenName; // Олександра
echo $inflector->inAblative($input)->givenName;   // Олександром
echo $inflector->inLocative($input)->givenName;   // Олександрові
echo $inflector->inVocative($input)->givenName;   // Олександре
```

### Automatic Gender Detection

[](#automatic-gender-detection)

```
$input = new DeclensionInput(
    GrammaticalGender::MASCULINE, // Default gender
    'Тарас',
    null,
    null
);

$detectedGender = $inflector->detectGender($input);
echo $detectedGender->value; // masculine
```

Contributing
------------

[](#contributing)

Contributions are welcome and appreciated! Here's how you can contribute:

1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

Please make sure to update tests as appropriate and adhere to the existing coding style.

License
-------

[](#license)

This library is licensed under the CSSM Unlimited License v2.0 (CSSM-ULv2). See the [LICENSE](LICENSE) file for details.

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance58

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/e2471bdadcf4a5ea969fe763a72d03fb46525b59a7e4cedc3ed4d855029e7785?d=identicon)[ChernegaSergiy](/maintainers/ChernegaSergiy)

---

Top Contributors

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

---

Tags

anthroponymsdeclensiongrammarlinguisticsname-processingnamesphpphp-libraryphp8ukraineukrainian

### Embed Badge

![Health badge](/badges/medcore-ua-ukrainian-anthroponyms/health.svg)

```
[![Health](https://phpackages.com/badges/medcore-ua-ukrainian-anthroponyms/health.svg)](https://phpackages.com/packages/medcore-ua-ukrainian-anthroponyms)
```

###  Alternatives

[riari/laravel-forum

A Laravel package providing a solid foundation for building discussion forums

65598.7k3](/packages/riari-laravel-forum)[coderello/laraflash

Advanced flash messages for Laravel.

15737.2k1](/packages/coderello-laraflash)

PHPackages © 2026

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