slowprog / petrovich-php
An easy-to-use PHP Class to decline russian names.
1.0.3
2019-05-24 18:46 UTC
Requires
- php: >=5.3
- ext-json: *
- ext-mbstring: *
- cloudloyalty/petrovich-rules: dev-master
This package is auto-updated.
Last update: 2024-03-25 06:40:30 UTC
README
Склонение падежей русских имён, фамилий и отчеств. Портированная версия с 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 - женский пол.