php命名空間詳解

對(duì)于命名空間浴讯,官方文檔已經(jīng)說(shuō)得很詳細(xì)[查看]寓调,我在這里做了一下實(shí)踐和總結(jié)豆混。

命名空間一個(gè)最明確的目的就是解決重名問(wèn)題媚媒,PHP中不允許兩個(gè)函數(shù)或者類出現(xiàn)相同的名字嗜逻,否則會(huì)產(chǎn)生一個(gè)致命的錯(cuò)誤。這種情況下只要避免命名重復(fù)就可以解決缭召,最常見(jiàn)的一種做法是約定一個(gè)前綴栈顷。

例:項(xiàng)目中有兩個(gè)模塊:article和message board,它們各自有一個(gè)處理用戶留言的類Comment嵌巷。之后我可能想要增加對(duì)所有用戶留言的一些信息統(tǒng)計(jì)功能萄凤,比如說(shuō)我想得到所有留言的數(shù)量。這時(shí)候調(diào)用它們Comment提供的方法是很好的做法搪哪,但是同時(shí)引入各自的Comment類顯然是不行的靡努,代碼會(huì)出錯(cuò),在另一個(gè)地方重寫(xiě)任何一個(gè)Comment也會(huì)降低維護(hù)性晓折。那這時(shí)只能重構(gòu)類名惑朦,我約定了一個(gè)命名規(guī)則,在類名前面加上模塊名已维,像這樣:Article_Comment、MessageBoard_Comment

可以看到已日,名字變得很長(zhǎng)垛耳,那意味著以后使用Comment的時(shí)候會(huì)寫(xiě)上更多的代碼(至少字符多了)。并且飘千,以后如果要對(duì)各個(gè)模塊增加更多的一些整合功能堂鲜,或者是互相調(diào)用,發(fā)生重名的時(shí)候就需要重構(gòu)名字护奈。當(dāng)然在項(xiàng)目開(kāi)始的時(shí)候就注意到這個(gè)問(wèn)題缔莲,并規(guī)定命名規(guī)則就能很好的避免這個(gè)問(wèn)題。另一個(gè)解決方法可以考慮使用命名空間霉旗。

注明:

本文提到的常量:PHP5.3開(kāi)始const關(guān)鍵字可以用在類的外部痴奏。const和define都是用來(lái)聲明常量的(它們的區(qū)別不詳述),但是在命名空間里厌秒,define的作用是全局的读拆,而const則作用于當(dāng)前空間。我在文中提到的常量是指使用const聲明的常量鸵闪。

基礎(chǔ)

命名空間將代碼劃分出不同的空間(區(qū)域)檐晕,每個(gè)空間的常量、函數(shù)、類(為了偷懶辟灰,我下邊都將它們稱為元素)的名字互不影響个榕, 這個(gè)有點(diǎn)類似我們常常提到的‘封裝'的概念。

創(chuàng)建一個(gè)命名空間需要使用namespace關(guān)鍵字芥喇,這樣:

復(fù)制代碼代碼如下:


//創(chuàng)建一個(gè)名為'Article'的命名空間

namespace Article;

?>

要注意的是西采,當(dāng)前腳本文件的第一個(gè)命名空間前面不能有任何代碼,下面的寫(xiě)法都是錯(cuò)誤的:

復(fù)制代碼代碼如下:

//例一

//在腳本前面寫(xiě)了一些邏輯代碼

PHP

$path = "/";

class Comment { }

namespace Article;

?>

//例二

//在腳本前面輸出了一些字符

PHP

namespace Article;

?>

為什么要說(shuō)第一個(gè)命名空間呢乃坤?因?yàn)橥荒_本文件中可以創(chuàng)建多個(gè)命名空間苛让。

下面我創(chuàng)建了兩個(gè)命名空間,順便為這兩個(gè)空間各自添加了一個(gè)Comment類元素:

復(fù)制代碼代碼如下:


//創(chuàng)建一個(gè)名為'Article'的命名空間

