PHP - 名稱空間

我們經常將檔案組織在不同的資料夾中。通常一個資料夾包含與特定目標、應用程式或類別相關的檔案。一個資料夾不能包含兩個同名的檔案，儘管不同的資料夾可以擁有同名的檔案，因為每個檔案的路徑不同。

PHP 中名稱空間的概念與此類似。在 PHP 中，名稱空間允許使用相同名稱的類、函式或常量在不同的上下文中使用而不會發生衝突，從而封裝這些專案。

PHP 名稱空間是對類/函式等的邏輯分組，取決於它們的關聯性。就像同名檔案可以存在於兩個不同的資料夾中一樣，特定名稱的類可以定義在兩個名稱空間中。此外，正如我們指定檔案的完整路徑來訪問一樣，我們需要指定類的全名以及名稱空間。

隨著應用程式規模的擴大，涉及許多類和函式定義，為每個類/函式賦予唯一名稱可能會變得繁瑣且不夠優雅。使用名稱空間可以以整潔的方式組織此類程式碼塊。例如，如果我們需要宣告一個 calculate() 函式來計算面積和稅款，而不是將它們定義為 calculate_area() 和 calculate_tax() 之類的東西，我們可以建立兩個名稱空間 area 和 tax，並在其中使用 calculate()。

名稱空間的優勢

以下是使用 PHP 名稱空間的一些優勢：

名稱空間有助於避免由他人定義的類/函式/常量與第三方類/函式/常量之間的名稱衝突。
名稱空間提供了一種為 Extra_Long_Names 建立別名（或縮短）的能力，從而提高了原始碼的可讀性。
PHP 名稱空間提供了一種對相關的類、介面、函式和常量進行分組的方法。名稱空間名稱不區分大小寫。

定義名稱空間

PHP 的 namespace 關鍵字用於定義新的名稱空間。

namespace myspace;

包含名稱空間的“.php”檔案必須在任何其他程式碼（除了 declare 指令）之前在檔案的頂部宣告名稱空間。在名稱空間內宣告類、函式和常量會影響其訪問。

PHP 指令碼可能包含名稱空間定義之外的其他程式碼。要載入在同一程式碼中定義的名稱空間，PHP 使用“use”關鍵字。

use myspace;

示例

在下面的“hello.php”指令碼中，我們在 myspace 名稱空間內定義了一個 hello() 函式，並在當前指令碼中載入名稱空間後呼叫它。

<?php
   namespace myspace;
   function hello() {
      echo "Hello World";
   }
   use myspace;
   myspace\hello();
?>

它將產生以下輸出：

Hello World

請注意，您必須使用包含名稱空間的全名（myspace\hello()）限定 hello() 函式。

包含名稱空間

您可能有一個指令碼包含名稱空間宣告，另一個指令碼使用 include 語句載入名稱空間。

a.php

<?php
   namespace myspace {
      function hello() {
         echo "Hello World in myspace";
      }
   }
?>

b.php

<?php
   include 'a.php';
   myspace\hello();
?>

它將產生以下輸出：

Hello World in myspace

可能出現這種情況：當前指令碼（如上面的“b.php”）也具有與包含檔案中相同的名稱的函式。在前面加上名稱空間的完全限定函式有助於解析器解決名稱衝突。

示例

請看下面的例子：

<?php
   include 'a.php';
   function hello() {
      echo "Hello World from current namespace";
   }
   hello();
   myspace\hello();
?>

它將產生以下輸出：

Hello World from current namespace
Hello World in myspace

示例

如上所述，名稱空間宣告必須位於頂部，緊跟在起始 <?php 標記之後。否則，解析器將丟擲致命錯誤。

<?php
   echo "hello"
   namespace myspace;
   function hello() {
      echo "Hello World";
   }
   use myspace;
   myspace\hello();
?>

它將產生以下輸出：

PHP Parse error:  syntax error, unexpected token "namespace", 
expecting "," or ";" in /home/cg/root/67771/main.php on line 4

