命名空間概述
什么是命名空間汁掠?從廣義上來說,命名空間是一種封裝事物的方法魂务。在很多地方都可以見到這種抽象概念曼验。例如,在操作系統(tǒng)中目錄用來將相關(guān)文件分組粘姜,對于目錄中的文件來說鬓照,它就扮演了命名空間的角色。具體舉個例子孤紧,文件foo.txt 可以同時在目錄/home/greg 和 /home/other 中存在豺裆,但在同一個目錄中不能存在兩個 foo.txt 文件。另外号显,在目錄 /home/greg 外訪問 foo.txt 文件時臭猜,我們必須將目錄名以及目錄分隔符放在文件名之前得到/home/greg/foo.txt。這個原理應(yīng)用到程序設(shè)計領(lǐng)域就是命名空間的概念押蚤。
PHP 命名空間(namespace)
PHP 命名空間(namespace)是在PHP 5.3中加入的蔑歌,如果你學過C#和Java,那命名空間就不算什么新事物揽碘。 不過在PHP當中還是有著相當重要的意義次屠。
PHP 命名空間可以解決以下兩類問題:
- 用戶編寫的代碼與PHP內(nèi)部的類/函數(shù)/常量或第三方類/函數(shù)/常量之間的名字沖突。
- 為很長的標識符名稱(通常是為了緩解第一類問題而定義的)創(chuàng)建一個別名(或簡短)的名稱钾菊,提高源代碼的可讀性帅矗。
定義命名空間
學過C#的可能印象非常深刻默認情況下,所有常量煞烫、類和函數(shù)名都放在全局空間下浑此,就和PHP支持命名空間之前一樣。
命名空間通過關(guān)鍵字namespace 來聲明滞详。如果一個文件中包含命名空間凛俱,它必須在其它所有代碼之前聲明命名空間紊馏。語法格式如下:
<?php
// 定義代碼在 'MyProject' 命名空間中
namespace MyProject;
// ... 代碼 ...
?>
你也可以在同一個文件中定義不同的命名空間代碼,如:
<?php
namespace MyProject;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
namespace AnotherProject;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
?>
不建議上面使用這種語法在單個文件中定義多個命名空間蒲犬。如果要使用建議用大括號裝起來
<?php
namespace MyProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
}
namespace AnotherProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
}
?>
如果將全局的非命名空間中的代碼與命名空間中的代碼組合在一起朱监,只能使用大括號。全局代碼必須用一個不帶名稱的 namespace 語句加上大括號括起來原叮,例如:
<?php
namespace MyProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
}
namespace { // 全局代碼
session_start();
$a = MyProject\connect();
echo MyProject\Connection::start();
}
?>
注意:在聲明命名空間之前唯一合法的代碼是用于定義源文件編碼方式的 declare 語句赫编。所有非 PHP 代碼包括空白符都不能出現(xiàn)在命名空間的聲明之前。
<?php
declare(encoding='UTF-8'); //定義多個命名空間和不包含在命名空間中的代碼
namespace MyProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
}
namespace { // 全局代碼
session_start();
$a = MyProject\connect();
echo MyProject\Connection::start();
}
?>
下面展示下上面所說的錯誤的方式:
<html>
<?php
namespace MyProject; // 命名空間前出現(xiàn)了“<html>” 會致命錯誤 - 命名空間必須是程序腳本的第一條語句
?>
子命名空間
與目錄和文件的關(guān)系很象奋隶,PHP 命名空間也允許指定層次化的命名空間的名稱擂送。因此,命名空間的名字可以使用分層次的方式定義.
下面的例子創(chuàng)建了常量 MyProject\Sub\Level\CONNECT_OK唯欣,類 MyProject\Sub\Level\Connection 和函數(shù) MyProject\Sub\Level\Connect嘹吨。
<?php
namespace MyProject\Sub\Level; //聲明分層次的單個命名空間
const CONNECT_OK = 1;
class Connection { /* ... */ }
function Connect() { /* ... */ }
?>
命名空間使用
個人理解命名空間的使用也就是通過命名空間來找到想要的類。
PHP 命名空間中的類名可以通過三種方式引用:
- 非限定名稱境氢,或不包含前綴的類名稱蟀拷,例如 $a=new foo(); 或 foo::staticmethod();。如果當前命名空間是 currentnamespace萍聊,foo 將被解析為 currentnamespace\foo问芬。如果使用 foo 的代碼是全局的,不包含在任何命名空間中的代碼脐区,則 foo 會被解析為foo愈诚。** 警告**:如果命名空間中的函數(shù)或常量未定義,則該非限定的函數(shù)名稱或常量名稱會被解析為全局函數(shù)名稱或常量名稱牛隅。
- 限定名稱,或包含前綴的名稱,例如 $a = new subnamespace\foo(); 或 subnamespace\foo::staticmethod();酌泰。如果當前的命名空間是 currentnamespace媒佣,則 foo 會被解析為 currentnamespace\subnamespace\foo。如果使用 foo 的代碼是全局的陵刹,不包含在任何命名空間中的代碼默伍,foo 會被解析為subnamespace\foo。
-
完全限定名稱衰琐,或包含了全局前綴操作符的名稱也糊,例如, $a = new \currentnamespace\foo(); 或 \currentnamespace\foo::staticmethod();羡宙。在這種情況下狸剃,foo 總是被解析為代碼中的文字名(literal name)currentnamespace\foo。
我用了幾個示例來表示它們:
<?php
//創(chuàng)建空間Blog
namespace Blog;
class Comment { }
//非限定名稱狗热,表示當前Blog空間
//這個調(diào)用將被解析成 Blog\Comment();
$blog_comment = new Comment();
//限定名稱钞馁,表示相對于Blog空間
//這個調(diào)用將被解析成 Blog\Article\Comment();
$article_comment = new Article\Comment(); //類前面沒有反斜桿\
//完全限定名稱虑省,表示絕對于Blog空間
//這個調(diào)用將被解析成 Blog\Comment();
$article_comment = new \Blog\Comment(); //類前面有反斜桿\
//完全限定名稱,表示絕對于Blog空間
//這個調(diào)用將被解析成 Blog\Article\Comment();
$article_comment = new \Blog\Article\Comment(); //類前面有反斜桿\
//創(chuàng)建Blog的子空間Article
namespace Blog\Article;
class Comment { }
?>
命名空間和動態(tài)語言特征
PHP 命名空間的實現(xiàn)受到其語言自身的動態(tài)特征的影響僧凰。因此探颈,如果要將下面的代碼轉(zhuǎn)換到命名空間中,動態(tài)訪問元素训措。
example1.php 文件代碼:
<?php
class classname
{
function __construct()
{
echo __METHOD__,"\n";
}
}
function funcname()
{
echo __FUNCTION__,"\n";
}
const constname = "global";
$a = 'classname';
$obj = new $a; // prints classname::__construct
$b = 'funcname';
$b(); // prints funcname
echo constant('constname'), "\n"; // prints global
?>
必須使用完全限定名稱(包括命名空間前綴的類名稱)伪节。注意因為在動態(tài)的類名稱、函數(shù)名稱或常量名稱中绩鸣,限定名稱和完全限定名稱沒有區(qū)別架馋,因此其前導(dǎo)的反斜杠是不必要的。
動態(tài)訪問命名空間的元素
<?php
namespace namespacename;
class classname
{
function __construct()
{
echo __METHOD__,"\n";
}
}
function funcname()
{
echo __FUNCTION__,"\n";
}
const constname = "namespaced";
include 'example1.php';
$a = 'classname';
$obj = new $a; // prints classname::__construct
$b = 'funcname';
$b(); // prints funcname
echo constant('constname'), "\n"; // prints global
/* note that if using double quotes, "\\namespacename\\classname" must be used */
$a = '\namespacename\classname';
$obj = new $a; // prints namespacename\classname::__construct
$a = 'namespacename\classname';
$obj = new $a; // also prints namespacename\classname::__construct
$b = 'namespacename\funcname';
$b(); // prints namespacename\funcname
$b = '\namespacename\funcname';
$b(); // also prints namespacename\funcname
echo constant('\namespacename\constname'), "\n"; // prints namespaced
echo constant('namespacename\constname'), "\n"; // also prints namespaced
?>
namespace關(guān)鍵字和NAMESPACE常量
PHP支持兩種抽象的訪問當前命名空間內(nèi)部元素的方法全闷,NAMESPACE 魔術(shù)常量和namespace關(guān)鍵字叉寂。
常量NAMESPACE的值是包含當前命名空間名稱的字符串。在全局的总珠,不包括在任何命名空間中的代碼屏鳍,它包含一個空的字符串。
NAMESPACE 示例, 在命名空間中的代碼:
<?php
namespace MyProject;
echo '"', __NAMESPACE__, '"'; // 輸出 "MyProject"
?>
NAMESPACE 示例局服,全局代碼
<?php
echo '"', __NAMESPACE__, '"'; // 輸出 ""
?>
常量 NAMESPACE 在動態(tài)創(chuàng)建名稱時很有用钓瞭,例如:
使用NAMESPACE動態(tài)創(chuàng)建名稱
<?php
namespace MyProject;
function get($classname)
{
$a = __NAMESPACE__ . '\\' . $classname;
return new $a;
}
?>
關(guān)鍵字 namespace 可用來顯式訪問當前命名空間或子命名空間中的元素。它等價于類中的 self 操作符淫奔。
namespace操作符山涡,命名空間中的代碼
<?php
namespace MyProject;
use blah\blah as mine; // see "Using namespaces: importing/aliasing"
blah\mine(); // calls function blah\blah\mine()
namespace\blah\mine(); // calls function MyProject\blah\mine()
namespace\func(); // calls function MyProject\func()
namespace\sub\func(); // calls function MyProject\sub\func()
namespace\cname::method(); // calls static method "method" of class MyProject\cname
$a = new namespace\sub\cname(); // instantiates object of class MyProject\sub\cname
$b = namespace\CONSTANT; // assigns value of constant MyProject\CONSTANT to $b
?>
namespace操作符, 全局代碼
<?php
namespace\func(); // calls function func()
namespace\sub\func(); // calls function sub\func()
namespace\cname::method(); // calls static method "method" of class cname
$a = new namespace\sub\cname(); // instantiates object of class sub\cname
$b = namespace\CONSTANT; // assigns value of constant CONSTANT to $b
?>
使用命名空間:別名/導(dǎo)入
PHP 命名空間支持 有兩種使用別名或?qū)敕绞剑簽轭惷Q使用別名,或為命名空間名稱使用別名唆迁。
在PHP中鸭丛,別名是通過操作符 use 來實現(xiàn)的. 下面是一個使用所有可能的三種導(dǎo)入方式的例子:
1、使用use操作符導(dǎo)入/使用別名
<?php
namespace foo;
use My\Full\Classname as Another;
// 下面的例子與 use My\Full\NSname as NSname 相同
use My\Full\NSname;
// 導(dǎo)入一個全局類
use \ArrayObject;
$obj = new namespace\Another; // 實例化 foo\Another 對象
$obj = new Another; // 實例化 My\Full\Classname 對象
NSname\subns\func(); // 調(diào)用函數(shù) My\Full\NSname\subns\func
$a = new ArrayObject(array(1)); // 實例化 ArrayObject 對象
// 如果不使用 "use \ArrayObject" 唐责,則實例化一個 foo\ArrayObject 對象
?>
2.一行中包含多個use語句
<?php
use My\Full\Classname as Another, My\Full\NSname;
$obj = new Another; // 實例化 My\Full\Classname 對象
NSname\subns\func(); // 調(diào)用函數(shù) My\Full\NSname\subns\func
?>
導(dǎo)入操作是在編譯執(zhí)行的鳞溉,但動態(tài)的類名稱、函數(shù)名稱或常量名稱則不是鼠哥。
3熟菲、導(dǎo)入和動態(tài)名稱
<?php
use My\Full\Classname as Another, My\Full\NSname;
$obj = new Another; // 實例化一個 My\Full\Classname 對象
$a = 'Another';
$obj = new $a; // 實際化一個 Another 對象
?>
另外,導(dǎo)入操作只影響非限定名稱和限定名稱朴恳。完全限定名稱由于是確定的抄罕,故不受導(dǎo)入的影響。
4于颖、導(dǎo)入和完全限定名稱
<?php
use My\Full\Classname as Another, My\Full\NSname;
$obj = new Another; // instantiates object of class My\Full\Classname
$obj = new \Another; // instantiates object of class Another
$obj = new Another\thing; // instantiates object of class My\Full\Classname\thing
$obj = new \Another\thing; // instantiates object of class Another\thing
?>
使用命名空間:后備全局函數(shù)/常量
在一個命名空間中呆贿,當 PHP 遇到一個非限定的類、函數(shù)或常量名稱時恍飘,它使用不同的優(yōu)先策略來解析該名稱榨崩。類名稱總是解析到當前命名空間中的名稱谴垫。因此在訪問系統(tǒng)內(nèi)部或不包含在命名空間中的類名稱時,必須使用完全限定名稱母蛛,例如:
1翩剪、在命名空間中訪問全局類
<?php
namespace A\B\C;
class Exception extends \Exception {}
$a = new Exception('hi'); // $a 是類 A\B\C\Exception 的一個對象
$b = new \Exception('hi'); // $b 是類 Exception 的一個對象
$c = new ArrayObject; // 致命錯誤, 找不到 A\B\C\ArrayObject 類
?>
對于函數(shù)和常量來說,如果當前命名空間中不存在該函數(shù)或常量彩郊,PHP 會退而使用全局空間中的函數(shù)或常量前弯。
2、 命名空間中后備的全局函數(shù)/常量
<?php
namespace A\B\C;
const E_ERROR = 45;
function strlen($str)
{
return \strlen($str) - 1;
}
echo E_ERROR, "\n"; // 輸出 "45"
echo INI_ALL, "\n"; // 輸出 "7" - 使用全局常量 INI_ALL
echo strlen('hi'), "\n"; // 輸出 "1"
if (is_array('hi')) { // 輸出 "is not array"
echo "is array\n";
} else {
echo "is not array\n";
}
?>
全局空間
如果沒有定義任何命名空間秫逝,所有的類與函數(shù)的定義都是在全局空間恕出,與 PHP 引入命名空間概念前一樣。在名稱前加上前綴 \ 表示該名稱是全局空間中的名稱违帆,即使該名稱位于其它的命名空間中時也是如此浙巫。
使用全局空間說明
<?php
namespace A\B\C;
/* 這個函數(shù)是 A\B\C\fopen */
function fopen() {
/* ... */
$f = \fopen(...); // 調(diào)用全局的fopen函數(shù)
return $f;
}
?>
命名空間的順序
自從有了命名空間之后,最容易出錯的該是使用類的時候刷后,這個類的尋找路徑是什么樣的了的畴。
<?php
namespace A;
use B\D, C\E as F;
// 函數(shù)調(diào)用
foo(); // 首先嘗試調(diào)用定義在命名空間"A"中的函數(shù)foo()
// 再嘗試調(diào)用全局函數(shù) "foo"
\foo(); // 調(diào)用全局空間函數(shù) "foo"
my\foo(); // 調(diào)用定義在命名空間"A\my"中函數(shù) "foo"
F(); // 首先嘗試調(diào)用定義在命名空間"A"中的函數(shù) "F"
// 再嘗試調(diào)用全局函數(shù) "F"
// 類引用
new B(); // 創(chuàng)建命名空間 "A" 中定義的類 "B" 的一個對象
// 如果未找到,則嘗試自動裝載類 "A\B"
new D(); // 使用導(dǎo)入規(guī)則尝胆,創(chuàng)建命名空間 "B" 中定義的類 "D" 的一個對象
// 如果未找到丧裁,則嘗試自動裝載類 "B\D"
new F(); // 使用導(dǎo)入規(guī)則,創(chuàng)建命名空間 "C" 中定義的類 "E" 的一個對象
// 如果未找到含衔,則嘗試自動裝載類 "C\E"
new \B(); // 創(chuàng)建定義在全局空間中的類 "B" 的一個對象
// 如果未發(fā)現(xiàn)煎娇,則嘗試自動裝載類 "B"
new \D(); // 創(chuàng)建定義在全局空間中的類 "D" 的一個對象
// 如果未發(fā)現(xiàn),則嘗試自動裝載類 "D"
new \F(); // 創(chuàng)建定義在全局空間中的類 "F" 的一個對象
// 如果未發(fā)現(xiàn)贪染,則嘗試自動裝載類 "F"
// 調(diào)用另一個命名空間中的靜態(tài)方法或命名空間函數(shù)
B\foo(); // 調(diào)用命名空間 "A\B" 中函數(shù) "foo"
B::foo(); // 調(diào)用命名空間 "A" 中定義的類 "B" 的 "foo" 方法
// 如果未找到類 "A\B" 缓呛,則嘗試自動裝載類 "A\B"
D::foo(); // 使用導(dǎo)入規(guī)則,調(diào)用命名空間 "B" 中定義的類 "D" 的 "foo" 方法
// 如果類 "B\D" 未找到抑进,則嘗試自動裝載類 "B\D"
\B\foo(); // 調(diào)用命名空間 "B" 中的函數(shù) "foo"
\B::foo(); // 調(diào)用全局空間中的類 "B" 的 "foo" 方法
// 如果類 "B" 未找到强经,則嘗試自動裝載類 "B"
// 當前命名空間中的靜態(tài)方法或函數(shù)
A\B::foo(); // 調(diào)用命名空間 "A\A" 中定義的類 "B" 的 "foo" 方法
// 如果類 "A\A\B" 未找到,則嘗試自動裝載類 "A\A\B"
\A\B::foo(); // 調(diào)用命名空間 "A\B" 中定義的類 "B" 的 "foo" 方法
// 如果類 "A\B" 未找到寺渗,則嘗試自動裝載類 "A\B"
?>
名稱解析遵循下列規(guī)則:
- 對完全限定名稱的函數(shù),類和常量的調(diào)用在編譯時解析兰迫。例如 new \A\B 解析為類 A\B信殊。
- 所有的非限定名稱和限定名稱(非完全限定名稱)根據(jù)當前的導(dǎo)入規(guī)則在編譯時進行轉(zhuǎn)換。例如汁果,如果命名空間 A\B\C 被導(dǎo)入為 C涡拘,那么對 C\D\e() 的調(diào)用就會被轉(zhuǎn)換為 A\B\C\D\e()。
- 在命名空間內(nèi)部据德,所有的沒有根據(jù)導(dǎo)入規(guī)則轉(zhuǎn)換的限定名稱均會在其前面加上當前的命名空間名稱鳄乏。例如跷车,在命名空間 A\B 內(nèi)部調(diào)用 C\D\e(),則 C\D\e() 會被轉(zhuǎn)換為 A\B\C\D\e() 橱野。
- 非限定類名根據(jù)當前的導(dǎo)入規(guī)則在編譯時轉(zhuǎn)換(用全名代替短的導(dǎo)入名稱)朽缴。例如,如果命名空間 A\B\C 導(dǎo)入為C水援,則 new C() 被轉(zhuǎn)換為 new A\B\C() 密强。
- 在命名空間內(nèi)部(例如A\B),對非限定名稱的函數(shù)調(diào)用是在運行時解析的蜗元。例如對函數(shù) foo() 的調(diào)用是這樣解析的:
a. 在當前命名空間中查找名為 A\B\foo() 的函數(shù)
b. 嘗試查找并調(diào)用 全局(global) 空間中的函數(shù) foo()或渤。 - 在命名空間(例如A\B)內(nèi)部對非限定名稱或限定名稱類(非完全限定名稱)的調(diào)用是在運行時解析的。下面是調(diào)用 new C() 及 new D\E() 的解析過程: new C()的解析:
a. 在當前命名空間中查找A\B\C類奕扣。
b. 嘗試自動裝載類A\B\C薪鹦。
new D\E()的解析:
a. 在類名稱前面加上當前命名空間名稱變成:A\B\D\E,然后查找該類惯豆。
b. 嘗試自動裝載類 A\B\D\E池磁。
為了引用全局命名空間中的全局類,必須使用完全限定名稱 new \C()循帐。
下一章將為你講述PHP中的“面向?qū)ο蟆保?/em>