PHP的命名空間(namespace)是php5.3之後才有的。這個概念在C#中已經很早就有了,php中的namespace其實和c#的概念是一樣的。
為什麼php中要使用namespace?
假設如果不使用namespace,那麼每個類在一個項目中的名字就必須是固定的。因為php在new的時候不管是調用autoload還是調用已加載過的類,都存在一個類名對應的文件。所以在沒有namespace的時候,我們會想各種命名規則來區分不同的類,比如project1_school1_class1_Student或者project2_school_class_Student。
引入namespace之後就可以將這個有效規避了,一個namespace就相當於對應一個文件路徑,查找這個類的時候,就會去對應的文件路徑查找類定義文件了。
背景
最近有個朋友問我 PHP 命名空間是咋樣的,但是由於長期不做開發,筆者實際上也已經忘得差不多了,所以也回答不出來。只是記得和 Java 挺像的。事後重新查了一下 PHP 的官方文檔,並且和 Java 做對比,Java 的命名空間實際上來自於 JVM 本身的機制,JVM 是基於 class 字節碼文件加載類,由於類很容易出現重名的情況,換言之 class 字節碼文件也會出現重名情況,所以就需要使用目錄來管理不同的字節碼文件,而為了保證加載正常,所以就需要命名空間這種機制。當然,也可以說是由於命名空間的存在才有了目錄管理的方式。但是 PHP 和 Java 不一樣,PHP 是一種動態腳本語言,它的代碼分散在所有腳本中,當需要的時候才會使用 include 函數加載對應的文件,所以 PHP 的命名空間,實際上是基於 PHP 的自動加載類,自動加載類實現了才能保證 PHP 命名空間存在的意義。
命名空間概述
命名空間據筆者所知應該最早源於 C++ 語言,在 C++98 標准以後,為了保證各種命名不重合所推出的一種解決方案。現在的面向對象語言基本都有這種機制,當然除了命名空間以外,還有很多種方式,比如模塊化,不過實際上這些機制都是用來解決封裝問題的,所以筆者個人認為並無好壞之分。先把 PHP 官方文檔代碼拉出來溜溜
<?php namespace my\name; // 參考 "定義命名空間" 小節 class MyClass {} function myfunction() {} const MYCONST = 1; $a = new MyClass; $c = new \my\name\MyClass; // 參考 "全局空間" 小節 $a = strlen('hi'); // 參考 "使用命名空間:後備全局函數/常量" 小節 $d = namespace\MYCONST; // 參考 "namespace操作符和__NAMESPACE__常量” 小節 $d = __NAMESPACE__ . '\MYCONST'; echo constant($d); // 參考 "命名空間和動態語言特征" 小節 ?>
非常容易理解的代碼,從上面的代碼中可以看到 PHP 定義的命名空間是怎麼樣的,不過筆者個人認為其定義非常反人類,居然使用反斜槓來分隔命名空間路徑。不過有一點需要注意,名為 PHP 或 php 的命名空間,以及以這些名字開頭的命名空間(例如PHP\Classes)被保留用作語言內核使用,而不應該在用戶空間的代碼中使用。
定義命名空間
PHP 命名空間功能只能在 PHP5.3.0 以上版本使用,對於一個命名空間,只有類、接口、函數和常量會被包含在命名空間中。
<?php namespace MyProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?>
當然,也可以使用花括號來包含所有需要的內容,就像這樣。
<?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(); } ?>
不過這樣很容易造成縮進上的問題,所以筆者不推薦使用,並且一般情況下,一個文件包含一個類,所以也不需要花括號來分割命名空間范圍。
使用命名空間
對於命名空間路徑來說,存在著三種形式
非限定名稱,或者說不包含前綴的類名稱。例如 $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 。
由於 PHP 本身動態語言的特性,所以完全可以使用字符串動態訪問命名空間內的元素。
<?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 ?>
不過有一點需要注意,就是單雙引號之間的區別,單引號可以不需要處理 \ 的轉譯處理,而雙引號就必須使用 \\ 等轉譯符號。
Java 語言使用 import 機制引入命名空間,由於 Java 可以指定到類名,所以 Java 最多只能導入到具體類,而 PHP 則可以指定到一個命名空間內的類、常量、方法等,並且支持命名空間別名。
<?php namespace foo; use My\Full\Classname as Another; // 下面的例子與 use My\Full\NSname as NSname 相同 use My\Full\NSname; // 導入一個全局類 use ArrayObject; // importing a function (PHP 5.6+) use function My\Full\functionName; // aliasing a function (PHP 5.6+) use function My\Full\functionName as func; // importing a constant (PHP 5.6+) use const My\Full\CONSTANT $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 對象 func(); // calls function My\Full\functionName echo CONSTANT; // echoes the value of My\Full\CONSTANT ?>
名稱解析規則
首先就是前面講過的三種名稱類型,名稱解析遵循以下規則:
對完全限定名稱的函數,類和常量的調用在編譯時解析。例如 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()的解析:
在當前命名空間中查找A\B\C類。
嘗試自動裝載類A\B\C。
new D\E()的解析:
在類名稱前面加上當前命名空間名稱變成:A\B\D\E,然後查找該類。
嘗試自動裝載類 A\B\D\E。
為了引用全局命名空間中的全局類,必須使用完全限定名稱 new \C()。
從上面的規則來看,實際上 PHP 的導入規則和 Java 有點類似,但是卻有不一樣,主要是因為 Java 是完全面向對象的,而 PHP 本質上還只是一種基於對象的語言。
自動加載類
在早期 PHP 開發中,開發者最煩的就是一堆 include 函數包含了一大堆文件,而且早期時候 PHP 面向對象的概念確實太差了,因為 PHP 作為一種腳本語言,不存在程序入口,所以腳本順序化執行的誘惑力實在是很大,即使面向對象開發,但是缺少極佳的模塊劃分導入機制,代碼可以說很難有美感,最大的代表就是 Wordpress。如果有朋友看過這個典型項目,可以覺得非常痛苦,因為各種初始化、業務流程都分散在各個不同的文件中,使用 include 函數進行銜接,然後每次頁面渲染都是同樣的要走一趟流程。當然,這是 Wordpress 的歷史包袱,而在支持老版本 PHP 的情況下 Wordpress 代碼已經寫得足夠優化了。
在 PHP5 中就不需要這麼麻煩了,因為可以定義一個 __autoload() 函數,當調用一個未定義的類的時候就會啟動此函數,從而在拋出錯誤之前做最後的補救,不過這個函數的本意已經被完全曲解使用了,現在都用來做自動加載。
注意,這個函數實際上已經不被推薦使用了,相反,現在應當使用 spl_autoload_register() 來注冊類的自動加載函數。
bool spl_autoload_register ([ callable $autoload_function [, bool $throw = true [, bool $prepend = false ]]] )
autoload_function 是需要注冊的自動裝載函數,如果此項為空,則會注冊 spl_autoload 函數,
throw 此參數設置了 autoload_function 無法成功注冊時, spl_autoload_register() 是否拋出異常。
prepend 如果是 true, spl_autoload_register() 會添加函數到隊列之首,而不是隊列尾部。
上面提到了 spl_autoload 函數,實際上注冊函數的規范就應當遵循此函數,函數聲明如下:
void spl_autoload ( string $class_name [, string $file_extensions ] )
由於這個函數默認實現是通過 C 語言,所以這裡給出一個 PHP 語言的實現規范。
<?php // Your custom class dir define('CLASS_DIR', 'class/') // Add your class dir to include path set_include_path(get_include_path().PATH_SEPARATOR.CLASS_DIR); // You can use this trick to make autoloader look for commonly used "My.class.php" type filenames spl_autoload_extensions('.class.php'); // Use default autoload implementation spl_autoload_register(); ?>
大致上就和這個是類似的。實際上命名空間和自動加載類的結合就基本是通過路徑形式
function __autoload(){ $dir = './libralies'; set_include_path(get_include_path(). PATH_SEPARATOR. $dir); $class = str_replace('\\', '/', $class) . '.php'; require_once($class); }
將命名空間路徑替換為實際路徑。
以上內容是小編給大家介紹的PHP命名空間和自動加載類,希望對大家有所幫助!