第一節命名空間概述
版本需求
PHP從5.3.0版本開始引入命名空間
什麼是命名空間
引用PHP官方手冊中的範例:
文件foo. home/greg 和/home/other 中存在,但在同一個目錄中不能存在兩個foo.txt 檔案。另外,在目錄 /home/greg 外存取 foo.txt 檔案時,我們必須將目錄名稱以及目錄分隔符號放在檔案名稱之前得到 /home/greg/foo.txt。這個原理應用在程式設計領域就是命名空間的概念。
命名空間的作用
在PHP中,命名空間用來解決在編寫類別庫或應用程式時創建可重複使用的程式碼如類別或函數時碰到的兩類問題:
用戶編寫的程式碼與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程式碼都可以包含在命名空間中,但只有以下類型的程式碼受命名空間的影響,它們是:類別(包括抽象類別和traits)、介面、函數和常數。
命名空間透過關鍵字namespace來聲明。如果一個檔案中包含命名空間,它必須在其它所有程式碼之前聲明命名空間,除了一個以外:declare關鍵字。
在聲明命名空間之前唯一合法的程式碼是用來定義原始檔編碼方式的 declare 語句。另外,所有非 PHP 程式碼包括空白符都不能出現在命名空間的宣告之前。
另外,與PHP其它的語言特徵不同,同一個命名空間可以定義在多個文件中,即允許將同一個命名空間的內容分割存放在不同的文件中。
正確的命名空間範例:
<?phpnamespace MyProject; const CONNECT_OK = 1; class Connection { /* ... */ } function connect() { /* ... */ } ?>
錯誤的命名空間的範例:
<html> <?php namespace MyProject; // 致命错误 - 命名空间必须是程序脚本的第一条语句 ?>
定義子命名空間
與目錄和檔案的關係很像,PHP 命名空間也允許指定層次化的命名空間的名稱。因此,命名空間的名字可以使用分層的方式來定義。
下面的範例創建了常數MyProjectSubLevelCONNECT_OK,類別 MyProjectSubLevelConnection和函數 MyProjectSubLevelconnect。
<?php namespace MyProject\Sub\Level; 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() { /* ... */ } }?>
在實際的程式設計實踐中,非常不提倡在同一個檔案中定義多個命名空間。這種方式的主要用於將多個 PHP 腳本合併在同一個檔案中。
除了開始的declare語句外,命名空間的括號外不得有任何PHP代碼。
以上就是筆記007 PHP的命名空間 - 前篇的內容,更多相關內容請關注PHP中文網(www.php.cn)!