首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 PHP

PHP命名空间(namespace)原理与用法详解

Posted in PHP onDecember 11, 2019

本文实例讲述了PHP命名空间(namespace)原理与用法。分享给大家供大家参考，具体如下：

PHP 命名空间(namespace)是在PHP 5.3中加入的，它可以解决以下两类问题：

  1. 用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。
  2. 为很长的标识符名称(通常是为了缓解第一类问题而定义的)创建一个别名（或简短）的名称，提高源代码的可读性。

我们在默认情况下，所有常量、类和函数名都放在全局空间下，就和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 命名空间中的类名的引用方式：

  1. 非限定名称，或不包含前缀的类名称，例如 $a=new foo(); 或 foo::staticmethod();。如果当前命名空间是 currentnamespace，foo 将被解析为 currentnamespace\foo。如果使用 foo 的代码是全局的，不包含在任何命名空间中的代码，则 foo 会被解析为foo。 警告：如果命名空间中的函数或常量未定义，则该非限定的函数名称或常量名称会被解析为全局函数名称或常量名称。
  2. 限定名称,或包含前缀的名称，例如 $a = new subnamespace\foo(); 或 subnamespace\foo::staticmethod();。如果当前的命名空间是 currentnamespace，则 foo 会被解析为 currentnamespace\subnamespace\foo。如果使用 foo 的代码是全局的，不包含在任何命名空间中的代码，foo 会被解析为subnamespace\foo。
  3. 完全限定名称，或包含了全局前缀操作符的名称，例如， $a = new \currentnamespace\foo(); 或 \currentnamespace\foo::staticmethod();。在这种情况下，foo 总是被解析为代码中的文字名(literal name)currentnamespace\foo。

咱们用来个文件来演示下，首先来看f1.php的代码：

<?php
namespace Foo\Bar\subnamespace; 
const FOO = 1;
function foo() {}
class foo
{
  static function staticmethod() {}
}
?>

之后就是f2.php的代码：

<?php
namespace Foo\Bar;
include 'f1.php';
const FOO = 2;
function foo() {}
class foo
{
  static function staticmethod() {}
}
/* 非限定名称 */
foo(); // 解析为函数 Foo\Bar\foo
foo::staticmethod(); // 解析为类 Foo\Bar\foo ，方法为 staticmethod
echo FOO; // 解析为常量 Foo\Bar\FOO
/* 限定名称 */
subnamespace\foo(); // 解析为函数 Foo\Bar\subnamespace\foo
subnamespace\foo::staticmethod(); // 解析为类 Foo\Bar\subnamespace\foo,
                 // 以及类的方法 staticmethod
echo subnamespace\FOO; // 解析为常量 Foo\Bar\subnamespace\FOO
/* 完全限定名称 */
\Foo\Bar\foo(); // 解析为函数 Foo\Bar\foo
\Foo\Bar\foo::staticmethod(); // 解析为类 Foo\Bar\foo, 以及类的方法 staticmethod
echo \Foo\Bar\FOO; // 解析为常量 Foo\Bar\FOO
?>

我们访问任意全局类、函数或常量，都可以使用完全限定名称，例如 \strlen() 或 \Exception 或 \INI_ALL。之后，咱们再来看下在命名空间内部访问全局类、函数和常量的实例：

<?php
namespace Foo;
function strlen() {}
const INI_ALL = 3;
class Exception {}
$a = \strlen('hi'); // 调用全局函数strlen
$b = \INI_ALL; // 访问全局常量 INI_ALL
$c = new \Exception('error'); // 实例化全局类 Exception
?>

PHP 命名空间的实现受到其语言自身的动态特征的影响，我们先来看一段代码：

<?php
class classname
{
  function __construct()
  {
    echo __METHOD__,"\n";
  }
}
function funcname()
{
  echo __FUNCTION__,"\n";
}
const constname = "global";
$a = 'classname';
$obj = new $a; // prints classname::__construct
$b = 'funcname';
$b(); // prints funcname
echo constant('constname'), "\n"; // prints global
?>

我们如果要将上述的代码转换到命名空间中，并且动态访问元素，就必须使用完全限定名称（包括命名空间前缀的类名称）。注意因为在动态的类名称、函数名称或常量名称中，限定名称和完全限定名称没有区别，因此其前导的反斜杠是不必要的。如下：

<?php
namespace namespacename;
class classname
{
  function __construct()
  {
    echo __METHOD__,"\n";
  }
}
function funcname()
{
  echo __FUNCTION__,"\n";
}
const constname = "namespaced";
include 'example1.php';
$a = 'classname';
$obj = new $a; // 输出 classname::__construct
$b = 'funcname';
$b(); // 输出函数名
echo constant('constname'), "\n"; // 输出 global
/* 如果使用双引号，使用方法为 "\\namespacename\\classname"*/
$a = '\namespacename\classname';
$obj = new $a; // 输出 namespacename\classname::__construct
$a = 'namespacename\classname';
$obj = new $a; // 输出 namespacename\classname::__construct
$b = 'namespacename\funcname';
$b(); // 输出 namespacename\funcname
$b = '\namespacename\funcname';
$b(); // 输出 namespacename\funcname
echo constant('\namespacename\constname'), "\n"; // 输出 namespaced
echo constant('namespacename\constname'), "\n"; // 输出 namespaced
?>

