级联文件系统

Kohana文件系统是一个分层结构，像目录结构那样级联。在kohana中，这个分层结构（当一个文件通过[Kohana::find_file]被加载时，会使用）按照下面的顺序：

  1. 应用路径
    在index.php中，被定义为APPPATH，默认值是 application。

  2. 模块路径
    在 APPPATH/bootstrap.php中，通过[Kohana::modules]被设置为关联数组。数组中的每个值都可以按照在模块中定义的顺序被找到。

  3. 系统路径
    在index.php中，被定义为SYSPATH，默认值是system`。所有主要”core”文件和类都定义在这里。

目录中的同名的文件，越靠近目录顶层，优先级越高。所以，同名的文件，可以通过放在高优先级的目录中，使其重载。

Cascading Filesystem Infographic

这张图片只是展示了某些文件，但是我们只是用它解释级联文件系统的例子：

  • 如果Kohana捕获到了错误，它将会展示kohana/error.php视图，所以它将调用Kohana::find_file('views', 'kohana/error')，这个调用会返回application/views/kohana/error.php，因为它的优先级比system/views/kohana/error.php高。通过这样做，我们就不需要去修改系统文件夹。

  • 如果我们使用View::factory('welcome')，它会调用Kohana::find_file('views','welcome') ，并且返回application/views/welcome.php。因为它的优先级比modules/common/views/welcome.php高。通过这样做，我们可以重写一个module做的事情，不用编辑modules文件。

  • 如果我们使用Cookie类，[Kohana::auto_load]将会调用Kohana::find_file('classes', 'cookie') ，并且返回application/classes/cookie.php。假设Cookie继承Kohana_Cookie，自动加载将会接着调用Kohana::find_file('classes','kohana/cookie')，并且返回system/classes/kohana/cookie.php，因为没有更高层级目录优先级的文件存在。这是一个清晰的扩展示例.

  • 如果我们使用 View::factory('user')，它会调用Kohana::find_file('views','user')，并且返回modules/common/views/user.php。

  • 如果我们想修改config/database.php中的一些东西，我们可以拷贝这个文件到 application/config/database.php，在这里做一些修改。记住，合并了的配置文件要比通过级联优先级重载好。

文件的类型

上级的目录是application, module和system，system路径下，有下面几个默认的目录：

classes/ : 所有需要 自动加载 的类都需要放在这里。 包括 controllers, models，和所有其他的类。 所有的类都必须遵从 类命名规范.

config/ : 配置文件可以通过[Kohana::$config]被加载，其中的选项以关联数组的形式返回。合并了的配置文件要比通过级联优先级重载好。请看 配置文件寻找更多信息。

i18n/ : 翻译文件中的内容以关联数组的形式返回。通过 __() 方法进行翻译。要将”Hello, world!” 翻译成西班牙文， 你可以调用 __('Hello, world!')通过设置[I18n::$lang] 为”es-es”。合并了的I18n文件要比通过级联优先级重载好。 请看 I18n files 寻找更多信息。

messages/ : Message可以通过[Kohana::message]被加载，其中的字符串会以关联数组的形式返回。Messages和i18n文件的不同在于没有被翻译，但是总是用默认的语言编写，并且只设计单个词。合并了的Message文件要比通过级联优先级重载好. 请看 message files 寻找更多信息。

views/ : 视图是用来生成html或者其他输出的普通php文件。视图文件被加载到[View]对象，并且指定那些要转换成html片段的变量。多个视图可以互相调用。请看views 寻找更多信息。

other : 你可以包含任何其他的文件在你的级联文件系统中。例如guide, vendor, media，但不止这些，任何你想要的都可以。例如，要在级联文件系统中找打media/logo.png，你可以调用 Kohana::find_file('media','logo','png')。

Finding Files

可以通过调用[Kohana::find_file]查找文件系统中的任何文件：

  1. // 查找文件"classes/cookie.php"所在的全路径
  2. $path = Kohana::find_file('classes', 'cookie');
  4. // 查找文件"views/user/login.php"所在的全路径
  5. $path = Kohana::find_file('views', 'user/login');

如果一个文件不是以.php 结尾的，可以在第三个参数中传递文件的扩展名。

  1. // 查找文件"guide/menu.md"所在的全路径
  2. $path = Kohana::find_file('guide', 'menu', 'md');
  4. // 如果$name是"2000-01-01-first-post"，这将查找文件"posts/2000-01-01-first-post.textile"的全路径。
  5. $path = Kohana::find_file('posts', $name, '.textile');

第三方扩展

我们可以调用那些并不针对Kohana的第三方扩展或者额外的类库，它们在vendor文件夹下面，在application或者module下面都能发现这样的类库。因为这些类库不尊从Kohana文件的命名规范，它们不会被kohana自动加载，所以需要手动包含。第三方类库的例子有：Markdown, DOMPDF, Mustache 和 Swiftmailer。

例如，如果你想使用 DOMPDF，你需要把它拷贝到 application/vendor/dompdf，并且包含DOMPDF自动加载类。在一个控制器中，之前的方法是作为一个模块的init.php时，或者是一个 单例类的构造函数时，要注意。

  1. require Kohana::find_file('vendor', 'dompdf/dompdf/dompdf_config','inc');

现在，你可以使用 DOMPDF 而不用包含其多余的文件。

  1. $pdf = new DOMPDF;

[!!] 如果你想用DOMPDF转换视图到PDFs，试试 PDFView 模块。