PHP命名空間(Namespace)的使用詳解

最後更新：2018-12-08 來源：互聯網

上載者：User

創建阿里雲帳戶，並獲得超過 40 款產品的免費試用版；而企業帳戶則可以享有總值 $1200 的免費試用版。立即註冊！

對於命名空間，官方文檔已經說得很詳細[查看]，我在這裡做了一下實踐和總結。

命名空間一個最明確的目的就是解決重名問題，PHP中不允許兩個函數或者類出現相同的名字，否則會產生一個致命的錯誤。這種情況下只要避免命名重複就可以解決，最常見的一種做法是約定一個首碼。

例：項目中有兩個模組：article和message board，它們各自有一個處理使用者留言的類Comment。之後我可能想要增加對所有使用者留言的一些資訊統計功能，比如說我想得到所有留言的數量。這時候調用它們Comment提供的方法是很好的做法，但是同時引入各自的Comment類顯然是不行的，代碼會出錯，在另一個地方重寫任何一個Comment也會降低維護性。那這時只能重構類名，我約定了一個命名規則，在類名前面加上模組名，像這樣：Article_Comment、MessageBoard_Comment

可以看到，名字變得很長，那意味著以後使用Comment的時候會寫上更多的代碼（至少字元多了）。並且，以後如果要對各個模組增加更多的一些整合功能，或者是互相調用，發生重名的時候就需要重構名字。當然在項目開始的時候就注意到這個問題，並規定命名規則就能很好的避免這個問題。另一個解決方案可以考慮使用命名空間。

註明：

本文提到的常量：PHP5.3開始const關鍵字可以用在類的外部。const和define都是用來聲明常量的（它們的區別不詳述），但是在命名空間裡，define的作用是全域的，而const則作用於當前空間。我在文中提到的常量是指使用const聲明的常量。

基礎
命名空間將代碼劃分出不同的空間（地區），每個空間的常量、函數、類（為了偷懶，我下邊都將它們稱為元素）的名字互不影響，這個有點類似我們常常提到的‘封裝'的概念。

建立一個命名空間需要使用namespace關鍵字，這樣：

複製代碼代碼如下:<?php

//建立一個名為'Article'的命名空間
namespace Article;

要注意的是，當前指令檔的第一個命名空間前面不能有任何代碼，下面的寫法都是錯誤的：複製代碼代碼如下://例一
//在指令碼前面寫了一些邏輯代碼

<?php

$path = "/";

class Comment { }

namespace Article;

//例二
//在指令碼前面輸出了一些字元

<html></html>
<?php

namespace Article;

為什麼要說第一個命名空間呢？因為同一指令檔中可以建立多個命名空間。

下面我建立了兩個命名空間，順便為這兩個空間各自添加了一個Comment類元素：

複製代碼代碼如下:<?php

//建立一個名為'Article'的命名空間
namespace Article;

//此Comment屬於Article空間的元素
class Comment { }

//建立一個名為'MessageBoard'的命名空間
namespace MessageBoard;

//此Comment屬於MessageBoard空間的元素
class Comment { }
?>

在不同空間之間不可以直接調用其它元素，需要使用命名空間的文法：複製代碼代碼如下:<?php

namespace Article;

class Comment { }

namespace MessageBoard;

class Comment { }

//調用當前空間（MessageBoard）的Comment類
$comment = new Comment();

//調用Article空間的Comment類
$article_comment = new \Article\Comment();

可以看到，在MessageBoard空間中調用article空間裡的Comment類時，使用了一種像檔案路徑的文法： \空間名\元素名

除了類之外，對函數和常量的用法是一樣的，下面我為兩個空間建立了新的元素，並在MessageBoard空間中輸出了它們的值。

複製代碼代碼如下:<?php

namespace Article;

const PATH = '/article';

function getCommentTotal() {
return 100;
}

class Comment { }

namespace MessageBoard;

const PATH = '/message_board';

function getCommentTotal() {
return 300;
}

class Comment { }

//調用當前空間的常量、函數和類
echo PATH; ///message_board
echo getCommentTotal(); //300
$comment = new Comment();

//調用Article空間的常量、函數和類
echo \Article\PATH; ///article
echo \Article\getCommentTotal(); //100
$article_comment = new \Article\Comment();

然後我的確得到了Article空間的元素資料。

子空間
命名空間的調用文法像檔案路徑一樣是有道理的，它允許我們自訂子空間來描述各個空間之間的關係。

抱歉我忘了說，article和message board這兩個模組其實都是處於同一個blog項目內。如果用命名空間來表達它們的關係，是這樣：

複製代碼代碼如下:<?php

//我用這樣的命名空間表示處於blog下的article模組
namespace Blog\Article;

class Comment { }

//我用這樣的命名空間表示處於blog下的message board模組
namespace Blog\MessageBoard;

class Comment { }

//調用當前空間的類
$comment = new Comment();

//調用Blog\Article空間的類
$article_comment = new \Blog\Article\Comment();

而且，子空間還可以定義很多層次，比如說 Blog\Article\Archives\Date

公用空間
我有一個common_inc.php指令檔，裡面有一些好用的函數和類：

複製代碼代碼如下:<?php

function getIP() { }

class FilterXSS { }

在一個命名空間裡引入這個指令碼，指令碼裡的元素不會歸屬到這個命名空間。如果這個指令碼裡沒有定義其它命名空間，它的元素就始終處於公用空間中：複製代碼代碼如下:<?php

namespace Blog\Article;

//引入指令檔
include './common_inc.php';

$filter_XSS = new FilterXSS(); //出現致命錯誤：找不到Blog\Article\FilterXSS類

$filter_XSS = new \FilterXSS(); //正確

調用公用空間的方式是直接在元素名稱前加 \ 就可以了，否則PHP解析器會認為我想調用當前空間下的元素。除了自訂的元素，還包括PHP內建的元素，都屬於公用空間。

要提一下，其實公用空間的函數和常量不用加 \ 也可以正常調用（不明白PHP為什麼要這樣做），但是為了正確區分元素，還是建議調用函數的時候加上 \

名稱術語
在說別名和匯入之前，需要知道關於空間三種名稱的術語，以及PHP是怎樣解析它們的。官方文檔說得非常好，我就直接拿來套了。

1.非限定名稱，或不包含首碼的類名稱，例如 $comment = new Comment();。如果當前命名空間是Blog\Article，Comment將被解析為Blog\Article\Comment。如果使用Comment的代碼不包含在任何命名空間中的代碼（全域空間中），則Comment會被解析為Comment。

2.限定名稱，或包含首碼的名稱，例如 $comment = new Article\Comment();。如果當前的命名空間是Blog，則Comment會被解析為Blog\Article\Comment。如果使用Comment的代碼不包含在任何命名空間中的代碼（全域空間中），則Comment會被解析為Comment。

3.完全限定名稱，或包含了全域首碼操作符的名稱，例如 $comment = new \Article\Comment();。在這種情況下，Comment總是被解析為代碼中的文字名(literal name)Article\Comment。

其實可以把這三種名稱類比為檔案名稱（例如 comment.php）、相對路徑名（例如 ./article/comment.php）、絕對路徑名（例如 /blog/article/comment.php），這樣可能會更容易理解。

我用了幾個樣本來表示它們：

複製代碼代碼如下:<?php

//建立空間Blog
namespace Blog;

class Comment { }

//非限定名稱，表示當前Blog空間
//這個調用將被解析成 Blog\Comment();
$blog_comment = new Comment();

//限定名稱，表示相對於Blog空間
//這個調用將被解析成 Blog\Article\Comment();
$article_comment = new Article\Comment(); //類前面沒有反斜杆\

//完全限定名稱，表示絕對於Blog空間
//這個調用將被解析成 Blog\Comment();
$article_comment = new \Blog\Comment(); //類前面有反斜杆\

//完全限定名稱，表示絕對於Blog空間
//這個調用將被解析成 Blog\Article\Comment();
$article_comment = new \Blog\Article\Comment(); //類前面有反斜杆\

//建立Blog的子空間Article
namespace Blog\Article;

class Comment { }

其實之前我就一直在使用非限定名稱和完全限定名稱，現在它們終於可以叫出它們的名稱了。

別名和匯入
別名和匯入可以看作是調用命名空間元素的一種捷徑。PHP並不支援匯入函數或常量。

它們都是通過使用use操作符來實現：

複製代碼代碼如下:<?php

namespace Blog\Article;

class Comment { }

//建立一個BBS空間（我有打算開個論壇）
namespace BBS;

