Глава 1. Установка и использование

Для нормальной работы библиотеки необходим PHP5 с установленным дополнением php_mbstring, так как библиотека работает с текстом в кодировке UTF-8.

Для работы библиотеки необходима вся папка Library. В ней находятся файлы NCL.NameCase.ru.php и NCL.NameCase.ua.php. В этих файлах содержатся правила для склонения на русском и украинском языках. В папке NCL находятся не менее важные файлы, назначение которых будет описано немного позже.

Для использования библиотеки нужно подключить украинский или русский файл. Как это работает можно посмотреть в файле Tutorial/lesson1.php.

<?php
header
('Content-type: text/html; charset=utf-8');

/**
 * Подключаем необходимый язык
 */
require '../Library/NCL.NameCase.ru.php';
/**
 * Создаем обьект класса. 
 * Теперь библиотека готова к работе 
 */
$nc = new NCLNameCaseRu();
/**
 * Производим склонения и выводим результат на экран
 */
print_r($nc->q("Андрей Николаевич"));

/**
 * Подключаем другой язык
 */
require '../Library/NCL.NameCase.ua.php';
/**
 * Создаем объект класса. 
 * Теперь библиотека готова к работе 
 */
$nc = new NCLNameCaseUa();
/**
 * Производим склонения и выводим результат на экран
 */
print_r($nc->q("Андрій Миколайович"));
?>

Открыв данную страницу, мы увидим на экране следующее:

Array
(
    [0] => Андрей Николаевич
    [1] => Андрея Николаевича
    [2] => Андрею Николаевичу
    [3] => Андрея Николаевича
    [4] => Андреем Николаевичем
    [5] => Андрее Николаевиче
)
Array
(
    [0] => Андрій Миколайович
    [1] => Андрія Миколайовича
    [2] => Андрієві Миколайовичу
    [3] => Андрія Миколайовича
    [4] => Андрієм Миколайовичем
    [5] => Андрієві Миколайовичу
    [6] => Андрію Миколайовичу
)

Метод q() вернул все падежи русского и украинского языков. О других возможных параметрах будет идтись в следующей главе.