Розділ 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() повернув всі відмінки російської та української мови. Про інші можливі параметри цього методу буде розповідатися в наступному розділі