Tipos de arquivo

Algumas considerações específicas do Kohana:

• Models são utilizados para representar dados, como por exemplo, um conjunto de registros do banco de dados;
• Views são utilizadas como uma interface entre os dados e as páginas HTML que serão renderizadas;
• Controllers são utilizados como ponto de entrada e responsáveis por controlar a lógica da aplicação;
• Bibliotecas são utilizadas como ferramentas que operam em alguma forma de dados pré-existentes, arrays (Session, Validation, Input) ou alguma outra estrutura de dados, como ORM (mapeamento objeto-relacional) ou Archive (sistema de arquivos);
• Helpers são utilizados para tarefas repetitivas, como criar tags HTML, converter uma URI em uma URL, ou validar um endereço de e-mail.

Complementando, o Kohana apresenta a seguinte estrutura de suporte:

• Arquivos de configuração, arrays estáticos simples, que são acessados pela convenção arquivo.chave;
• Arquivos de internacionalização (i18n), padrão (arquivo.chave);
• Hooks (sobrecarregamento de eventos).

O básico

Primeiramente, devemos nos habituar com a estrutura-padrão de instalação do Kohana. Uma vez descompactado, veremos a seguinte estrutura:

root
 +- application
 |    +- cache
 |    +- config
 |    +- controllers
 |    +- helpers
 |    +- hooks
 |    +- libraries
 |    +- logs
 |    +- models
 |    +- views
 |
 +- modules
 |    +- media
 |        +- config
 |        +- controllers
 |        +- helpers
 |        +- libraries 
 |    +- ..... 
 +- system
 |    +- config
 |    +- controllers
 |    +- core
 |    +- helpers
 |    +- i18n
 |    +- libraries
 |    +- models
 |    +- vendor
 |    +- views
 |
 +- index.php

Note que a estrutura de diretórios da application e do system são similares. O Kohana apresenta uma estrutura de arquivos em cascata.

Em cascata

A estrutura do Kohana é espelhada, e o seu include path pode ser definido como: application > modules > system.

Caso exista um arquivo em application/views/layout.php e um outro em system/views/layout.php, a prioridade é varrer o diretório application. Caso o layout.php em application seja removido, a busca será a partir do diretório system.

Modular

A estrutura do Kohana é modular. Portanto, diretórios que não pertencem à estrutura-padrão, podem ser incluídos via include path.

Exceções

Existem duas exceções na estrutura de arquivos:

1. config.php deve residir no diretório application/config. Esse arquivo não será lido, caso esteja em um módulo ou no diretório system;
2. Os arquivos do núcleo (system/core) não fazem parte do processo em cascata.