59 lines
6.5 KiB
Markdown
59 lines
6.5 KiB
Markdown
# Каскадная файловая система
|
||
|
||
Файловая система Kohana представляет собой иерархическая структура каталогов. Когда файл загружается, используя [Kohana::find_file], он ищется в каталогах в следующем порядке:
|
||
|
||
Application путь
|
||
: Определён как `APPPATH` в `index.php`. Значение по-умолчанию - `application`.
|
||
|
||
Module путь
|
||
: Определён как ассоциативный массив [Kohana::modules] в `APPPATH/bootstrap.php`. Поиск каждого значение массива будет произведён в том порядке, в каком порядке они определены.
|
||
|
||
System путь
|
||
: Определён как `SYSPATH` в `index.php`. Значение по-умолчанию - `system`. Все основные или "core" файлы и классы располагаются в этой категории.
|
||
|
||
Файлы, находящиеся в каталогах выше уровнем, имеют приоритет над файлами, которые располагаются в таких же папках уровнем ниже, что позволяет перегружать любой файл, путём перемещения файла с таким же названием на уровень выше:
|
||
|
||
|
||
|
||
Если у Вас имеется файл представления с названием `wellcome.php`, расположенный в `APPPATH/views` и `SYSPATH/views`, то при поиске файла с этим именем будет возвращен тот, который находится в папке `APPPATH/views` (как находящийся на высшем уровне иерархической системы). Если же удалить файл в каталоге `APPPATH/views`, то при очередном поиске этого файла будет вызван тот, что располагается в каталоге `SYSPATH/views`.
|
||
|
||
## Типы файлов
|
||
|
||
Верхний уровень каталогов application, module, и system путей, по-умолчанию имеет следующие директории:
|
||
|
||
classes/
|
||
: Все классы, которые должны быть [автоматически загружены](using.autoloading) должны располагаться тут. Это касается контроллеров, моделей и всех других классов. Наименования классов должны соответствовать [соглашению по именованию классов](about.conventions#classes).
|
||
|
||
config/
|
||
: Конфигурационные файлы возвращают ассоциативный массив опций, который может быть загружен с использованием метода [Kohana::config]. Для более подробной информации, обратитесь к разделу [Настройка](using.configuration).
|
||
|
||
i18n/
|
||
: Файлы перевода возвращают ассоциативный массив строк. Перевод осуществляется с использованием метода `__()`.Для того, чтобы перевести "Hello, world!" на Русский, нужно вызвать `__('Hello, world!')` c [I18n::$lang] определённом как "ru-ru". Для более подробной информации, обратитесь к разделу [Интернационализация](using.translation).
|
||
|
||
messages/
|
||
: Файлы сообщений возвращают ассоциативный массив строк, который может быть загружен с использованием [Kohana::message]. Разница между сообщениями и файлами интернационализации заключается в том, что сообщения никогда не переводятся, пишутся на языке, используемом по-умолчанию, и вызываются по односложному ключу. Для более подробной информации, обратитесь к разделу [Сообщения (Messages)](using.messages).
|
||
|
||
views/
|
||
: Файлы представления являются PHP файлами, которые используются для генерации HTML или другого вида вывода информации. Файлы представления загружаются в объект [View] и присваиваются переменным, которые в дальнейшем конвертируются во фрагменты HTML. Множественные файлы представления могут быть вызваны одни в других. Для более подробной информации, обратитесь к разделу [Представление и HTML](usings.views).
|
||
|
||
## Поиск файлов
|
||
|
||
Путь к любому файлу в файловой структуре приложения может быть найден путём вызова [Kohana::find_file]:
|
||
|
||
// Ищет полный путь до "classes/cookie.php"
|
||
$path = Kohana::find_file('classes', 'cookie');
|
||
|
||
// Ищет полный путь до "views/user/login.php"
|
||
$path = Kohana::find_file('views', 'user/login');
|
||
|
||
# Сторонние библиотеки
|
||
|
||
Мы называем библиотеки, которые не специфичны для Kohana "vendor" библиотеками. Например, если Вы хотите использовать [DOMPDF](http://code.google.com/p/dompdf), то Вам нужно скопировать эту библиотеку в `application/vendor/dompdf` и добавить автозагрузочный класс DOMPDF:
|
||
|
||
require Kohana::find_file('vendor', 'dompdf/dompdf/dompdf_config.inc');
|
||
|
||
После этого, можно использовать DOMPDF без загрузки каких-либо других файлов:
|
||
|
||
$pdf = new DOMPDF;
|
||
|
||
[!!] Если Вы хотите конвертировать представление в PDF с использованием DOMPDF, используйте [PDFView](http://github.com/shadowhand/pdfview) модуль. |