php:命名空间

php.net
(PHP 5 >= 5.3.0, PHP 7)
参见php自动加载,会对命名空间有更好的认识

概念命名空间

即便任意合法的PHP代码都得以涵盖在命名空间中,但只有以下类别的代码受命名空间的影响,它们是:类(包括抽象类和traits)、接口、函数和常量。
假设一个文本中隐含命名空间,它必须在任何具有代码在此之前扬言命名空间,除了一个以外:declare关键字。所有非
PHP 代码包括空白符都不可能冒出在命名空间的宣示以前。

<html>
<?php
namespace MyProject; // 致命错误 - 命名空间必须是程序脚本的第一条语句
?>

同一个命名空间可以定义在六个文本中,即允许将同一个命名空间的始末分割存放在不同的公文中。

定义子命名空间

<?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() { /* ... */  }
}
?>

采用命名空间

类名的两种引用格局:

  • 非限定名称(名称中不包含命名空间分隔符的标识符),或不带有前缀的类名称。例如
    $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。
  • 全盘限定名称(名称中带有命名空间分隔符,并以命名空间分隔符起首的标识符),或带有了全局前缀操作符的称谓。访问任意全局类、函数或常量,都可以运用完全限定名称,例如
    \strlen() 或 \Exception 。

tips:

$a = '\namespacename\classname';
$obj = new $a; 
$a = 'namespacename\classname';
$obj = new $a;
$b = 'namespacename\funcname';
$b(); // prints namespacename\funcname
$b = '\namespacename\funcname';
$b(); // also prints namespacename\funcname

动用相关常量

常量__NAMESPACE__的值是带有当前定名空间名称的字符串。在全局的,不包括在任何命名空间中的代码,它包含一个空的字符串。

行使命名空间:别名/导入

<?php
namespace foo;
use My\Full\Classname as Another;

// 下面的例子与 use My\Full\NSname as NSname 相同
use My\Full\NSname;

// 导入一个全局类
use ArrayObject;

// importing a function (PHP 5.6+)
use function My\Full\functionName;

// aliasing a function (PHP 5.6+)
use function My\Full\functionName as func;

// importing a constant (PHP 5.6+)
use const My\Full\CONSTANT;

$obj = new namespace\Another; // 实例化 foo\Another 对象
$obj = new Another; // 实例化 My\Full\Classname 对象
NSname\subns\func(); // 调用函数 My\Full\NSname\subns\func
$a = new ArrayObject(array(1)); // 实例化 ArrayObject 对象
// 如果不使用 "use \ArrayObject" ,则实例化一个 foo\ArrayObject 对象
func(); // calls function My\Full\functionName
echo CONSTANT; // echoes the value of My\Full\CONSTANT
?>

类名称总是解析到近来定名空间中的名称。因而在拜访系统内部或不含有在命名空间中的类名称时,必须运用完全限定名称。

相关文章