This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
khosb/includes/kohana/modules/userguide/guide/ru-ru/start.conventions.md
2011-05-03 09:49:01 +10:00

2.5 KiB
Raw Blame History

Соглашения

Имена классов и расположение файлов

Для облегчения работы автозагрузки в Kohana, имена классов строго регламентированы.

Имя класса должно начинаться с заглавной буквы, а для разделения слов в имени используется нижнее подчёркивание. Нижнее подчёркивание отражает расположение файла в файловой структуре проекта.

Название класса						Файл

Controller_Template			classes/controller/template.php
Model_User					classes/model/user.php
Model_Auth_User				classes/model/auth/user.php
Auth						classes/auth.php

Использовать CamelCase в имени класса не рекомендуется.

Все файлы классов и директории должны быть в нижнем регистре.

Все классы должны располагаться в директории classes, которая может быть на любом уровне каскадной файловой системы фреймворка.

В отличие от Kohana 2.x и некоторых других фреймворков, Kohana 3 не видит разницы между типами классов. Между 'хелпером' и 'библиотекой' нет различий - в Kohana 3 любой класс может реализовывать любой интерфейс вне зависимости от того, полностью ли он статический (а-ля хелпер), подерживает создание экземпляров класса или нет (например, паттерн singleton).

Оформление кода

При работе с фреймворком приветствуется использование Kohana coding style. В нем используется BSD/Allman стиль оформления текста. (Более подробную информацию о Kohana coding style можно получить, обратившись к подробному описанию предпочитаемого в Kohana стиля.)