萬盛學電腦網

 萬盛學電腦網 >> 網絡編程 >> php編程 >> PHP的命名空間使用詳解

PHP的命名空間使用詳解

命名空間在php中創建一個命名空間需要使用namespace關鍵字了,這個是php7才有的關鍵字了,下面我們來看一篇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就相當於對應一個文件路徑,查找這個類的時候,就會去對應的文件路徑查找類定義文件了。

注明:

本文提到的常量:PHP5.3開始const關鍵字可以用在類的外部。const和define都是用來聲明常量的(它們的區別不詳述),但是在命名空間裡,define的作用是全局的,而const則作用於當前空間。我在文中提到的常量是指使用const聲明的常量。


基礎
命名空間將代碼劃分出不同的空間(區域),每個空間的常量、函數、類(為了偷懶,我下邊都將它們稱為元素)的名字互不影響, 這個有點類似我們常常提到的‘封裝'的概念。

namespace的定義和使用

定義:

<?php
 
namespace Myproject;
或者

<?php
 
namespace Myproject {
 
}
使用:

<?php
 
use Myproject/School;
<?php
 
use Myproject/Schoolas School1;  // 別名
命名空間是運行時解析的。use就相當於一種聲明,並不解析和加載。比如下面這個例子:

test.php

<?php
use my\name;
require_once("/home/yejianfeng/handcode/test/namespace1.php");
$a =new my\name\A();
$a->Print1();
namespace1.php

<?php
namespace my\name;
class A {
        public function Print1(){
                echo 11;
        }
}

雖然require_once在use下面,也是可以正常運行的,因為程序只有在new my\name\A()的時候才去加載命名空間my\name

全局類和命名空間類

如果要new一個全局類使用 new \A()

如果要new一個命名空間類,使用new my\namespace\A()

命名空間的順序

自從有了命名空間之後,最容易出錯的該是使用類的時候,這個類的尋找路徑是什麼樣的了。

如果能弄清楚manual中的這個例子就能全部弄清楚尋找順序了。

<?php
namespace A;
use B\D, C\Eas F;
 
// 函數調用
 
foo();      // 首先嘗試調用定義在命名空間"A"中的函數foo()
            // 再嘗試調用全局函數 "foo"
 
\foo();     // 調用全局空間函數 "foo"
 
my\foo();   // 調用定義在命名空間"A\my"中函數 "foo"
 
F();        // 首先嘗試調用定義在命名空間"A"中的函數 "F"
            // 再嘗試調用全局函數 "F"
 
// 類引用
 
new B();   // 創建命名空間 "A" 中定義的類 "B" 的一個對象
            // 如果未找到,則嘗試自動裝載類 "A\B"
 
new D();   // 使用導入規則,創建命名空間 "B" 中定義的類 "D" 的一個對象
            // 如果未找到,則嘗試自動裝載類 "B\D"
 
new F();   // 使用導入規則,創建命名空間 "C" 中定義的類 "E" 的一個對象
            // 如果未找到,則嘗試自動裝載類 "C\E"
 
new \B();  // 創建定義在全局空間中的類 "B" 的一個對象
            // 如果未發現,則嘗試自動裝載類 "B"
 
new \D();  // 創建定義在全局空間中的類 "D" 的一個對象
            // 如果未發現,則嘗試自動裝載類 "D"
 
new \F();  // 創建定義在全局空間中的類 "F" 的一個對象
            // 如果未發現,則嘗試自動裝載類 "F"
 
// 調用另一個命名空間中的靜態方法或命名空間函數
 
B\foo();    // 調用命名空間 "A\B" 中函數 "foo"
 
B::foo();   // 調用命名空間 "A" 中定義的類 "B" 的 "foo" 方法
            // 如果未找到類 "A\B" ,則嘗試自動裝載類 "A\B"
 
D::foo();   // 使用導入規則,調用命名空間 "B" 中定義的類 "D" 的 "foo" 方法
            // 如果類 "B\D" 未找到,則嘗試自動裝載類 "B\D"
 
\B\foo();   // 調用命名空間 "B" 中的函數 "foo"
 
\B::foo();  // 調用全局空間中的類 "B" 的 "foo" 方法
            // 如果類 "B" 未找到,則嘗試自動裝載類 "B"
 
// 當前命名空間中的靜態方法或函數
 
A\B::foo();   // 調用命名空間 "A\A" 中定義的類 "B" 的 "foo" 方法
              // 如果類 "A\A\B" 未找到,則嘗試自動裝載類 "A\A\B"
 
\A\B::foo();  // 調用命名空間 "A\B" 中定義的類 "B" 的 "foo" 方法
              // 如果類 "A\B" 未找到,則嘗試自動裝載類 "A\B"
?>

創建一個命名空間需要使用namespace關鍵字,這樣:

 

<?php
 

//創建一個名為'Article'的命名空間
namespace Article;

?>


要注意的是,當前腳本文件的第一個命名空間前面不能有任何代碼,下面的寫法都是錯誤的:

 

