PHP命名空間規(guī)則解析及高級(jí)功能
譯文【51CTO精選譯文】在第一部分中我們介紹了PHP命名空間的用途和namespace關(guān)鍵字，在這篇文章中我們將介紹一下use命令的使用以及PHP如何解析命名空間的名字的。
為了便于對(duì)比，我定義了兩個(gè)幾乎一樣的代碼塊，只有命名空間的名字不同。
lib1.php
- < ?php
- // application library 1
- namespace App\Lib1;
- const MYCONST = 'App\Lib1\MYCONST';
- function MyFunction() {
- return __FUNCTION__;
- }
- class MyClass {
- static function WhoAmI() {
- eturn __METHOD__;
- }
- }
- ?>
lib2.php
- < ?php
- // application library 2
- namespace App\Lib2;
- const MYCONST = 'App\Lib2\MYCONST';
- function MyFunction() {
- return __FUNCTION__;
- }
- class MyClass {
- static function WhoAmI() {
- eturn __METHOD__;
- }
- }
- ?>
開始之前先要理解幾個(gè)PHP命名空間相關(guān)術(shù)語。
◆完全限定名稱(Fully-qualified name)
任何PHP代碼都可以引用完全限定名稱，它是一個(gè)以命名空間反斜線開頭的標(biāo)識(shí)符，如\App\Lib1\MYCONST，\App\Lib2\MyFunction( )等。
完全限定名稱是沒有任何歧義的，開頭的反斜線和文件路徑的作用有點(diǎn)類似，它表示“根”全局空間，如果我們?cè)谌挚臻g中實(shí)現(xiàn)了一個(gè)不同的MyFunction( )，可以使用\MyFunction( )從lib1.php或lib2.php調(diào)用它。
完全限定名稱對(duì)一次性函數(shù)調(diào)用或?qū)ο蟪跏蓟浅Ｓ杏?，但?dāng)你產(chǎn)生了大量的調(diào)用時(shí)它們就沒有實(shí)用價(jià)值了，在下面的討論中我們將會(huì)看到，PHP提供了其它選項(xiàng)以解除我們?yōu)槊臻g打字的煩惱。
◆限定名稱(Qualified name)
至少有一個(gè)命名空間分隔符的標(biāo)識(shí)符，如Lib1\MyFunction( )。
◆非限定名稱(Unqualified name)
沒有命名空間分隔符的標(biāo)識(shí)符，如MyFunction( )。
在相同的命名空間內(nèi)工作
仔細(xì)思考下面的代碼：
myapp1.php
- < ?php
- namespace App\Lib1;
- require_once('lib1.php');
- require_once('lib2.php');
- header('Content-type: text/plain');
- echo MYCONST . "\n";
- echo MyFunction() . "\n";
- echo MyClass::WhoAmI() . "\n";
- ?>
即使我們同時(shí)包括了lib1.php和lib2.php，MYCONST，MyFunction和MyClass標(biāo)識(shí)符只能在lib1.php中引用，這是因?yàn)閙yapp1.php的代碼在相同的App\Lib1命名空間內(nèi)。
執(zhí)行結(jié)果：
- App\Lib1\MYCONST
- App\Lib1\MyFunction
- App\Lib1\MyClass::WhoAmI
命名空間導(dǎo)入
可以使用use操作符導(dǎo)入命名空間，如：
myapp2.php
- < ?php
- use App\Lib2;
- require_once('lib1.php');
- require_once('lib2.php');
- header('Content-type: text/plain');
- echo Lib2\MYCONST . "\n";
- echo Lib2\MyFunction() . "\n";
- echo Lib2\MyClass::WhoAmI() . "\n";
- ?>
可以定義任意數(shù)量的use語句，或使用逗號(hào)分隔成獨(dú)立的命名空間，在這個(gè)例子中我們導(dǎo)入了App\Lib2命名空間，但我們?nèi)匀徊荒苤苯右肕YCONST，MyFunction和MyClass，因?yàn)槲覀兊拇a還在全局空間中，但如果我們添加了“Lib2\”前綴，它們就變成限定名稱了，PHP將會(huì)搜索導(dǎo)入的命名空間，直到找到匹配項(xiàng)。
執(zhí)行結(jié)果：
- App\Lib2\MYCONST
- App\Lib2\MyFunction
- App\Lib2\MyClass::WhoAmI
命名空間別名
命名空間別名可能是最有用的構(gòu)想了，別名允許我們使用較短的名稱引用很長的命名空間。
myapp3.php
- < ?php
- use App\Lib1 as L;
- use App\Lib2\MyClass as Obj;
- header('Content-type: text/plain');
- require_once('lib1.php');
- require_once('lib2.php');
- echo L\MYCONST . "\n";
- echo L\MyFunction() . "\n";
- echo L\MyClass::WhoAmI() . "\n";
- echo Obj::WhoAmI() . "\n";
- ?>
第一個(gè)use語句將App\Lib1定義為“L”，任何使用“L”的限定名稱在編譯時(shí)都會(huì)被翻譯成“App\Lib1”，因此我們就可以引用L\MYCONST和L\MyFunction而不是完全限定名稱了。
第二個(gè)use語句定義了“obj”作為App\Lib2\命名空間中MyClass類的別名，這種方式只適合于類，不能用于常量和函數(shù)，現(xiàn)在我們就可以使用new Obj( )或象上面那樣運(yùn)行靜態(tài)方法了。
執(zhí)行結(jié)果：
- App\Lib1\MYCONST
- App\Lib1\MyFunction
- App\Lib1\MyClass::WhoAmI
- App\Lib2\MyClass::WhoAmI
PHP命名解析規(guī)則
PHP標(biāo)識(shí)符名稱使用下列命名空間規(guī)則進(jìn)行解析，請(qǐng)參考PHP用戶手冊(cè)了解更詳細(xì)的信息：
1.在編譯時(shí)調(diào)用完全限定函數(shù)、類或常量；
2.非限定名稱和限定名稱根據(jù)導(dǎo)入規(guī)則進(jìn)行翻譯，例如，如果A\B\C導(dǎo)入為C，調(diào)用C\D\e( )就會(huì)被翻譯成A\B\C\D\e( )；
3.在PHP命名空間內(nèi)，所有限定名稱尚未根據(jù)導(dǎo)入規(guī)則轉(zhuǎn)換，例如，如果在命名空間A\B中調(diào)用C\D\e( )，那么會(huì)被翻譯成A\B\C\D\e( )；
4.非限定類名稱根據(jù)當(dāng)前的導(dǎo)入規(guī)則進(jìn)行轉(zhuǎn)換，使用全名替換導(dǎo)入的短名稱，例如，如果類C在命名空間A\B中被導(dǎo)入為X，那么new X( )就會(huì)被翻譯為new A\B\C( )；
5.在命名空間中非限定函數(shù)調(diào)用在運(yùn)行時(shí)解析，例如，如果MyFunction( )在命名空間A\B中被調(diào)用，PHP首先會(huì)查找函數(shù)\A\B\MyFunction( )，如果沒有找到，然后會(huì)在全局空間中查找\MyFunction( )；
6.調(diào)用非限定或限定類名在運(yùn)行時(shí)被解析，例如，如果我們?cè)诿臻gA\B中調(diào)用new C( )，PHP將會(huì)查找類A\B\C，如果沒有找到，PHP會(huì)嘗試自動(dòng)載入A\B\C。
#p#
PHP命名空間高級(jí)特性
接下來讓我們看一看PHP命名空間的一些高級(jí)特性。
__NAMESPACE__常量
__NAMESPACE__是一個(gè)PHP字符串，它總是返回當(dāng)前命名空間的名稱，在全局空間中它是一個(gè)空字符串。
- < ?php
- namespace App\Lib1;
- echo __NAMESPACE__; // outputs: App\Lib1
- ?>
這個(gè)值在調(diào)試時(shí)非常有用，它也可由于動(dòng)態(tài)生成一個(gè)完全限定類名，如：
- < ?php
- namespace App\Lib1;
- class MyClass {
- public function WhoAmI() {
- return __METHOD__;
- }
- }
- $c = __NAMESPACE__ . '\\MyClass';
- $m = new $c;
- echo $m->WhoAmI(); // outputs: App\Lib1\MyClass::WhoAmI
- ?>
namespace關(guān)鍵字
namespace關(guān)鍵字可以用于明確引用一個(gè)當(dāng)前命名空間或子命名空間中的項(xiàng)目，它等價(jià)于類中的self命名空間：
- < ?php
- namespace App\Lib1;
- class MyClass {
- public function WhoAmI() {
- return __METHOD__;
- }
- }
- $m = new namespace\MyClass;
- echo $m->WhoAmI(); // outputs: App\Lib1\MyClass::WhoAmI
- ?>
自動(dòng)載入命名空間類
PHP 5中最省時(shí)省力的特性是自動(dòng)載入，在全局（非命名空間）PHP代碼中，可以寫一個(gè)標(biāo)準(zhǔn)自動(dòng)載入函數(shù)：
- < ?php
- $obj= new MyClass1(); // classes/MyClass1.php is auto-loaded
- $obj= new MyClass2(); // classes/MyClass2.php is auto-loaded
- // autoload function
- function __autoload($class_name) {
- require_once("classes/$class_name.php");
- }
- ?>
在PHP 5.3中，你可以創(chuàng)建一個(gè)命名空間類的實(shí)例，在這種情況下，完全限定命名空間和類名傳遞給__autoload函數(shù)，例如，$class_name的值可能是App\Lib1\MyClass。你可以在相同的文件夾下放置所有的PHP類文件，從字符串中提取命名空間，但那樣會(huì)導(dǎo)致文件名沖突。
另外，你的類文件層次結(jié)構(gòu)會(huì)按照命名空間的結(jié)構(gòu)重新組織，例如，MyClass.php文件可以創(chuàng)建在/classes/App/Lib1文件夾下：
/classes/App/Lib1/MyClass.php
- < ?php
- namespace App\Lib1;
- class MyClass {
- public function WhoAmI() {
- return __METHOD__;
- }
- }
- ?>
在根文件夾下的文件就使用下面的代碼了：
myapp.php
- < ?php
- use App\Lib1\MyClass as MC;
- $obj = new MC();
- echo $obj->WhoAmI();
- // autoload function
- function __autoload($class) {
- // convert namespace to full file path
- $class = 'classes/' . str_replace('\\', '/', $class) . '.php';
- require_once($class);
- }
- ?>
解釋：
1.類App\Lib1\MyClass的別名是MC；
2. new MC( )在編譯時(shí)被翻譯成new App\Lib1\MyClass( )；
3.字符串App\Lib1\MyClass被傳遞給__autoload函數(shù)，使用文件路徑正斜線替換所有命名空間中的反斜線，然后修改字符串，classes\App\Lib1\MyClass.php文件被自動(dòng)載入；
總結(jié)
有關(guān)PHP命名空間的使用就介紹到這里，希望您能夠?qū)HP的命名空間有一個(gè)新的認(rèn)識(shí)，并希望你能在新項(xiàng)目中真正使用命名空間。
原文：How to Use PHP Namespaces
作者：Craig Buckler
【編輯推薦】