namespace Article;

//此Comment屬于Article空間的元素

class Comment { }

//創(chuàng)建一個(gè)名為'MessageBoard'的命名空間

namespace MessageBoard;

//此Comment屬于MessageBoard空間的元素

class Comment { }

?>

在不同空間之間不可以直接調(diào)用其它元素湿诊,需要使用命名空間的語(yǔ)法:

復(fù)制代碼代碼如下:


namespace Article;

class Comment { }

namespace MessageBoard;

class Comment { }

//調(diào)用當(dāng)前空間(MessageBoard)的Comment類

$comment = new Comment();

//調(diào)用Article空間的Comment類

$article_comment = new \Article\Comment();

?>

可以看到狱杰,在MessageBoard空間中調(diào)用article空間里的Comment類時(shí),使用了一種像文件路徑的語(yǔ)法: \空間名\元素名

除了類之外厅须,對(duì)函數(shù)和常量的用法是一樣的仿畸,下面我為兩個(gè)空間創(chuàng)建了新的元素,并在MessageBoard空間中輸出了它們的值朗和。

復(fù)制代碼代碼如下:


namespace Article;

const PATH = '/article';

function getCommentTotal() {

return 100;

}

class Comment { }

namespace MessageBoard;

const PATH = '/message_board';

function getCommentTotal() {

return 300;

}

class Comment { }

//調(diào)用當(dāng)前空間的常量错沽、函數(shù)和類

echo PATH; ///message_board

echo getCommentTotal(); //300

$comment = new Comment();

//調(diào)用Article空間的常量、函數(shù)和類

echo \Article\PATH; ///article

echo \Article\getCommentTotal(); //100

$article_comment = new \Article\Comment();

?>

然后我的確得到了Article空間的元素?cái)?shù)據(jù)眶拉。

子空間

命名空間的調(diào)用語(yǔ)法像文件路徑一樣是有道理的千埃,它允許我們自定義子空間來(lái)描述各個(gè)空間之間的關(guān)系。

抱歉我忘了說(shuō)忆植,article和message board這兩個(gè)模塊其實(shí)都是處于同一個(gè)blog項(xiàng)目?jī)?nèi)放可。如果用命名空間來(lái)表達(dá)它們的關(guān)系,是這樣:

復(fù)制代碼代碼如下:


//我用這樣的命名空間表示處于blog下的article模塊

namespace Blog\Article;

class Comment { }

//我用這樣的命名空間表示處于blog下的message board模塊

namespace Blog\MessageBoard;

class Comment { }

//調(diào)用當(dāng)前空間的類

$comment = new Comment();

//調(diào)用Blog\Article空間的類

$article_comment = new \Blog\Article\Comment();

?>

而且朝刊,子空間還可以定義很多層次耀里,比如說(shuō) Blog\Article\Archives\Date

公共空間

我有一個(gè)common_inc.php腳本文件,里面有一些好用的函數(shù)和類:

復(fù)制代碼代碼如下:


function getIP() { }

class FilterXSS { }

?>

在一個(gè)命名空間里引入這個(gè)腳本拾氓,腳本里的元素不會(huì)歸屬到這個(gè)命名空間冯挎。如果這個(gè)腳本里沒(méi)有定義其它命名空間,它的元素就始終處于公共空間中:

復(fù)制代碼代碼如下:


namespace Blog\Article;

//引入腳本文件

include './common_inc.php';

$filter_XSS = new FilterXSS(); //出現(xiàn)致命錯(cuò)誤:找不到Blog\Article\FilterXSS類

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

?>

調(diào)用公共空間的方式是直接在元素名稱前加 \ 就可以了咙鞍,否則PHP解析器會(huì)認(rèn)為我想調(diào)用當(dāng)前空間下的元素房官。除了自定義的元素,還包括PHP自帶的元素续滋,都屬于公共空間易阳。

