Склонение падежей русских имён, фамилий и отчеств.
Портированная версия с Ruby на PHP
Лицензия MIT
https://github.com/parshikov/petrovich-php-example
##Установка
Для работы требуется PHP >= 5.3
Загрузите файлы в папку с библиотеками на сервере.
cd lib
git clone https://github.com/petrovich/petrovich-php.git petrovich-phpесли вы хотите использовать petrovich как submodule,
git submodule add --init https://github.com/petrovich/petrovich-php.git lib/petrovich-phpили просто скачайте исходный код со страницы проекта на Github.
##Использование
В библиотеку входит класс Petrovich и trait Trait_Petrovich
mb_internal_encoding('UTF-8');
require_once('path-to-lib/petrovich-php/Petrovich.php');
$petrovich = new Petrovich(Petrovich::GENDER_MALE);
$firstname = "Александр";
$middlename = "Сергеевич";
$lastname = "Пушкин";
echo $petrovich->detectGender("Петровна"); // Petrovich::GENDER_FEMALE (см. пункт Пол)
echo '<br /><strong>Родительный падеж:</strong><br />';
echo $petrovich->firstname($firstname, Petrovich::CASE_GENITIVE).'<br />'; // Александра
echo $petrovich->middlename($middlename, Petrovich::CASE_GENITIVE).'<br />'; // Сергеевича
echo $petrovich->lastname($lastname, Petrovich::CASE_GENITIVE).'<br />'; // ПушкинаTrait содержит в себе
- Свойства
firstnamemiddlenamelastnamegender
- Методы
firstname($case)middlename($case)lastname($case)
mb_internal_encoding('UTF-8');
require_once('path-to-lib/petrovich-php/Petrovich.php');
require_once('path-to-lib/petrovich-php/Trait/Petrovich.php');
class User {
use Trait_Petrovich;
}
$user = new User();
$user->lastname = "Пушкин";
$user->firstname = "Александр";
$user->middlename = "Сергеевич";
$user->firstname(Petrovich::CASE_GENITIVE); // Пушкина
$user->lastname(Petrovich::CASE_GENITIVE); // Александра
$user->middlename(Petrovich::CASE_GENITIVE); // СергеевичаНазвания суффиксов для методов образованы от английских названий соответствующих падежей. Полный список поддерживаемых падежей приведён в таблице ниже.
| Суффикс метода | Падеж | Характеризующий вопрос |
|---|---|---|
| CASE_NOMENATIVE | именительный | Кто? Что? |
| CASE_GENITIVE | родительный | Кого? Чего? |
| CASE_DATIVE | дательный | Кому? Чему? |
| CASE_ACCUSATIVE | винительный | Кого? Что? |
| CASE_INSTRUMENTAL | творительный | Кем? Чем? |
| CASE_PREPOSITIONAL | предложный | О ком? О чём? |
Метод Petrovich::detectGender возвращает пол, на основе отчества. Возвращаемое значение не зависит от пола, переданного в конструктор.
Для полов определены следующие константы
- GENDER_ANDROGYNOUS - пол не определен;
- GENDER_MALE - мужской пол;
- GENDER_FEMALE - женский пол.