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


對於命名空間,官方的文檔已經說的很詳細,在這里我做了一下實踐和總結。

 

命名空間一個最明確的目的就是解決重名問題。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 
// 創建一個名為“Article”的命名空間
namespace Article;
// 此Comment屬於Article空間的元素
class Comment{}
 
// 創建一個名為“MessageBoard”的命名空間
namespace MessageBoard;
// 此Comment屬於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;
echo getCommentTotal();
$comment =  new Comment();
 
// 調用Article空間的常量、函數和類
echo \Article\PATH;
echo \Article\getCommentTotal();
$article_comment =  new \Article\Comment();
?>

 

子空間:命名空間的調用語法像文件路徑一樣是有道理的,它允許我們自定義子空間來描述各個空間之間的關系。

 

Article和message board這兩個模塊都是處於同一個blog項目內。如果用命名空間來表示它們的關系,是這樣:

 

<?php 
// 我用這樣的命名空間表示處於blog下的article模塊
namespace Blog\Article;
class Comment{}
 
// 我用這樣的命名空間來表示處於blog下的message board模塊
namespace Blog\MessageBlog;
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是怎樣解析它們的。

 

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 
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{}
 
// 創建一個BBS空間
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;
$comment =  new namespace\Comment();
 
// 魔法常量__NAMESPACE__的值是當前空間的名稱
echo __NAMESPACE__;
 
// 可以組合成字符串並調用
$comment_class_name = __NAMESPACE__.'\Comment';
$comment =  new  $comment_class_name();
?>

 

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

1、使用雙引號的時候特殊字符串可能被轉義

 

<?php 
namespace Blog\Article;
const PATH = '/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類不存在
//$common = new Common();
 
 
//我想使用限定名稱調用Blog\Article\Common

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

 
namespace Blog\Article;
class Common{}
?>

 



免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM