thinkPHP5.0架構命名空間詳解

這篇文章主要介紹了thinkPHP5.0架構命名空間,結合具體執行個體形式詳細分析了thinkPHP5.0中命名空間的概念、功能及相關使用方法,需要的朋友可以參考下

本文執行個體講述了thinkPHP5.0架構命名空間。分享給大家供大家參考，具體如下：

命名空間

ThinkPHP採用命名空間方式定義和自動載入類庫檔案，有效解決了多模組和Composer類庫之間的命名空間衝突問題，並且實現了更加高效的類庫自動載入機制。

如果不清楚命名空間的基本概念，可以參考PHP手冊：PHP命名空間

特別注意的是，如果你需要調用PHP內建的類庫，或者第三方沒有使用命名空間的類庫，記得在執行個體化類庫的時候加上 \，例如：

// 錯誤的用法$class = new stdClass();$xml = new SimpleXmlElement($xmlstr);// 正確的用法$class = new \stdClass();$xml = new \SimpleXmlElement($xmlstr);

在ThinkPHP5.0中，只需要給類庫正確定義所在的命名空間，並且命名空間的路徑與類庫檔案的目錄一致，那麼就可以實作類別的自動載入，從而實現真正的惰性載入。

例如，\think\cache\driver\File類的定義為：

namespace think\cache\driver;class File{}

如果我們執行個體化該類的話，應該是：

$class = new \think\cache\driver\File();

系統會自動載入該類對應路徑的類檔案，其所在的路徑是 thinkphp/library/think/cache/driver/File.php。

5.0預設的目錄規範是小寫，類檔案命名是駝峰法，並且首字母大寫。

原則上，可以支援駝峰法命名的目錄，只要命名空間定義和目錄一致即可，例如：

我們執行個體化

$class = new \Think\Cache\Driver\File();

系統則會自動載入 thinkphp/library/Think/Cache/Driver/File.php檔案。

根命名空間（類庫包）

根命名空間是一個關鍵的概念，以上面的\think\cache\driver\File類為例，think就是一個根命名空間，其對應的初始命名空間目錄就是系統的類庫目錄（thinkphp/library/think），我們可以簡單的理解一個根命名空間對應了一個類庫包。

系統內建的幾個根命名空間（類庫包）如下：

名稱	描述	類庫目錄
think	系統核心類庫	thinkphp/library/think
traits	系統Trait類庫	thinkphp/library/traits
app	應用類庫	application

如果需要增加新的根命名空間，有兩種方式：註冊新的根命名空間或者放入EXTEND_PATH目錄（自動註冊）。

請注意本文中的範例程式碼為了簡潔，如無指定類庫的命名空間的話，都表示指的是think命名空間，例如下面的代碼：

Route::get('hello','index/hello');

請自行使用：

use think\Route

或者：

\think\Route::get('hello','index/hello');

自動註冊

我們只需要把自己的類庫包目錄放入EXTEND_PATH目錄（extend，可配置），就可以自動註冊對應的命名空間，例如：

我們在extend目錄下面新增一個my目錄，然後定義一個\my\Test類（ 類檔案位於extend/my/Test.php）如下：

namespace my;class Test{ public function sayHello() {  echo 'hello'; }}

我們就可以直接執行個體化和調用：

$Test = new \my\Test();$Test->sayHello();

如果我們在應用入口檔案中重新定義了EXTEND_PATH常量的話，還可以改變\my\Test類檔案的位置，例如：

define('EXTEND_PATH','../vendor/');

那麼\my\Test類檔案的位置就變成了/vendor/my/File.php。

手動註冊

也可以通過手動註冊的方式註冊新的根命名空間，例如：

在應用入口檔案中添加下面的代碼：

\think\Loader::addNamespace('my','../application/extend/my/');

如果要同時註冊多個根命名空間，可以使用：

\think\Loader::addNamespace([ 'my' => '../application/extend/my/', 'org' => '../application/extend/org/',]);

也可以直接在應用的設定檔中添加配置，系統會在應用執行的時候自動註冊。

'root_namespace' => [ 'my' => '../application/extend/my/', 'org' => '../application/extend/org/',]

應用類庫包

為了避免和Composer自動載入的類庫存在衝突 ，應用類庫的命名空間的根都統一以app命名，例如：

namespace app\index\model;class User extends \think\Model{}

其類檔案位於 application/index/model/User.php。

namespace app\admin\Event;class User{}

其類檔案位於 application/admin/event/User.php。

如果覺得app根命名空間不合適或者有衝突，可以在應用設定檔中修改：

'app_namespace' => 'application',

定義後，應用類庫的命名空間改為：

namespace application\index\model;class User extends \think\Model{}

命名空間別名

架構允許給命名空間定義別名，例如：

namespace app\index\model;use think\Model;class User extends Model{}

原來在控制器裡面調用方式為：

namespace app\index\controller;use app\index\model\User;class Index{ public function index() {  $user = new User(); }}

如果我們在應用公用檔案中註冊命名空間別名如下：

\think\Loader::addNamespaceAlias('model','app\index\model');

那麼，上面的控制器代碼就可以更改為：

namespace app\index\controller;use model\User;class Index{ public function index() {  $user = new User(); }}

本文後續的章節，均建立在你已經瞭解PHP命名空間的基礎之上，如果不掌握請自行補充PHP基礎，否則你在後續的文檔和ThinkPHP5.0的學習過程中，對命名空間的缺乏理解會成為你最大的學習障礙。