ThinkPHP 3.2 命名空間自動載入機制詳解

背景

ThinkPHP 3.2 引入 PHP 5.3 命名空間，徹底解決類庫衝突，並實現高效的 PSR-0 風格自動載入。本文梳理核心規則與常見用法。

一、核心規則：目錄即命名空間

• 類庫文件路徑 = 命名空間路徑 + 類名.class.php
• 根命名空間目錄：ThinkPHP/Library/ 下的一級子目錄自動成為根命名空間（如 Org、Com、自建 My）
• 模組內類庫：以模組名為根命名空間（Home\Model、Admin\Event）

二、系統類庫範例

// 文件：ThinkPHP/Library/Org/Util/File.class.php
namespace Org\Util;
class File { }

// 實例化（注意前導 \ 表示全域空間）
$file = new \Org\Util\File();

三、自定義根命名空間

在 Library/ 下新建 My/ 目錄：

// ThinkPHP/Library/My/Test.class.php
namespace My;
class Test {
    public function sayHello() { echo 'hello'; }
}

// 直接使用，無需 import
$t = new \My\Test();
$t->sayHello();

四、模組類庫命名空間

五、關閉應用類庫命名空間（3.2.1+）

若團隊不習慣命名空間，可在配置中關閉：

'APP_USE_NAMESPACE' => false,

此時應用類庫無需 namespace 宣告，但繼承核心類仍需完整命名空間：

class UserModel extends \Think\Model { }

六、實例化 PHP 內建/第三方無命名空間類

必須加前導 \ 避免被當成當前命名空間下的類：

$obj   = new \stdClass();
$xml   = new \SimpleXmlElement($xmlstr);
$redis = new \Redis(); // 第三方擴展同理

七、自動載入流程圖解

1. 代碼出現 new \Home\Model\UserModel
2. 自動載入器解析命名空間 Home\Model → 模組 Home、層 Model
3. 定位 Application/Home/Model/UserModel.class.php
4. 載入文件，實例化對象

八、常見錯誤與排查

總結

ThinkPHP 命名空間設計遵循「目錄即命名空間」直覺原則，配合 DEFAULT_*_LAYER 配置極具彈性。掌握「根命名空間自動識別、模組命名空間約定、關閉選項、內建類前導 \」四大要點，即可暢行無阻。