kohanaのファイルシステム

kohanaでは、カスケーディングファイルシステムという仕組みが用意されています。

kohanaのドキュメントにある次の図が非常にわかりやすいのです。

kohanaの基本となるディレクトリは、次の3つになります。

• application
• modules
• system

これらのディレクトリには、application > modules > system の順に優先順位があり 同名のファイルがある場合、この順に使用されます。サイト全体としては、これらがマージされた 形となります。

modulesを使うかどうかは、applicationディレクトリのbootstrap.phpに定義します。

Kohana::modules(array(
        // 'auth'       => MODPATH.'auth',       // Basic authentication
        // 'codebench'  => MODPATH.'codebench',  // Benchmarking tool
        // 'database'   => MODPATH.'database',   // Database access
        // 'image'      => MODPATH.'image',      // Image manipulation
        // 'orm'        => MODPATH.'orm',        // Object Relationship Mapping
        // 'pagination' => MODPATH.'pagination', // Paging of results
        // 'userguide'  => MODPATH.'userguide',  // User guide and API documentation
        ));

例えば、kohana3.xはuserguideを含んだ状態で配布されています。

これを有効にするには、applicationディレクトリのbootstrap.phpを修正します。

Kohana::modules(array(
        'userguide'  => MODPATH.'userguide',  // User guide and API documentation
        ));

上記設定によりブラウザからhttp://ドメイン/kohanaの配置先/userguide/docsにアクセスすると kohana3.xのユーザーガイドが表示されます。