//例一
//在腳本前面寫了一些邏輯代碼
 

<?php

$path = "/";

class Comment { }

namespace Article;

?>

 

//例二
//在腳本前面輸出了一些字符

<html></html>
<?php

namespace Article;

?>


為什麼要說第一個命名空間呢?因為同一腳本文件中可以創建多個命名空間。

 

下面我創建了兩個命名空間,順便為這兩個空間各自添加了一個Comment類元素:

 

<?php
 

//創建一個名為'Article'的命名空間
namespace Article;

//此Comment屬於Article空間的元素
class Comment { }


//創建一個名為'MessageBoard'的命名空間
namespace MessageBoard;

//此Comment屬於MessageBoard空間的元素
class Comment { }
?>


在不同空間之間不可以直接調用其它元素,需要使用命名空間的語法:

 

<?php
 

namespace Article;

class Comment { }


namespace MessageBoard;

class Comment { }

//調用當前空間(MessageBoard)的Comment類
$comment = new Comment();

//調用Article空間的Comment類
$article_comment = new \Article\Comment();

?>


可以看到,在MessageBoard空間中調用article空間裡的Comment類時,使用了一種像文件路徑的語法: \空間名\元素名

 

除了類之外,對函數和常量的用法是一樣的,下面我為兩個空間創建了新的元素,並在MessageBoard空間中輸出了它們的值。

 

<?php
 

namespace Article;

const PATH = '/article';

function getCommentTotal() {
    return 100;
}

class Comment { }


namespace MessageBoard;

const PATH = '/message_board';

function getCommentTotal() {
    return 300;
}

class Comment { }

//調用當前空間的常量、函數和類
echo PATH; ///message_board
echo getCommentTotal(); //300
$comment = new Comment();

//調用Article空間的常量、函數和類
echo \Article\PATH; ///article
echo \Article\getCommentTotal(); //100
$article_comment = new \Article\Comment();

?>


然後我的確得到了Article空間的元素數據。

 


子空間
命名空間的調用語法像文件路徑一樣是有道理的,它允許我們自定義子空間來描述各個空間之間的關系。

抱歉我忘了說,article和message board這兩個模塊其實都是處於同一個blog項目內。如果用命名空間來表達它們的關系,是這樣:

 

<?php
 

//我用這樣的命名空間表示處於blog下的article模塊
namespace Blog\Article;

class Comment { }


//我用這樣的命名空間表示處於blog下的message board模塊
namespace Blog\MessageBoard;

class Comment { }

//調用當前空間的類
$comment = new Comment();

//調用Blog\Article空間的類
$article_comment = new \Blog\Article\Comment();

?>


而且,子空間還可以定義很多層次,比如說 Blog\Article\Archives\Date

 


公共空間
我有一個common_inc.php腳本文件,裡面有一些好用的函數和類:

 

<?php
 

function getIP() { }

class FilterXSS { }

?>


在一個命名空間裡引入這個腳本,腳本裡的元素不會歸屬到這個命名空間。如果這個腳本裡沒有定義其它命名空間,它的元素就始終處於公共空間中:

 

<?php
 

namespace Blog\Article;

//引入腳本文件
include './common_inc.php';

$filter_XSS = new FilterXSS(); //出現致命錯誤:找不到Blog\Article\FilterXSS類

$filter_XSS = new \FilterXSS(); //正確

?>


調用公共空間的方式是直接在元素名稱前加 \ 就可以了,否則PHP解析器會認為我想調用當前空間下的元素。除了自定義的元素,還包括PHP自帶的元素,都屬於公共空間。

 

要提一下,其實公共空間的函數和常量不用加 \ 也可以正常調用(不明白PHP為什麼要這樣做),但是為了正確區分元素,還是建議調用函數的時候加上 \


名稱術語
在說別名和導入之前,需要知道關於空間三種名稱的術語,以及PHP是怎樣解析它們的。官方文檔說得非常好,我就直接拿來套了。

1.非限定名稱,或不包含前綴的類名稱,例如 $comment = new Comment();。如果當前命名空間是Blog\Article,Comment將被解析為Blog\Article\Comment。如果使用Comment的代碼不包含在任何命名空間中的代碼(全局空間中),則Comment會被解析為Comment。

2.限定名稱,或包含前綴的名稱,例如 $comment = new Article\Comment();。如果當前的命名空間是Blog,則Comment會被解析為Blog\Article\Comment。如果使用Comment的代碼不包含在任何命名空間中的代碼(全局空間中),則Comment會被解析為Comment。

3.完全限定名稱,或包含了全局前綴操作符的名稱,例如 $comment = new \Article\Comment();。在這種情況下,Comment總是被解析為代碼中的文字名(literal name)Article\Comment。
 

其實可以把這三種名稱類比為文件名(例如 comment.php)、相對路徑名(例如 ./article/comment.php)、絕對路徑名(例如 /blog/article/comment.php),這樣可能會更容易理解。

我用了幾個示例來表示它們:

 

