框架的一个重要功能就是类的自动加载了,在第一个demo的时候我们就约定自己的项目的目录结构,框架就基于这个目录结构来自动加载需要的类文件。
Yaf在自启动的时候, 会通过SPL注册一个自己的Autoloader, 出于性能的考虑, 对于框架相关的MVC类, Yaf Autoloader只以目录映射的方式尝试一次.
具体的目录映射规则如下:
注意:下文中用到的{应用目录}即项目目录,yaf默认目录是 application 目录。
对于控制器 Controller 默认模块下为{应用目录}/controllers/, 否则为{应用目录}/modules/{模块名}/controllers 比如IndexController,这自动加载文件 {应用目录}/Controllers/Index.php
对于Model 加载路径为{应用目录}/models/ 类似比如UserModel则自动加载{应用目录}/models/User.php
其它规则比如actions,plugin也都类似。
而对于非框架MVC相关的类, Yaf支持全局类和自身类的两种加载方式, 并且Yaf支持大小写敏感和不敏感两种方式来处理文件路径。
全局类和自身类(本地类)
Yaf为了方便在一台服务器上部署的不同产品之间共享公司级别的共享库, 支持全局类和本地类两种加载方式。
全局类是指, 所有产品之间共享的类, 这些类库的路径是通过ap.library在php.ini(当然,如果PHP在编译的时候, 支持了with-config-file-scan-dir,那么也可以写在单独的ap.ini中)
而本地类是指, 产品自身的类库, 这些类库的路径是通过在产品的配置文件中, 通过ap.library配置的.在Yaf中, 通过调用Yaf_Loader的registerLocalNamespace方法, 来申明那些类前缀是本地类, 即可。
注意:在use_spl_autoload关闭的情况下, Yaf Autoloader在一次找不到的情况下, 会立即返回, 而剥夺其后的自动加载器的执行机会.
Yaf中类的加载规则
Yaf规定类名中必须包含路径信息, 也就是以下划线"_"分割的目录信息. Yaf将依照类名中的目录信息, 完成自动加载。
如下的例子, 在没有申明本地类的情况下:
几个自动加载的例子
1. 在library目录下存在Controller/Base.php文件。
则该文件的类名必须为 Controller_Base,否则会提示文件找不到的不错。
2. 在models目录下存在Business/User.php文件。
则该文件的类名必须为 Business_UserModel。
而, 如果通过如下方式调用了registerLocalNamespace:注册本地类
//申明, 凡是以Foo和Local开头的类, 都是本地类 $loader = Yaf_Loader::getIgnstance(); $loader->registerLocalNamespace(array("Foo", "Local"));