PHP 命名空間

時間 2019-11-18

標籤 php 命名空間欄目 PHP 简体版

原文原文鏈接

命名空間適用於 (PHP 5 >= 5.3.0, PHP 7)php

使用命名空間基礎

PHP 命名空間相似於文件系統，html

在文件系統中訪問一個文件有三種方式：

相對文件名形式如foo.txt。它會被解析爲 currentdirectory/foo.txt，其中 currentdirectory 表示當前目錄。所以若是當前目錄是 /home/foo，則該文件名被解析爲/home/foo/foo.txt。
相對路徑名形式如subdirectory/foo.txt。它會被解析爲 currentdirectory/subdirectory/foo.txt。
絕對路徑名形式如/main/foo.txt。它會被解析爲/main/foo.txt。

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代碼均可以包含在命名空間中，但只有如下類型的代碼受命名空間的影響，編程

它們是：session

類（包括抽象類和traits）
接口
函數
常量

命名空間經過關鍵字 namespace 來聲明。若是一個文件中包含命名空間，它必須在其它全部代碼以前聲明命名空間，除了一個之外：declare關鍵字。函數

<html>
<?php
namespace MyProject; // 致命錯誤 -　命名空間必須是程序腳本的第一條語句
?>

Example 聲明單個命名空間spa

<?php
namespace MyProject;

const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */  }

?>

在同一個文件中定義多個命名空間

定義多個命名空間，推薦用大括號語法.net

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

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

在實際的編程實踐中，很是不提倡在同一個文件中定義多個命名空間。這種方式的主要用於將多個 PHP 腳本合併在同一個文件中。unix

將全局的非命名空間中的代碼與命名空間中的代碼組合在一塊兒，只能使用大括號形式的語法。全局代碼必須用一個不帶名稱的 namespace 語句加上大括號括起來，例如：code

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

namespace關鍵字和NAMESPACE常量

常量__NAMESPACE__的值是包含當前命名空間名稱的字符串。htm

若是不包括在任何命名空間中的代碼，則爲一個空的字符串。

<?php
namespace MyProject;

echo '"', __NAMESPACE__, '"'; // 輸出 "MyProject"
?>

<?php

echo '"', __NAMESPACE__, '"'; // 輸出 ""
?>

關鍵字 namespace 可用來顯式訪問當前命名空間或子命名空間中的元素。它等價於類中的 self 操做符。

<?php
namespace MyProject;

use blah\blah as mine; // see "Using namespaces: importing/aliasing"

blah\mine(); // calls function MyProject\blah\mine()
namespace\blah\mine(); // calls function MyProject\blah\mine()

namespace\func(); // calls function MyProject\func()
namespace\sub\func(); // calls function MyProject\sub\func()
namespace\cname::method(); // calls static method "method" of class MyProject\cname
$a = new namespace\sub\cname(); // instantiates object of class MyProject\sub\cname
$b = namespace\CONSTANT; // assigns value of constant MyProject\CONSTANT to $b
?>

使用命名空間：別名/導入

容許經過別名引用或導入外部的徹底限定名稱，是命名空間的一個重要特徵。這有點相似於在類 unix 文件系統中能夠建立對其它的文件或目錄的符號鏈接。

在PHP中，別名是經過操做符 use 來實現的.

<?php
use My\Full\Classname as Another, My\Full\NSname;

$obj = new Another; // 實例化 My\Full\Classname 對象
NSname\subns\func(); // 調用函數 My\Full\NSname\subns\func
?>

全局空間

若是沒有定義任何命名空間，全部的類與函數的定義都是在全局空間，與 PHP 引入命名空間概念前同樣。在名稱前加上前綴 \ 表示該名稱是全局空間中的名稱，即便該名稱位於其它的命名空間中時也是如此。

<?php
namespace A\B\C;

/* 這個函數是 A\B\C\fopen */
function fopen() { 
     /* ... */
     $f = \fopen(...); // 調用全局的fopen函數
     return $f;
} 
?>

使用命名空間：後備全局函數/常量

在一個命名空間中，當 PHP 遇到一個非限定的類、函數或常量名稱時，它使用不一樣的優先策略來解析該名稱。

類名稱老是解析到當前命名空間中的名稱。所以在訪問系統內部或不包含在命名空間中的類名稱時，必須使用徹底限定名稱，

<?php
namespace A\B\C;
class Exception extends \Exception {}

$a = new Exception('hi'); // $a 是類 A\B\C\Exception 的一個對象
$b = new \Exception('hi'); // $b 是類 Exception 的一個對象

$c = new ArrayObject; // 致命錯誤, 找不到 A\B\C\ArrayObject 類
?>

對於函數和常量來講，若是當前命名空間中不存在該函數或常量，PHP 會退而使用全局空間中的函數或常量。

<?php
namespace A\B\C;

const E_ERROR = 45;
function strlen($str)
{
    return \strlen($str) - 1;
}

echo E_ERROR, "\n"; // 輸出 "45"
echo INI_ALL, "\n"; // 輸出 "7" - 使用全局常量 INI_ALL

echo strlen('hi'), "\n"; // 輸出 "1"
if (is_array('hi')) { // 輸出 "is not array"
    echo "is array\n";
} else {
    echo "is not array\n";
}
?>