//匯入一個命名空間
use Blog\Article;
//匯入命名空間後可使用限定名稱調用元素
$article_comment = new Article\Comment();

//為命名空間使用別名
use Blog\Article as Arte;
//使用別名代替空間名
$article_comment = new Arte\Comment();

//匯入一個類
use Blog\Article\Comment;
//匯入類後可使用非限定名稱調用元素
$article_comment = new Comment();

//為類使用別名
use Blog\Article\Comment as Comt;
//使用別名代替空間名
$article_comment = new Comt();

我注意到，如果匯入元素的時候，當前空間有相同的名字元素將會怎樣？顯然結果會發生致命錯誤。

例：

複製代碼代碼如下:<?php

namespace Blog\Article;

class Comment { }

namespace BBS;

class Comment { }

Class Comt { }

//匯入一個類
use Blog\Article\Comment;
$article_comment = new Comment(); //與當前空間的Comment發生衝突，程式產生致命錯誤

//為類使用別名
use Blog\Article\Comment as Comt;
$article_comment = new Comt(); //與當前空間的Comt發生衝突，程式產生致命錯誤

動態調用
PHP提供了namespace關鍵字和__NAMESPACE__魔法常量動態訪問元素，__NAMESPACE__可以通過組合字元串的形式來動態訪問：複製代碼代碼如下:<?php

namespace Blog\Article;

const PATH = '/Blog/article';

class Comment { }

//namespace關鍵字表示當前空間
echo namespace\PATH; ///Blog/article
$comment = new namespace\Comment();

//魔法常量__NAMESPACE__的值是當前空間名稱
echo __NAMESPACE__; //Blog\Article
//可以組合成字串並調用
$comment_class_name = __NAMESPACE__ . '\Comment';
$comment = new $comment_class_name();

字串形式調用問題

上面的動態調用的例子中，我們看到了字串形式的動態調用方式，如果要使用這種方式要注意兩個問題。

1. 使用雙引號的時候特殊字元可能被轉義

複製代碼代碼如下:<?php

namespace Blog\Article;

class name { }

//我是想調用Blog\Article\name
$class_name = __NAMESPACE__ . "\name"; //但是\n將被轉義為分行符號

$name = new $class_name(); //發生致命錯誤

2. 不會認為是限定名稱

PHP在編譯指令碼的時候就確定了元素所在的空間，以及匯入的情況。而在解析指令碼時字串形式調用只能認為是非限定名稱和完全限定名稱，而永遠不可能是限定名稱。

複製代碼代碼如下:<?php

namespace Blog;

//匯入Common類
use Blog\Article\Common;
//我想使用非限定名稱調用Blog\Article\Common
$common_class_name = 'Common';
//實際會被當作非限定名稱，也就表示當前空間的Common類，但我當前類沒有建立Common類
$common = new $common_class_name(); //發生致命錯誤：Common類不存在

//我想使用限定名稱調用Blog\Article\Common
$common_class_name = 'Article\Common';
//實際會被當作完全限定名稱，也就表示Article空間下的Common類，但我下面只定義了Blog\Article空間而不是Article空間
$common = new $common_class_name(); //發生致命錯誤：Article\Common類不存在

namespace Blog\Article;

class Common { }

總結
我對PHP的命名空間剛剛接觸，也不能隨便給一些沒有實踐的建議。我個人認為命名空間的作用和功能都很強大，如果要寫外掛程式或者通用庫的時候再也不用擔心重名問題。不過如果項目進行到一定程度，要通過增加命名空間去解決重名問題，我覺得工作量不會比重構名字少。也不得不承認它的文法會對項目增加一定的複雜度，因此從項目一開始的時候就應該很好的規劃它，並制定一個命名規範。

本文章原先以中文撰寫並發佈於 aliyun.com，亦設英文版本，僅作資訊用途。本網站不對文章的準確性，完整性或可靠性或其任何翻譯作出任何明示或暗示的陳述或保證。如對該文章有任何疑慮或投訴，請傳送電郵至 info-contact@alibabacloud.com 並提供相關疑慮或投訴的詳細說明。職員會於 5 個工作天內與您聯絡，一經驗證之後，即會刪除該侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

Get Started for Free

Sales Support

1 on 1 presale consultation

Chat Contact Sales
After-Sales Support

24/7 Technical Support 6 Free Tickets per Quarter Faster Response

Open a Ticket
Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.

Learn More