ThinkPHP import使用方法

2019-04-14 17:01发布

转载自:http://www.itokit.com/2012/0306/73254.html ThinkPHP 模拟了 Java 的类库导入机制,统一采用 import 方法进行类文件的加载。import 方法是 ThinkPHP 内建的类库和文件导入方法,提供了方便和灵活的文件导入机制,完全可以替代 PHP 的 require 和 include 方法 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 基类库文件

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 参数。

指定 baseUrl 参数

对于以上导入系统类库和项目类库的情况,import 方法会自动识别类库导入的路径,其他情况就需要指定 baseUrl 参数。如导入当前文件所在目录下的 My.class.php 文件: import("My",dirname(__FILE__));

指定 ext 参数

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 方法?

import 方法用于导入当前需要而 ThinkPHP 又不能自动载入的文件,如系统基类 ORG 与 Com 目录下的扩展基类,自己的类库等。至于第三方类库,也可以使用 import 方法导入,但建议使用 vendor 方法导入。

import 方法与 import 标签的区别

import 方法用于模块操作中导入不能自动加载的文件类库,import 标签用于在模板中导入外部 Js 和 CSS 文件。

import 方法与 PHP6 import

在未来的 PHP6 版本中开始支持命名空间和 import 关键字,因此可以预见,ThinkPHP 可能会对 import 方法加以改写。