好啦，本次记录就到这里了，后续的记录会在之后的文章中有体现。

希望本文所述对大家PHP程序设计有所帮助。

PHP命名空间(namespace)原理与用法详解

- Author -

luyaran

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

PHP 相关文章推荐
PHP 彩色文字实现代码
Jun 29 PHP
PHP XML error parsing SOAP payload on line 1
Jun 17 PHP
PHP新手用的Insert和Update语句构造类
Mar 31 PHP
ThinkPHP使用UTFWry地址库进行IP定位实例
Apr 01 PHP
探寻PHP脚本不报错的原因
Jun 12 PHP
PHP把MSSQL数据导入到MYSQL的方法
Dec 27 PHP
php实现专业获取网站SEO信息类实例
Apr 02 PHP
php图像处理类实例
Jul 28 PHP
php微信公众号js-sdk开发应用
Nov 28 PHP
Thinkphp整合微信支付功能
Dec 14 PHP
thinkPHP5框架实现基于ajax的分页功能示例
Jun 12 PHP
PHP大文件分片上传的实现方法
Oct 28 PHP
在 Laravel 6 中缓存数据库查询结果的方法
Dec 11 #PHP
PHP超级全局变量【$GLOBALS，$_SERVER，$_REQUEST等】用法实例分析
Dec 11 #PHP
关于PHP5.6+版本“No input file specified”问题的解决
Dec 11 #PHP
Laravel5.1 框架数据库操作DB运行原生SQL的方法分析
Jan 07 #PHP
Laravel5.1 框架表单验证操作实例详解
Jan 07 #PHP
PHP字符串与数组处理函数用法小结
Jan 07 #PHP
Laravel5.1 框架响应基本用法实例分析
Jan 04 #PHP
音箱(1) 电路(15) ICF-2010(1) 单管机(1) 春雷3P7(1) 收信机(3) 耳机(1) BOSE(2) 原理(1) 探测器(1)
You might like
PHP导出MySQL数据到Excel文件(fputcsv)
2011/07/03 PHP
Symfony模板的快捷变量用法实例
2016/03/17 PHP
Thinkphp5 微信公众号token验证不成功的原因及解决方法
2017/11/12 PHP
自动检查并替换文本框内的字符
2006/06/30 Javascript
javascript 解决表单仍然提交即使监听处理函数返回false
2010/03/14 Javascript
JavaScript 数组运用实现代码
2010/04/13 Javascript
js创建子窗口并且回传值示例代码
2013/07/02 Javascript
用js的for循环获取radio选中的值
2013/10/21 Javascript
js使用ajax读博客rss示例
2014/05/06 Javascript
IE6 hack for js 集锦
2014/09/23 Javascript
JavaScript判断变量是否为空的自定义函数分享
2015/01/31 Javascript
基于JS实现仿百度百家主页的轮播图效果
2017/03/06 Javascript
JS回调函数基本定义与用法实例分析
2017/05/24 Javascript
原生js添加一个或多个类名的方法分析
2019/07/30 Javascript
node.js事件轮询机制原理知识点
2019/12/22 Javascript
js+canvas实现纸牌游戏
2020/03/16 Javascript
JS绘图Flot如何实现动态可刷新曲线图
2020/10/16 Javascript
Cython 三分钟入门教程
2009/09/17 Python
python实现计算资源图标crc值的方法
2014/10/05 Python
朴素贝叶斯算法的python实现方法
2014/11/18 Python
python实现的系统实用log类实例
2015/06/30 Python
Python中str is not callable问题详解及解决办法
2017/02/10 Python
Python操作使用MySQL数据库的实例代码
2017/05/25 Python
python使用mysql的两种使用方式
2018/03/07 Python
Sanic框架基于类的视图用法示例
2018/07/18 Python
详解字符串在Python内部是如何省内存的
2020/02/03 Python
英国花园家具中心：Garden Furniture Centre
2017/08/24 全球购物
设计毕业生简历中的自我评价
2013/10/01 职场文书
住房公积金接收函
2014/01/09 职场文书
高等教育学自荐书范文
2014/02/10 职场文书
自行车广告词大全
2014/03/21 职场文书
留守儿童工作方案
2014/06/02 职场文书
电子信息工程专业求职信
2014/06/28 职场文书
高中历史教学反思
2016/02/19 职场文书
读完《骆驼祥子》的观后感！
2019/07/05 职场文书
ORM模型框架操作mysql数据库的方法
2021/07/25 MySQL