要提一下,其實(shí)公共空間的函數(shù)和常量不用加 \ 也可以正常調(diào)用(不明白PHP為什么要這樣做)吃粒,但是為了正確區(qū)分元素潦俺,還是建議調(diào)用函數(shù)的時(shí)候加上 \

名稱術(shù)語(yǔ)

在說(shuō)別名和導(dǎo)入之前,需要知道關(guān)于空間三種名稱的術(shù)語(yǔ),以及PHP是怎樣解析它們的事示。官方文檔說(shuō)得非常好早像,我就直接拿來(lái)套了。

1.非限定名稱肖爵,或不包含前綴的類名稱卢鹦,例如 $comment = new Comment();。如果當(dāng)前命名空間是Blog\Article劝堪,Comment將被解析為Blog\Article\Comment冀自。如果使用Comment的代碼不包含在任何命名空間中的代碼(全局空間中),則Comment會(huì)被解析為Comment秒啦。

2.限定名稱熬粗,或包含前綴的名稱,例如 $comment = new Article\Comment();余境。如果當(dāng)前的命名空間是Blog驻呐,則Comment會(huì)被解析為Blog\Article\Comment。如果使用Comment的代碼不包含在任何命名空間中的代碼(全局空間中)芳来,則Comment會(huì)被解析為Comment含末。

3.完全限定名稱,或包含了全局前綴操作符的名稱即舌,例如 $comment = new \Article\Comment();佣盒。在這種情況下,Comment總是被解析為代碼中的文字名(literal name)Article\Comment顽聂。

其實(shí)可以把這三種名稱類比為文件名(例如 comment.php)肥惭、相對(duì)路徑名(例如 ./article/comment.php)、絕對(duì)路徑名(例如 /blog/article/comment.php)芜飘,這樣可能會(huì)更容易理解务豺。

我用了幾個(gè)示例來(lái)表示它們:

復(fù)制代碼代碼如下:


//創(chuàng)建空間Blog

namespace Blog;

class Comment { }

//非限定名稱磨总,表示當(dāng)前Blog空間

//這個(gè)調(diào)用將被解析成 Blog\Comment();

$blog_comment = new Comment();

//限定名稱嗦明,表示相對(duì)于Blog空間

//這個(gè)調(diào)用將被解析成 Blog\Article\Comment();

$article_comment = new Article\Comment(); //類前面沒(méi)有反斜桿\

//完全限定名稱,表示絕對(duì)于Blog空間

//這個(gè)調(diào)用將被解析成 Blog\Comment();

$article_comment = new \Blog\Comment(); //類前面有反斜桿\

//完全限定名稱蚪燕,表示絕對(duì)于Blog空間

//這個(gè)調(diào)用將被解析成 Blog\Article\Comment();

$article_comment = new \Blog\Article\Comment(); //類前面有反斜桿\

//創(chuàng)建Blog的子空間Article

namespace Blog\Article;

class Comment { }

?>

其實(shí)之前我就一直在使用非限定名稱和完全限定名稱娶牌,現(xiàn)在它們終于可以叫出它們的名稱了。

別名和導(dǎo)入

別名和導(dǎo)入可以看作是調(diào)用命名空間元素的一種快捷方式馆纳。PHP并不支持導(dǎo)入函數(shù)或常量诗良。

它們都是通過(guò)使用use操作符來(lái)實(shí)現(xiàn):

復(fù)制代碼代碼如下:


namespace Blog\Article;

class Comment { }

//創(chuàng)建一個(gè)BBS空間(我有打算開(kāi)個(gè)論壇)

namespace BBS;

//導(dǎo)入一個(gè)命名空間

use Blog\Article;

//導(dǎo)入命名空間后可使用限定名稱調(diào)用元素

$article_comment = new Article\Comment();

//為命名空間使用別名

use Blog\Article as Arte;

//使用別名代替空間名

$article_comment = new Arte\Comment();

//導(dǎo)入一個(gè)類

use Blog\Article\Comment;

//導(dǎo)入類后可使用非限定名稱調(diào)用元素

