(PHP 5 >= 5.3.0, PHP 7, PHP 8)
虽然任意合法的 PHP 代码都可以包含在命名空间中,但只有以下类型的代码受命名空间的影响,它们是:类(包括抽象类和 trait)、接口、函数和常量。
命名空间通过关键字 namespace
来声明。如果一个文件中包含命名空间,它必须在其它所有代码之前声明命名空间,除了一个以外:declare关键字。
示例 #1 声明单个命名空间
<?php
namespace MyProject;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
?>
在声明命名空间之前唯一合法的代码是用于定义源文件编码方式的注意: 完全限定名称(就是以反斜杠开头的名称)不能用于命名空间的声明。 因为该结构会解析成相对命名空间表达式。
declare
语句。另外,所有非 PHP
代码包括空白符都不能出现在命名空间的声明之前:
示例 #2 声明单个命名空间
<html>
<?php
namespace MyProject; // 致命错误 - 命名空间必须是程序脚本的第一条语句
?>
另外,与 PHP 其它的语言特征不同,同一个命名空间可以定义在多个文件中,即允许将同一个命名空间的内容分割存放在不同的文件中。