slowprog/petrovich-php

An easy-to-use PHP Class to decline russian names.

1.0.3 2019-05-24 18:46 UTC

This package is auto-updated.

Last update: 2024-03-25 06:40:30 UTC


README

Petrovich

Склонение падежей русских имён, фамилий и отчеств. Портированная версия с Ruby на PHP плюс некоторый дополнительный функционал.

Лицензия MIT.

Установка

{
    "require": {
        "slowprog/petrovich-php": "^1.0",
        "cloudloyalty/petrovich-rules": "dev-master"
    }
}

Использование класса

require __DIR__.'./vendor/autoload.php';

$petrovich = new Petrovich();

$firstname  = "Александр";
$middlename = "Сергеевич";
$lastname   = "Пушкин";
$fullName   = 'Васильков Генадий Павлович';

echo $petrovich->detectGender("Петровна"); // Petrovich::GENDER_FEMALE (см. пункт Пол)

echo $petrovich->firstname($firstname, Petrovich::CASE_GENITIVE, Petrovich::GENDER_MALE); // Александра

echo $petrovich->middlename($middlename, Petrovich::CASE_GENITIVE, Petrovich::GENDER_MALE); // Сергеевича

echo $petrovich->lastname($lastname, Petrovich::CASE_GENITIVE, Petrovich::GENDER_MALE); // Пушкина

echo $mihalich->initial($fullName); // Васильков Г. П.

echo $mihalich->inflectFullName($fullName, Petrovich::CASE_GENITIVE); // Василькова Генадия Павловича

echo $mihalich->initial(
    $mihalich->inflectFullName(
        $fullName, 
        Petrovich::CASE_GENITIVE
    )
); // Василькова Г. П.

Падежи

Названия суффиксов для методов образованы от английских названий соответствующих падежей. Полный список поддерживаемых падежей приведён в таблице ниже.

Суффикс метода Падеж Характеризующий вопрос
CASE_NOMENATIVE именительный Кто? Что?
CASE_GENITIVE родительный Кого? Чего?
CASE_DATIVE дательный Кому? Чему?
CASE_ACCUSATIVE винительный Кого? Что?
CASE_INSTRUMENTAL творительный Кем? Чем?
CASE_PREPOSITIONAL предложный О ком? О чём?

Пол

Метод Petrovich::detectGender возвращает пол, на основе отчества. Возвращаемое значение не зависит от пола, переданного в конструктор. Для полов определены следующие константы

  • GENDER_ANDROGYNOUS - пол не определен;
  • GENDER_MALE - мужской пол;
  • GENDER_FEMALE - женский пол.