$article_comment = new Comment();

//為類使用別名

use Blog\Article\Comment as Comt;

//使用別名代替空間名

$article_comment = new Comt();

?>

我注意到,如果導(dǎo)入元素的時(shí)候鲁驶,當(dāng)前空間有相同的名字元素將會(huì)怎樣鉴裹?顯然結(jié)果會(huì)發(fā)生致命錯(cuò)誤。

例:

復(fù)制代碼代碼如下:


namespace Blog\Article;

class Comment { }

namespace BBS;

class Comment { }

Class Comt { }

//導(dǎo)入一個(gè)類

use Blog\Article\Comment;

$article_comment = new Comment(); //與當(dāng)前空間的Comment發(fā)生沖突,程序產(chǎn)生致命錯(cuò)誤

//為類使用別名

use Blog\Article\Comment as Comt;

$article_comment = new Comt(); //與當(dāng)前空間的Comt發(fā)生沖突径荔,程序產(chǎn)生致命錯(cuò)誤

?>

動(dòng)態(tài)調(diào)用

PHP提供了namespace關(guān)鍵字和__NAMESPACE__魔法常量動(dòng)態(tài)的訪問(wèn)元素督禽,__NAMESPACE__可以通過(guò)組合字符串的形式來(lái)動(dòng)態(tài)訪問(wèn):

復(fù)制代碼代碼如下:


namespace Blog\Article;

const PATH = '/Blog/article';

class Comment { }

//namespace關(guān)鍵字表示當(dāng)前空間

echo namespace\PATH; ///Blog/article

$comment = new namespace\Comment();

//魔法常量__NAMESPACE__的值是當(dāng)前空間名稱

echo __NAMESPACE__; //Blog\Article

//可以組合成字符串并調(diào)用

$comment_class_name = __NAMESPACE__ . '\Comment';

$comment = new $comment_class_name();

?>

字符串形式調(diào)用問(wèn)題

上面的動(dòng)態(tài)調(diào)用的例子中,我們看到了字符串形式的動(dòng)態(tài)調(diào)用方式总处,如果要使用這種方式要注意兩個(gè)問(wèn)題狈惫。

1. 使用雙引號(hào)的時(shí)候特殊字符可能被轉(zhuǎn)義

復(fù)制代碼代碼如下:


namespace Blog\Article;

class name { }

//我是想調(diào)用Blog\Article\name

$class_name = __NAMESPACE__ . "\name"; //但是\n將被轉(zhuǎn)義為換行符

$name = new $class_name(); //發(fā)生致命錯(cuò)誤

?>

2. 不會(huì)認(rèn)為是限定名稱

PHP在編譯腳本的時(shí)候就確定了元素所在的空間,以及導(dǎo)入的情況鹦马。而在解析腳本時(shí)字符串形式調(diào)用只能認(rèn)為是非限定名稱和完全限定名稱胧谈,而永遠(yuǎn)不可能是限定名稱。

復(fù)制代碼代碼如下:


namespace Blog;

//導(dǎo)入Common類

use Blog\Article\Common;

//我想使用非限定名稱調(diào)用Blog\Article\Common

$common_class_name = 'Common';

//實(shí)際會(huì)被當(dāng)作非限定名稱荸频,也就表示當(dāng)前空間的Common類菱肖,但我當(dāng)前類沒(méi)有創(chuàng)建Common類

$common = new $common_class_name(); //發(fā)生致命錯(cuò)誤:Common類不存在

//我想使用限定名稱調(diào)用Blog\Article\Common

$common_class_name = 'Article\Common';

//實(shí)際會(huì)被當(dāng)作完全限定名稱,也就表示Article空間下的Common類试溯,但我下面只定義了Blog\Article空間而不是Article空間

$common = new $common_class_name(); //發(fā)生致命錯(cuò)誤:Article\Common類不存在

namespace Blog\Article;

class Common { }

?>

