ThinkPHPimport类库导入

ThinkPHP import 方法

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
系统基类库为相对起始目录：

1. // 导入 ThinkPHP系统目录/Lib/Think/Util/Session.class.php 文件
   
   
2. import("Think.Util.Session");
   
3. // 导入 ThinkPHP系统目录/Lib/ORG/Util/Page.class.php 文件
   
   
4. import("ORG.Util.Page");
   

导入项目应用类库文件

1. // 导入 MyApp项目 Lib/Action/UserAction.class.php 文件
   
   
2. import("MyApp.Action.UserAction");
   
3. // 导入 MyApp项目 Lib/ORG/Page.class.php 文件
   
   
4. import("MyApp.ORG.Page");
   
5. // 导入 MyApp项目 Lib/ORG/My/Image.class.php 文件
   
   
6. import("MyApp.ORG.My.Image");
   

如果是当前项目，可以简化为：

1. import("@.Action.UserAction");
   
2. import("@.ORG.Page");
   
3. 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
方法加以改写。