上述錯誤訊息清楚地表明，只有“declare 語句”允許出現在名稱空間宣告之前。

<?php
   declare (strict_types=1);
   namespace myspace;
   function hello() {
      echo "Hello World";
   }
   use myspace;
   myspace\hello();
?>

相對名稱空間

可以透過使用相對名稱空間路徑來訪問當前名稱空間中的物件，例如函式、類和常量。

在下面的示例中，“b.php”包含一個名稱空間 space1\myspace，其中包含一個 hello() 函式和一個 TEMP 常量。“a.php”中也定義了相同名稱空間 space1 中的物件。

顯然，當“b.php”包含在“a.php”中時，“myspace”是“space1”的子空間。因此，透過在其前面加上其相對名稱空間（也包括 TEMP 常量）來呼叫“myspace”中的 hello()。

b.php

<?php
   namespace space1\myspace;
   const TEMP = 10;
   function hello() {
      echo "Hello from current namespace:" . __NAMESPACE__ . ;
   }
?>

a.php

<?php
   namespace space1;
   include 'b.php';
   function hello() {
      echo "Hello from current namespace:" . __NAMESPACE__ . ;
   }
   const TEMP = 100;
   hello();            // current namespace
   myspace\hello();   // sub namespace

   echo "TEMP : " . TEMP . " in " . __NAMESPACE__ . ;
   echo "TEMP : " . myspace\TEMP  . " \\in space1\\myspace\n";
?>

它將產生以下輸出：

Hello from current namespace:space1
Hello from current namespace:space1\myspace
TEMP : 100 in space1
TEMP : 10 in space1\myspace

絕對名稱空間

您還可以透過新增絕對名稱空間路徑來訪問任何名稱空間中的函式/常量。例如，“b.php”中的 hello() 是“\space\myspace\hello()”。

a.php

<?php
   namespace space1;
   include 'b.php';
   function hello() {
      echo "Hello from current namespace:" . __NAMESPACE__ . ;
   }
   const TEMP = 100;
   \space1\hello();	             //current namespace
   \space1\myspace\hello();	    //sub namespace

   echo "TEMP: " . \space1\TEMP . " in " . __NAMESPACE__ . ;
   echo "TEMP: " . \space1\myspace\TEMP  . " in space1\\myspace\n";
?>

__NAMESPACE__ 是 PHP 中一個預定義的常量，它返回當前名稱空間的名稱。

名稱空間規則

不同名稱空間之間出現的函式/類/常量名稱衝突是透過遵循以下規則來解決的：

沒有名稱空間分隔符（/）的名稱空間識別符號意味著它指的是當前名稱空間。這是一個非限定名稱。
如果它包含分隔符，例如 myspace\space1，它將解析為 myspace 下的子名稱空間 space1。這種型別的命名是相對名稱空間。
完全限定名稱空間的名稱以“\”字元開頭。例如，“\myspace”或“\myspace\space1”。
完全限定名稱解析為絕對名稱空間。例如 \myspace\space1 解析為 myspace\space1 名稱空間
如果名稱出現在全域性名稱空間中，則刪除“namespace\”字首。例如，“namespace\space1”解析為 space1。
但是，如果它出現在另一個名稱空間內，則處理方式不同。例如，如果 namespace\space1 在 myspace 內，則它等效於“myspace\space1”。
限定名稱中名稱的第一段根據當前類/名稱空間匯入表進行轉換。
如果沒有應用匯入規則，則當前名稱空間將新增到名稱前面。
類名根據類/名稱空間匯入表進行轉換，函式名根據函式匯入表進行轉換，常量根據常量匯入表進行轉換。
對於非限定名稱，如果沒有應用匯入規則並且名稱引用函式或常量並且程式碼位於全域性名稱空間之外，則在執行時解析名稱。首先它從當前名稱空間查詢函式，然後嘗試查詢並呼叫全域性函式。

列印頁面