本文實例講述了thinkPHP5.0框架命名空間。分享給大家供大家參考,具體如下:
命名空間
ThinkPHP采用命名空間方式定義和自動加載類庫文件,有效的解決了多模塊和Composer類庫之間的命名空間沖突問題,并且實現(xiàn)了更加高效的類庫自動加載機制。
如果不清楚命名空間的基本概念,可以參考PHP手冊:PHP命名空間
特別注意的是,如果你需要調用PHP內置的類庫,或者第三方沒有使用命名空間的類庫,記得在實例化類庫的時候加上 /,例如:
// 錯誤的用法$class = new stdClass();$xml = new SimpleXmlElement($xmlstr);// 正確的用法$class = new /stdClass();$xml = new /SimpleXmlElement($xmlstr);
在ThinkPHP5.0中,只需要給類庫正確定義所在的命名空間,并且命名空間的路徑與類庫文件的目錄一致,那么就可以實現(xiàn)類的自動加載,從而實現(xiàn)真正的惰性加載。
例如,/think/cache/driver/File類的定義為:
namespace think/cache/driver;class File{}如果我們實例化該類的話,應該是:
$class = new /think/cache/driver/File();
系統(tǒng)會自動加載該類對應路徑的類文件,其所在的路徑是 thinkphp/library/think/cache/driver/File.php。
5.0默認的目錄規(guī)范是小寫,類文件命名是駝峰法,并且首字母大寫。
原則上,可以支持駝峰法命名的目錄,只要命名空間定義和目錄一致即可,例如:
我們實例化
$class = new /Think/Cache/Driver/File();
系統(tǒng)則會自動加載 thinkphp/library/Think/Cache/Driver/File.php文件。
根命名空間(類庫包)
根命名空間是一個關鍵的概念,以上面的/think/cache/driver/File類為例,think就是一個根命名空間,其對應的初始命名空間目錄就是系統(tǒng)的類庫目錄(thinkphp/library/think),我們可以簡單的理解一個根命名空間對應了一個類庫包。
系統(tǒng)內置的幾個根命名空間(類庫包)如下:
| 名稱 | 描述 | 類庫目錄 | 
|---|---|---|
| think | 系統(tǒng)核心類庫 | thinkphp/library/think | 
| traits | 系統(tǒng)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/',]);
也可以直接在應用的配置文件中添加配置,系統(tǒng)會在應用執(zhí)行的時候自動注冊。
'root_namespace' => [ 'my' => '../application/extend/my/', 'org' => '../application/extend/org/',]
應用類庫包
為了避免和Composer自動加載的類庫存在沖突 ,應用類庫的命名空間的根都統(tǒng)一以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(); }}本文后續(xù)的章節(jié),均建立在你已經了解PHP命名空間的基礎之上,如果不掌握請自行補充PHP基礎,否則你在后續(xù)的文檔和ThinkPHP5.0的學習過程中,對命名空間的缺乏理解會成為你最大的學習障礙。
希望本文所述對大家基于ThinkPHP框架的PHP程序設計有所幫助。
新聞熱點
疑難解答
圖片精選