互聯(lián)網(wǎng)+時(shí)代蔑滓,時(shí)刻要保持學(xué)習(xí),攜手千鋒PHP,Dream It Possible遇绞。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末键袱,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子摹闽,更是在濱河造成了極大的恐慌蹄咖,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,640評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件付鹿,死亡現(xiàn)場(chǎng)離奇詭異澜汤,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)舵匾,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,254評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén)俊抵,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人坐梯,你說(shuō)我怎么就攤上這事徽诲。” “怎么了吵血?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,011評(píng)論 0 355
  • 文/不壞的土叔 我叫張陵谎替,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我蹋辅,道長(zhǎng)钱贯,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,755評(píng)論 1 294
  • 正文 為了忘掉前任侦另,我火速辦了婚禮秩命,結(jié)果婚禮上尉共,老公的妹妹穿的比我還像新娘。我一直安慰自己弃锐,他們只是感情好爸邢,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,774評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著拿愧,像睡著了一般杠河。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上浇辜,一...
    開(kāi)封第一講書(shū)人閱讀 51,610評(píng)論 1 305
  • 那天券敌,我揣著相機(jī)與錄音,去河邊找鬼柳洋。 笑死待诅,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的熊镣。 我是一名探鬼主播卑雁,決...
    沈念sama閱讀 40,352評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼绪囱!你這毒婦竟也來(lái)了测蹲?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 39,257評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤鬼吵,失蹤者是張志新(化名)和其女友劉穎扣甲,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體齿椅,經(jīng)...
    沈念sama閱讀 45,717評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡琉挖,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,894評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了涣脚。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片示辈。...
    茶點(diǎn)故事閱讀 40,021評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖遣蚀,靈堂內(nèi)的尸體忽然破棺而出矾麻,到底是詐尸還是另有隱情,我是刑警寧澤妙同,帶...
    沈念sama閱讀 35,735評(píng)論 5 346
  • 正文 年R本政府宣布射富,位于F島的核電站膝迎,受9級(jí)特大地震影響粥帚,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜限次,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,354評(píng)論 3 330
  • 文/蒙蒙 一芒涡、第九天 我趴在偏房一處隱蔽的房頂上張望柴灯。 院中可真熱鬧,春花似錦费尽、人聲如沸赠群。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,936評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)查描。三九已至,卻和暖如春柏卤,著一層夾襖步出監(jiān)牢的瞬間冬三,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,054評(píng)論 1 270
  • 我被黑心中介騙來(lái)泰國(guó)打工缘缚, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留勾笆,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,224評(píng)論 3 371
  • 正文 我出身青樓桥滨,卻偏偏與公主長(zhǎng)得像窝爪,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子齐媒,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,974評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容

  • 對(duì)于命名空間蒲每,官方文檔已經(jīng)說(shuō)得很詳細(xì)[查看],我在這里做了一下實(shí)踐和總結(jié)喻括。 命名空間一個(gè)最明確的目的就是解決重名問(wèn)...
    斯文小螞蟻閱讀 378評(píng)論 0 0
  • 收藏自cnblog啃勉,寫(xiě)的非常清晰,感謝作者‘流金歲月’http://www.cnblogs.com/kuyuecs...
    InitialX閱讀 1,197評(píng)論 0 5
  • 對(duì)于命名空間双妨,官方文檔已經(jīng)說(shuō)得很詳細(xì)[查看]淮阐,我在這里做了一下實(shí)踐和總結(jié)。 命名空間一個(gè)最明確的目的就是解決重名問(wèn)...
    司馬東陽(yáng)閱讀 240評(píng)論 0 0
  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理刁品,服務(wù)發(fā)現(xiàn)泣特,斷路器,智...
    卡卡羅2017閱讀 134,659評(píng)論 18 139
  • 已經(jīng)同步到gitbook挑随,想閱讀的請(qǐng)轉(zhuǎn)到gitbook: Django 1.10 中文文檔 URL dispatc...
    leyu閱讀 14,205評(píng)論 0 16