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用法詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!