本文實例講述了thinkPHP5.0框架命名空間。分享給大家供大家參考,具體如下:
命名空間
ThinkPHP采用命名空間方式定義和自動加載類庫文件,有效的解決了多模塊和Composer類庫之間的命名空間沖突問題,并且實現了更加高效的類庫自動加載機制。
如果不清楚命名空間的基本概念,可以參考PHP手冊:PHP命名空間
特別注意的是,如果你需要調用PHP內置的類庫,或者第三方沒有使用命名空間的類庫,記得在實例化類庫的時候加上 ,例如:
// 錯誤的用法 $class = new stdClass(); $xml = new SimpleXmlElement($xmlstr); // 正確的用法 $class = new stdClass(); $xml = new SimpleXmlElement($xmlstr);
在ThinkPHP5.0中,只需要給類庫正確定義所在的命名空間,并且命名空間的路徑與類庫文件的目錄一致,那么就可以實現類的自動加載,從而實現真正的惰性加載。
例如,thinkcachedriverFile類的定義為:
namespace thinkcachedriver; class File { }
如果我們實例化該類的話,應該是:
$class = new thinkcachedriverFile();
系統會自動加載該類對應路徑的類文件,其所在的路徑是 thinkphp/library/think/cache/driver/File.php。
5.0默認的目錄規范是小寫,類文件命名是駝峰法,并且首字母大寫。
原則上,可以支持駝峰法命名的目錄,只要命名空間定義和目錄一致即可,例如:
我們實例化
$class = new ThinkCacheDriverFile();
系統則會自動加載 thinkphp/library/Think/Cache/Driver/File.php文件。
根命名空間(類庫包)
根命名空間是一個關鍵的概念,以上面的thinkcachedriverFile類為例,think就是一個根命名空間,其對應的初始命名空間目錄就是系統的類庫目錄(thinkphp/library/think),我們可以簡單的理解一個根命名空間對應了一個類庫包。
系統內置的幾個根命名空間(類庫包)如下:
名稱
描述
類庫目錄
think
系統核心類庫
thinkphp/library/think
traits
系統Trait類庫
thinkphp/library/traits
app
應用類庫
application
如果需要增加新的根命名空間,有兩種方式:注冊新的根命名空間或者放入EXTEND_PATH目錄(自動注冊)。
請注意本文中的示例代碼為了簡潔,如無指定類庫的命名空間的話,都表示指的是think命名空間,例如下面的代碼:
Route::get('hello','index/hello');
請自行使用:
use thinkRoute
或者:
thinkRoute::get('hello','index/hello');
自動注冊
我們只需要把自己的類庫包目錄放入EXTEND_PATH目錄(extend,可配置),就可以自動注冊對應的命名空間,例如:
我們在extend目錄下面新增一個my目錄,然后定義一個myTest類( 類文件位于extend/my/Test.php)如下:
namespace my; class Test { public function sayHello() { echo 'hello'; } }
我們就可以直接實例化和調用:
$Test = new myTest(); $Test->sayHello();
如果我們在應用入口文件中重新定義了EXTEND_PATH常量的話,還可以改變myTest類文件的位置,例如:
define('EXTEND_PATH','../vendor/');
那么myTest類文件的位置就變成了/vendor/my/File.php。
手動注冊
也可以通過手動注冊的方式注冊新的根命名空間,例如:
在應用入口文件中添加下面的代碼:
thinkLoader::addNamespace('my','../application/extend/my/');
如果要同時注冊多個根命名空間,可以使用:
thinkLoader::addNamespace([ 'my' => '../application/extend/my/', 'org' => '../application/extend/org/', ]);
也可以直接在應用的配置文件中添加配置,系統會在應用執行的時候自動注冊。
'root_namespace' => [ 'my' => '../application/extend/my/', 'org' => '../application/extend/org/', ]
應用類庫包
為了避免和Composer自動加載的類庫存在沖突 ,應用類庫的命名空間的根都統一以app命名,例如:
namespace appindexmodel; class User extends thinkModel { }
其類文件位于 application/index/model/User.php。
namespace appadminEvent; class User { }
其類文件位于 application/admin/event/User.php。
如果覺得app根命名空間不合適或者有沖突,可以在應用配置文件中修改:
'app_namespace' => 'application',
定義后,應用類庫的命名空間改為:
namespace applicationindexmodel; class User extends thinkModel { }
命名空間別名
框架允許給命名空間定義別名,例如:
namespace appindexmodel; use thinkModel; class User extends Model { }
原來在控制器里面調用方式為:
namespace appindexcontroller; use appindexmodelUser; class Index { public function index() { $user = new User(); } }
如果我們在應用公共文件中注冊命名空間別名如下:
thinkLoader::addNamespaceAlias('model','appindexmodel');
那么,上面的控制器代碼就可以更改為:
namespace appindexcontroller; use modelUser; class Index { public function index() { $user = new User(); } }
本文后續的章節,均建立在你已經了解PHP命名空間的基礎之上,如果不掌握請自行補充PHP基礎,否則你在后續的文檔和ThinkPHP5.0的學習過程中,對命名空間的缺乏理解會成為你最大的學習障礙。
更多關于thinkPHP相關內容感興趣的讀者可查看本站專題:《ThinkPHP入門教程》、《thinkPHP模板操作技巧總結》、《ThinkPHP常用方法總結》、《codeigniter入門教程》、《CI(CodeIgniter)框架進階教程》、《Zend FrameWork框架入門教程》、《smarty模板入門基礎教程》及《PHP模板技術總結》。
希望本文所述對大家基于ThinkPHP框架的PHP程序設計有所幫助。