《PHP 命名空間(namespace)》要點:
本文介紹了PHP 命名空間(namespace),希望對您有用。如果有疑問,可以聯系我們。
PHP 命名空間(namespace)是在PHP 5.3中加入的,如果你學過C#和Java,那命名空間就不算什么新事物. 不外在PHP當中還是有著相當重要的意義.
PHP 命名空間可以辦理以下兩類問題:
用戶編寫的代碼與PHP內部的類/函數/常量或第三方類/函數/常量之間的名字沖突.
為很長的標識符名稱(通常是為了緩解第一類問題而定義的)創建一個別號(或簡短)的名稱,提高源代碼的可讀性.
定義命名空間
默認情況下,所有常量、類和函數名都放在全局空間下,就和PHP支持命名空間之前一樣.
命名空間通過關鍵字namespace 來聲明.如果一個文件中包括命名空間,它必須在其它所有代碼之前聲明命名空間.語法格式如下;
< ?php
你也可以在同一個文件中定義分歧的命名空間代碼,如:
< ?php
在聲明命名空間之前唯一合法的代碼是用于定義源文件編碼方式的 declare 語句.所有非 PHP 代碼包含空白符都不能出現在命名空間的聲明之前.
<?php
以下代碼會出現語法差錯:
<html><?phpnamespace MyProject; // 命名空間前出現了“<html>” 會致命錯誤 - 命名空間必需是程序腳本的第一條語句?>
子命名空間
與目錄和文件的關系很象,PHP 命名空間也允許指定條理化的命名空間的名稱.因此,命名空間的名字可以使用分條理的方式定義:
<?phpnamespace MyProject\Sub\Level; //聲明分條理的單個命名空間const CONNECT_OK = 1;class Connection { /* ... */ }function Connect() { /* ... */ }?>
上面的例子創建了常量 MyProject\Sub\Level\CONNECT_OK,類 MyProject\Sub\Level\Connection 和函數 MyProject\Sub\Level\Connect.
命名空間使用
PHP 命名空間中的類名可以通過三種方式引用:
非限定名稱,或不包括前綴的類名稱,例如 $a=new foo(); 或 foo::staticmethod();.如果當前命名空間是 currentnamespace,foo 將被解析為 currentnamespace\foo.如果使用 foo 的代碼是全局的,不包括在任何命名空間中的代碼,則 foo 會被解析為foo. 警告:如果命名空間中的函數或常量未定義,則該非限定的函數名稱或常量名稱會被解析為全局函數名稱或常量名稱.
限定名稱,或包括前綴的名稱,例如 $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.
下面是一個使用這三種方式的實例:
file1.php 文件代碼
<?phpnamespace Foo\Bar\subnamespace; const FOO = 1;function foo() {}class foo{
file2.php 文件代碼
<?phpnamespace Foo\Bar;include 'file1.php';const FOO = 2;function foo() {}class foo{
注意拜訪任意全局類、函數或常量,都可以使用完全限定名稱,例如 \strlen() 或 \Exception 或 \INI_ALL.
在命名空間內部拜訪全局類、函數和常量:
<?phpnamespace Foo;function strlen() {}const INI_ALL = 3;class Exception {}$a = \strlen('hi'); // 調用全局函數strlen$b = \INI_ALL; // 拜訪全局常量 INI_ALL$c = new \Exception('error'); // 實例化全局類 Exception?>
命名空間和動態語言特征
PHP 命名空間的實現受到其語言自身的動態特征的影響.因此,如果要將下面的代碼轉換到命名空間中,動態拜訪元素.
example1.php 文件代碼:
<?phpclass classname{
必須使用完全限定名稱(包含命名空間前綴的類名稱).注意因為在動態的類名稱、函數名稱或常量名稱中,限定名稱和完全限定名稱沒有區別,因此其前導的反斜杠是不必要的.
動態拜訪命名空間的元素
<?phpnamespace namespacename;class classname{
namespace關鍵字和__NAMESPACE__常量
PHP支持兩種抽象的拜訪當前命名空間內部元素的方法,__NAMESPACE__ 魔術常量和namespace關鍵字.
常量__NAMESPACE__的值是包括當前命名空間名稱的字符串.在全局的,不包括在任何命名空間中的代碼,它包括一個空的字符串.
__NAMESPACE__ 示例, 在命名空間中的代碼
<?phpnamespace MyProject;echo '"', __NAMESPACE__, '"'; // 輸出 "MyProject"?>
__NAMESPACE__ 示例,全局代碼
<?php
常量 __NAMESPACE__ 在動態創建名稱時很有用,例如:
使用__NAMESPACE__動態創建名稱
<?phpnamespace MyProject;function get($classname){
關鍵字 namespace 可用來顯式拜訪當前命名空間或子命名空間中的元素.它等價于類中的 self 操作符.
namespace操作符,命名空間中的代碼
<?phpnamespace 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操作符, 全局代碼
<?phpnamespace\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?>
使用命名空間:別號/導入
PHP 命名空間支持 有兩種使用別號或導入方式:為類名稱使用別號,或為命名空間名稱使用別號.注意PHP不支持導入函數或常量.
在PHP中,別號是通過操作符 use 來實現的. 下面是一個使用所有可能的三種導入方式的例子:
1、使用use操作符導入/使用別號
<?phpnamespace foo;use My\Full\Classname as Another;// 下面的例子與 use My\Full\NSname as NSname 相同use My\Full\NSname;// 導入一個全局類use \ArrayObject;$obj = new namespace\Another; // 實例化 foo\Another 對象$obj = new Another; // 實例化 My\Full\Classname 對象NSname\subns\func(); // 調用函數 My\Full\NSname\subns\func$a = new ArrayObject(array(1)); // 實例化 ArrayObject 對象// 如果不使用 "use \ArrayObject" ,則實例化一個 foo\ArrayObject 對象?>
2、 一行中包括多個use語句
<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // 實例化 My\Full\Classname 對象NSname\subns\func(); // 調用函數 My\Full\NSname\subns\func?>
導入操作是在編譯執行的,但動態的類名稱、函數名稱或常量名稱則不是.
3、導入和動態名稱
<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // 實例化一個 My\Full\Classname 對象$a = 'Another';$obj = new $a; // 實際化一個 Another 對象?>
另外,導入操作只影響非限定名稱和限定名稱.完全限定名稱由于是確定的,故不受導入的影響.
4、導入和完全限定名稱
<?phpuse 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?>
使用命名空間:后備全局函數/常量
在一個命名空間中,當 PHP 遇到一個非限定的類、函數或常量名稱時,它使用不同的優先策略來解析該名稱.類名稱總是解析到當前命名空間中的名稱.因此在拜訪系統內部或不包含在命名空間中的類名稱時,必須使用完全限定名稱,例如:
1、在命名空間中拜訪全局類
<?phpnamespace 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 類?>
對于函數和常量來說,如果當前命名空間中不存在該函數或常量,PHP 會退而使用全局空間中的函數或常量.
2、 命名空間中后備的全局函數/常量
<?phpnamespace A\B\C;const E_ERROR = 45;function strlen($str){
全局空間
如果沒有定義任何命名空間,所有的類與函數的定義都是在全局空間,與 PHP 引入命名空間概念前一樣.在名稱前加上前綴 \ 表現該名稱是全局空間中的名稱,即使該名稱位于其它的命名空間中時也是如此.
使用全局空間闡明
<?phpnamespace A\B\C;/* 這個函數是 A\B\C\fopen */function fopen() {
命名空間的順序
自從有了命名空間之后,最容易出錯的該是使用類的時候,這個類的尋找路徑是什么樣的了.
<?phpnamespace A;use B\D, C\E as F;// 函數調用foo(); // 首先測驗考試調用定義在命名空間"A"中的函數foo()
名稱解析遵循下列規則:
對完全限定名稱的函數,類和常量的調用在編譯時解析.例如 new \A\B 解析為類 A\B.
所有的非限定名稱和限定名稱(非完全限定名稱)根據當前的導入規則在編譯時進行轉換.例如,如果命名空間 A\B\C 被導入為 C,那么對 C\D\e() 的調用就會被轉換為 A\B\C\D\e().
在命名空間內部,所有的沒有根據導入規則轉換的限定名稱均會在其前面加上當前的命名空間名稱.例如,在命名空間 A\B 內部調用 C\D\e(),則 C\D\e() 會被轉換為 A\B\C\D\e() .
非限定類名根據當前的導入規則在編譯時轉換(用全名代替短的導入名稱).例如,如果命名空間 A\B\C 導入為C,則 new C() 被轉換為 new A\B\C() .
在命名空間內部(例如A\B),對非限定名稱的函數調用是在運行時解析的.例如對函數 foo() 的調用是這樣解析的:
在當前命名空間中查找名為 A\B\foo() 的函數
測驗考試查找并調用 全局(global) 空間中的函數 foo().
在命名空間(例如A\B)內部對非限定名稱或限定名稱類(非完全限定名稱)的調用是在運行時解析的.下面是調用 new C() 及 new D\E() 的解析過程: new C()的解析:new D\E()的解析:為了引用全局命名空間中的全局類,必需使用完全限定名稱 new \C().
在類名稱前面加上當前命名空間名稱釀成:A\B\D\E,然后查找該類.
測驗考試自動裝載類 A\B\D\E.
在當前命名空間中查找A\B\C類.
測驗考試自動裝載類A\B\C.
維易PHP培訓學院每天教你實戰技能,PHP、MYSQL、LINUX、APP、JS,CSS全面培養人才。