<?php
 

//創建空間Blog
namespace Blog;

class Comment { }

//非限定名稱,表示當前Blog空間
//這個調用將被解析成 Blog\Comment();
$blog_comment = new Comment();

//限定名稱,表示相對於Blog空間
//這個調用將被解析成 Blog\Article\Comment();
$article_comment = new Article\Comment(); //類前面沒有反斜桿\

//完全限定名稱,表示絕對於Blog空間
//這個調用將被解析成 Blog\Comment();
$article_comment = new \Blog\Comment(); //類前面有反斜桿\

//完全限定名稱,表示絕對於Blog空間
//這個調用將被解析成 Blog\Article\Comment();
$article_comment = new \Blog\Article\Comment(); //類前面有反斜桿\


//創建Blog的子空間Article
namespace Blog\Article;

class Comment { }

?>


其實之前我就一直在使用非限定名稱和完全限定名稱,現在它們終於可以叫出它們的名稱了。

 


別名和導入
別名和導入可以看作是調用命名空間元素的一種快捷方式。PHP並不支持導入函數或常量。

它們都是通過使用use操作符來實現:

 

<?php
 

namespace Blog\Article;

class Comment { }


//創建一個BBS空間(我有打算開個論壇)
namespace BBS;

//導入一個命名空間
use Blog\Article;
//導入命名空間後可使用限定名稱調用元素
$article_comment = new Article\Comment();

//為命名空間使用別名
use Blog\Article as Arte;
//使用別名代替空間名
$article_comment = new Arte\Comment();

//導入一個類
use Blog\Article\Comment;
//導入類後可使用非限定名稱調用元素
$article_comment = new Comment();

//為類使用別名
use Blog\Article\Comment as Comt;
//使用別名代替空間名
$article_comment = new Comt();

?>


我注意到,如果導入元素的時候,當前空間有相同的名字元素將會怎樣?顯然結果會發生致命錯誤。

 

例:

 

<?php
 

namespace Blog\Article;

class Comment { }


namespace BBS;

class Comment { }

Class Comt { }


//導入一個類
use Blog\Article\Comment;
$article_comment = new Comment(); //與當前空間的Comment發生沖突,程序產生致命錯誤

//為類使用別名
use Blog\Article\Comment as Comt;
$article_comment = new Comt(); //與當前空間的Comt發生沖突,程序產生致命錯誤

?>


動態調用
PHP提供了namespace關鍵字和__NAMESPACE__魔法常量動態的訪問元素,__NAMESPACE__可以通過組合字符串的形式來動態訪問:

 

<?php
 

namespace Blog\Article;

const PATH = '/Blog/article';

class Comment { }


//namespace關鍵字表示當前空間
echo namespace\PATH; ///Blog/article
$comment = new namespace\Comment();

//魔法常量__NAMESPACE__的值是當前空間名稱
echo __NAMESPACE__; //Blog\Article
//可以組合成字符串並調用
$comment_class_name = __NAMESPACE__ . '\Comment';
$comment = new $comment_class_name();

?>


字符串形式調用問題

上面的動態調用的例子中,我們看到了字符串形式的動態調用方式,如果要使用這種方式要注意兩個問題。

 

1. 使用雙引號的時候特殊字符可能被轉義

 

<?php
 

namespace Blog\Article;

class name { }

//我是想調用Blog\Article\name
$class_name = __NAMESPACE__ . "\name"; //但是\n將被轉義為換行符

$name = new $class_name(); //發生致命錯誤

?>


2. 不會認為是限定名稱

 

PHP在編譯腳本的時候就確定了元素所在的空間,以及導入的情況。而在解析腳本時字符串形式調用只能認為是非限定名稱和完全限定名稱,而永遠不可能是限定名稱。

 

<?php
 

namespace Blog;

//導入Common類
use Blog\Article\Common;
//我想使用非限定名稱調用Blog\Article\Common
$common_class_name = 'Common';
//實際會被當作非限定名稱,也就表示當前空間的Common類,但我當前類沒有創建Common類
$common = new $common_class_name(); //發生致命錯誤:Common類不存在

//我想使用限定名稱調用Blog\Article\Common
$common_class_name = 'Article\Common';
//實際會被當作完全限定名稱,也就表示Article空間下的Common類,但我下面只定義了Blog\Article空間而不是Article空間
$common = new $common_class_name(); //發生致命錯誤:Article\Common類不存在


namespace Blog\Article;

class Common { }

?>


總結
我對PHP的命名空間剛剛接觸,也不能隨便給一些沒有實踐的建議。我個人認為命名空間的作用和功能都很強大,如果要寫插件或者通用庫的時候再也不用擔心重名問題。不過如果項目進行到一定程度,要通過增加命名空間去解決重名問題,我覺得工作量不會比重構名字少。也不得不承認它的語法會對項目增加一定的復雜度,因此從項目一開始的時候就應該很好的規劃它,並制定一個命名規范。

copyright © 萬盛學電腦網 all rights reserved