php namespace用法詳解

2020-09-26 09:00:54

php namespace指的是名稱空間,其使用方法:首先建立一個PHP範例檔案;然後通過「namespace MyProject;」方式定義程式碼在「MyProject」名稱空間中即可。

PHP 名稱空間(namespace)

PHP 名稱空間(namespace)是在PHP 5.3中加入的,如果你學過C#和Java,那名稱空間就不算什麼新事物。 不過在PHP當中還是有著相當重要的意義。

PHP 名稱空間可以解決以下兩類問題:

使用者編寫的程式碼與PHP內部的類/函數/常數或第三方類/函數/常數之間的名字衝突。

為很長的識別符號名稱(通常是為了緩解第一類問題而定義的)建立一個別名(或簡短)的名稱,提高原始碼的可讀性。

定義名稱空間

預設情況下,所有常數、類和函數名都放在全域性空間下,就和PHP支援名稱空間之前一樣。

名稱空間通過關鍵字namespace 來宣告。如果一個檔案中包含名稱空間,它必須在其它所有程式碼之前宣告名稱空間。語法格式如下;

<?php  
// 定義程式碼在 'MyProject' 名稱空間中  
namespace MyProject;  
  
// ... 程式碼 ...

你也可以在同一個檔案中定義不同的名稱空間程式碼,如:

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

不建議使用這種語法在單個檔案中定義多個名稱空間。建議使用下面的大括號形式的語法。

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

將全域性的非名稱空間中的程式碼與名稱空間中的程式碼組合在一起,只能使用大括號形式的語法。全域性程式碼必須用一個不帶名稱的 namespace 語句加上大括號括起來,例如:

<?php
namespace MyProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */  }
}
namespace { // 全域性程式碼
session_start();
$a = MyProject\connect();
echo MyProject\Connection::start();
}
?>

在宣告名稱空間之前唯一合法的程式碼是用於定義原始檔編碼方式的 declare 語句。所有非 PHP 程式碼包括空白符都不能出現在名稱空間的宣告之前。

<?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();
}
?>

以下程式碼會出現語法錯誤:

<html>
<?php
namespace MyProject; // 名稱空間前出現了「<html>」 會致命錯誤 - 名稱空間必須是程式指令碼的第一條語句
?>

子名稱空間

與目錄和檔案的關係很像,PHP 名稱空間也允許指定層次化的名稱空間的名稱。因此,名稱空間的名字可以使用分層次的方式定義:

<?php
namespace 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。

以上就是php namespace用法詳解的詳細內容,更多請關注TW511.COM其它相關文章!