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的学习过程中，对命名空间的缺乏理解会成为你最大的学习障碍。

相关推荐：

thinkphp5 加载静态资源路径与常量的方法

Thinkphp5行为使用方法汇总

以上是thinkPHP5.0框架命名空間詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！