ThinkPHP import 方法完整用法詳解：五種載入模式

import() 核心功能

ThinkPHP import() 用於載入類別庫，支援命名空間風格路徑，自動對應檔案系統路徑，是框架自動載入的核心入口。

五種載入模式對照表

詳細用法範例

1. 專案類庫 @.（最常用）

// 載入 app/Lib/Tool/ArrayTool.class.php
import('@.Tool.ArrayTool');

// 載入 app/Lib/Vendor/PHPExcel.php（無命名空間類別）
import('@.Vendor.PHPExcel', EXT);  // 第二參數指定副檔名

2. 框架核心 Think.

// 載入 thinkphp/Lib/ORG/Util/Page.class.php
import('Think.ORG.Util.Page');

// 載入 thinkphp/Lib/Template/ThinkTemplate.class.php
import('Think.Template.ThinkTemplate');

3. 擴充庫 ORG. / COM.

// 載入 thinkphp/Extend/Library/ORG/Net/Http.class.php
import('ORG.Net.Http');

// 載入 thinkphp/Extend/Library/COM/Alipay/AlipaySubmit.class.php
import('COM.Alipay.AlipaySubmit');

4. 跨分組載入

// 假設專案結構：apps/Admin/Lib/Model/UserModel.class.php
import('Admin.Model.User');

5. 別名載入（配置檔定義）

步驟 1：建立 Conf/alias.php

return [
    'Page'      => LIB_PATH . 'Common/Page.class.php',
    'Excel'     => LIB_PATH . 'Vendor/PHPExcel/PHPExcel.php',
    'WechatSDK' => VENDOR_PATH . 'wechat/sdk/Wechat.php',
];

步驟 2：直接使用別名

import('Page');       // 載入分頁類
import('Excel');      // 載入 PHPExcel
import('WechatSDK');  // 載入微信 SDK

進階：自動載入最佳實踐

ThinkPHP 3.x 註冊自動載入

// Common/common.php
function __autoload($class) {
    // 符合命名規範的類別自動 import
    if (strpos($class, '\\') === false) {
        import('@.' . $class);
    }
}
spl_autoload_register('__autoload');

ThinkPHP 5.0+ Composer PSR-4（推薦）

// composer.json
{
    "autoload": {
        "psr-4": {
            "app\\": "app/",
            "extend\\": "extend/"
        }
    }
}

執行 composer dump-autoload 後，直接 use app\Tool\ArrayTool; 即可，無需 import()。

常見錯誤排查

版本差異提醒

• TP 3.x：依賴 import()、APP_PATH、THINK_PATH 常量
• TP 5.0+：棄用 import()，全面採用 Composer PSR-4 自動載入
• TP 6.0+：移除 import()，強制 PSR-4 + 命名空間