ThinkPHP import 方法全攻略：類庫自動載入的最佳實踐

import 方法 是 ThinkPHP 封裝的類庫載入核心，支援系統基類、擴展類庫、項目應用類、第三方類庫及非標準路徑載入，並提供 vendor 別名與別名載入機制。

調用語法

import('類庫名', '起始路徑', '類庫後綴')

六大核心使用場景

1. 系統基類庫載入

import('Think.Util.Array');

載入 THINK_PATH/Lib/Util/Array.class.php，支援多級目錄：Think.Util.U1.ClassA。

2. 擴展類庫載入

import('ORG.Util.Image');
import('Com.Sina.OAuth');

對應 Extend/Library/ORG/ 與 Com/ 目錄，僅支援 ORG、Com 兩大包。

3. 項目應用類庫載入

import('@.Action.UserAction');
import('@.Model.InfoModel');

@ 符號代表當前項目，利於專案遷移與重命名。

4. 非標準類庫檔案載入

// 載入 Common 目錄下 MyClass.php
import('Common.MyClass', APP_PATH, '.php');
import('MyClass', APP_PATH . 'Common', '.php');

// 載入當前目錄 RBAC 類庫
import('RBAC.AccessDecisionManager', dirname(__FILE__), '.php');

// 特殊命名（含點號）用 # 替代
import('ORG.User#Info'); // 載入 User.Info.class.php

5. 第三方類庫載入（vendor 別名）

Vendor('Zend.Filter.Dir');

預設路徑 Extend/Vendor/，後綴 .php，可自訂路徑與後綴。

6. 別名載入（高效能）

配置 alias.php：

return array(
    'rbac' => LIB_PATH . 'Common/Rbac.class.php',
    'page' => LIB_PATH . 'Common/Page.class.php',
);

直接調用：import('rbac')。效率高於命名空間載入，但需預先定義。

實戰建議

• 框架內建自動載入，手動 import 主要用於擴展與第三方類庫
• 結合別名定義與自動載入路徑，減少手動載入
• 非標準路徑務必指定起始路徑與後綴