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のユーザーガイドが表示されます。