mo4islona/declination

Library for declination russian names.

0.0.1 2014-12-24 15:50 UTC

Requires

• php: >=5.3.0
• ext-json: *

Requires (Dev)

• phpunit/phpunit: 4.*

MIT

• Grigory Parshikov
• Evgeny Formanenko

• petrovich
• declination

README

Склонение падежей русских имён, фамилий и отчеств.

##Установка

Via composer

'require': {
    'mo4islona/declination': '*'
 }

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

require_once('./vendor/autoload.php');

use Declination\Declination;

$declination = new Declination(Declination::GENDER_MALE);

$firstName = 'Александр';
$patronymicName = 'Сергеевич';
$lastName = 'Пушкин';

echo Declination::detectGender('Петровна');	// female

// Родительный падеж:
echo $declination->firstName($firstName, Declination::CASE_GENITIVE); //	Александра
echo $declination->patronymicName($patronymicName, Declination::CASE_GENITIVE); //	Сергеевича
echo $declination->lastName($lastName, Declination::CASE_GENITIVE); //		Пушкина

Падежи

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

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

Пол

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

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