關於PHP命名空間和自動載入類詳解及案例

PHP的命名空間（namespace）是php5.3之後才有的。這篇文章主要介紹了PHP命名空間和自動載入類的相關資料,需要的朋友可以參考下

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 官方文檔代碼拉出來溜溜

<?phpnamespace 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 以上版本使用，對於一個命名空間，只有類、介面、函數和常量會被包含在命名空間中。

<?phpnamespace MyProject;const CONNECT_OK = 1;class Connection { /* ... */ }function connect() { /* ... */ }?>

當然，也可以使用花括弧來包含所有需要的內容，就像這樣。

<?phpdeclare(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 本身動態語言的特性，所以完全可以使用字串動態訪問命名空間內的元素。

<?phpnamespace 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 funcnameecho 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\funcnameecho constant('\namespacename\constname'), "\n"; // prints namespacedecho constant('namespacename\constname'), "\n"; // also prints namespaced?>

不過有一點需要注意，就是單雙引號之間的區別，單引號可以不需要處理 \ 的轉譯處理，而雙引號就必須使用 \\ 等轉譯符號。

Java 語言使用 import 機制引入命名空間，由於 Java 可以指定到類名，所以 Java 最多隻能匯入到具體類，而 PHP 則可以指定到一個命名空間內的類、常量、方法等，並且支援命名空間別名。

<?phpnamespace 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\functionNameecho 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 dirdefine('CLASS_DIR', 'class/')// Add your class dir to include pathset_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 filenamesspl_autoload_extensions('.class.php');// Use default autoload implementationspl_autoload_register();?>

大致上就和這個是類似的。實際上命名空間和自動載入類的結合就基本是通過路徑形式

function __autoload(){$dir = './libralies';set_include_path(get_include_path(). PATH_SEPARATOR. $dir);$class = str_replace('\\', '/', $class) . '.php'; require_once($class);}

將命名空間路徑替換為實際路徑。

總結：以上就是本篇文的全部內容，希望能對大家的學習有所協助。