ThinkPHP 模拟了 Java 的类库导入机制,统一采用 import 方法进行类文件的加载。import 方法是 ThinkPHP 内建的类库和文件导入方法,提供了方便和灵活的文件导入机制,完全可以替代 PHP 的 require 和 include 方法。
但对于第三方类库,我们建议使用 vendor 方法来导入。
import 语法:
boolen import(class, baseUrl, ext)
参数 | 说明 |
---|---|
class | 必须,表示要导入的类库,采用命名空间的方式。 |
baseUrl | 可选,表示导入的基础路径,省略的话系统采用默认的规则,具体见下文。 |
ext | 可选,表示导入的类库后缀,默认是 .class.php 。 |
import 方法是 ThinkPHP 内置的一个普通函数,可以在模块操作内自由使用,可以参考 PHP include 和 require 的用法。
import 方法导入 ThinkPHP 基类库文件,约定导入 Think、ORG、Com 包以 ThinkPHP 系统基类库为相对起始目录:
// 导入 ThinkPHP系统目录/Lib/Think/Util/Session.class.php 文件 import("Think.Util.Session"); // 导入 ThinkPHP系统目录/Lib/ORG/Util/Page.class.php 文件 import("ORG.Util.Page");
// 导入 MyApp项目 Lib/Action/UserAction.class.php 文件 import("MyApp.Action.UserAction"); // 导入 MyApp项目 Lib/ORG/Page.class.php 文件 import("MyApp.ORG.Page"); // 导入 MyApp项目 Lib/ORG/My/Image.class.php 文件 import("MyApp.ORG.My.Image");
如果是当前项目,可以简化为:
import("@.Action.UserAction"); import("@.ORG.Page"); import("@.ORG.My.Image");
这种写法有利于项目的移植。如果是导入其他项目的类库,必须指定项目名称:
import("OtherApp.Action.UserAction");
注意:使用这种方式导入其他项目的类库时,必须保证两个项目的目录是平级的,否则需要指定 baseUrl 参数。
对于以上导入系统类库和项目类库的情况,import 方法会自动识别类库导入的路径,其他情况就需要指定 baseUrl 参数。如导入当前文件所在目录下的 My.class.php 文件:
import("My",dirname(__FILE__));
ext 参数表示导入的类库后缀,默认是 .class.php。如果导入的文件不是 *.class.php 格式的,可以指定 ext 参数。如导入当前文件所在目录下的 My.php 文件:
import("My",dirname(__FILE__),".php");
在 import 方法中,. 符号是用于表示目录层次的,如果需要导入的文件名包含有 . 符号,如 User.Info.class.php ,那么需要以 # 号来代替 . 号:
import("@.Action.User#Info");
如果在别名定义文件定义了别名:
'AdvModel' => THINK_PATH.'/Lib/Think/Core/Model/AdvModel.class.php',
可以使用 import 方法以别名的方式导入对应的类库文件:
import('AdvModel');
系统默认的别名定义文件位于 ThinkPHP 系统目录下的 Commonalias.php,也可以定义项目自己的别名文件。
import 方法具有缓存和检测机制,相同的文件不会重复导入,如果发现导入了不同的位置下面的同名类库文件,系统会提示冲突,例如:
import("Think.Util.Array"); import("App.Util.Array");
上面的情况导入会产生引入两个同名的 Array.class.php 类,即使实际上的类名可能不存在冲突,但是按照 ThinkPHP 命名规范,类名和文件名是一致的,所以系统会抛出类名冲突的异常,并终止执行。
import 方法用于导入当前需要而 ThinkPHP 又不能自动载入的文件,如系统基类 ORG 与 Com 目录下的扩展基类,自己的类库等。至于第三方类库,也可以使用 import 方法导入,但建议使用 vendor 方法导入。
import 方法用于模块操作中导入不能自动加载的文件类库,import 标签用于在模板中导入外部 Js 和 CSS 文件。
在未来的 PHP6 版本中开始支持命名空间和 import 关键字,因此可以预见,ThinkPHP 可能会对 import 方法加以改写。