PHP中的命名空间详细介绍


Posted in PHP onJuly 02, 2015

概述

PHP对于命名空间的支持,经历了一段艰难的旅程。幸运的是,PHP从5.3开始引入了命名空间。自从PHP引入了命名空间,PHP代码的适用结构也得到了大大的改善。许多编程语言早就有了命名空间的概念,相对于其他语言来说,PHP对于命名空间的支持,稍微有点晚了。不管如何,每一种新特性的引入都有其目的,和其他语言一样,PHP引入命名空间也主要是为了解决名字冲突的问题。

命名空间(namespace)的概念

当在字符串中使用命名空间名字的时候,一定不要忘了转义\

可以将命名空间想象成一个抽屉,你可以在抽屉里放入铅笔、尺子、A4纸等,这些都是你自己的私有物品。在你的抽屉下面是别人的抽屉,别人也可以在抽屉里放入相同的物品。为了不拿错物品,你们决定在自己的抽屉上贴上标签,这样就可以清晰的看到某个物品是属于谁的了。

之前,开发者必须在类、函数和常量中添加下划线,用来使自己的代码独立其他于代码库。这相当于所有人都给自己的物品贴上标签之后,一起放入了一个更大的抽屉里。尽管这也是一种组织代码的方式,但是这种方式是非常低效的。
命名空间的到来就是为了解决这个问题。我们可以在不同的命名空间里声明相同的函数、类和常量,而不会造成名字上的冲突。本质上,命名空间无非是一种分等级标记PHP代码的方式。

正在使用命名空间

有一点需要注意的是,我们正在间接的使用命名空间。从PHP 5.3开始,所有在非用户定义的命名空间中的声明(类、函数、常量),都默认的属于全局命名空间。
全局命名空间中包含了所有PHP内部的定义,如echo()、mysqli_connect()和Exception类。由于全局命名空间并没有独立的标识名,所以它经常被成为全局空间(global space)。

定义命名空间

命名空间的定义必须是PHP文件的第一条语句。唯一允许在定义命名空间之前使用的语句是declare语句。
定义命名空间很简单,只需要使用关键字namespace即可。命名空间的名字需要遵循PHP文件中其他标识符的命名规则。
下面是定义一个命名空间的示例:

namespace MyNamespace{

 class Test{

  

 }

}

如果想定义一个属于全局空间的代码块,也是使用namespace关键字,但是后面不加命名空间的名字,如下:

namespace {

 class Test{

  

 }

}

我们甚至可以在一个文件中定义多个命名空间,如下:
<?php

namespace MyNamespace {

}

 

namespace MySecondNamespace {

}

 

namespace {

}

我们也可以将一个命名空间分散在不同的文件中,文件包含的处理程序会自动合并他们。因此,限制大量的命名空间在同一个文件中定义是一个很好的编程实践,就像我们通常单独为每个类定义一个单独的文件一样。

有一点需要注意的是,包含命名空间代码块的{是可选的,可以用也可以不用。事实上,只要我们坚持在一个文件中只定义一个命名空间,那么我们就可以完全省略{,这样也可以使我们的代码看起来更加简洁。

子命名空间

命名空间可以遵循一个特定的层级,就像我们电脑文件系统中得目录一样。子命名空间对于将一个项目结构化尤其特别有用。例如,你的项目需要访问数据库,你可能会想将所有数据库相关的代码(如数据库异常处理等)放在同一个子目录下。

为了保持灵活性,将子命名空间放在子目录中是非常明智的做法。这会使你的代码结构更清晰,而且会使遵循PSR-0标准的autoloaders的使用变得更容易。

PHP使用反斜线\作为命名空间的分隔符,有趣的是,PHP甚至考虑过使用笑脸:)作为命名空间的分隔符。

子命名空间定义示例:

<?php 

namespace MyProject\Database

 

class Connection {

  }

可以使用尽可能多的子命名空间:
<?php 

namespace MyProject\Blog\Auth\Handler\Social;

 

class Twitter {

}

有一点需要注意的是,PHP并不支持命名空间的嵌套定义,下面的代码会导致一个致命错误:Namespace declarations cannot be nested。

<?php

namespace MyProject {

    namespace Database {

        class Connection { }

    }

}

从命名空间中调用代码

如果你想在不同的命名空间中实例化一个类、调用一个函数或者使用常量,需要使用反斜线\。他们可以从三个角度被解析:

1.未限定的名字
2.限定的名字
3.完全限定的名字

未限定的名字(Unqualified Name)

这是一个类的名称,函数或常量,但是不包括任何命名的引用。如果命名空间对你来说还比较陌生,那么这就是你熟悉的角度。

<?php

namespace MyProject;

 

class MyClass {

    static function static_method()

    {

        echo 'Hello, world!';

    }

}

 

// Unqualified name, resolves to the namespace you are currently in (MyProject\MyClass)

MyClass:static_method();

限定的名字(Qualified Name)

这是我们如何使用子命名空间的方式。示例如下:

<?php

namespace MyProject;

 

require 'myproject/database/connection.php';

 

// Qualified name, instantiating a class from a sub-namespace of MyProject

$connection = new Database\Connection();

完全限定的名字(Fully Qualified Name)

前面所说的使用限定的名字和未限定的名字,都是相对于当前所处的命名空间来说的。以上两种方式仅可以被用来访问当前所处的命名空间和更深层次的子命名空间。

如果想访问一个在比前命名空间更高的层级,那么就需要使用完全限定的名字—一个绝对路径而不是相对路径。这可以归结为在命名空间的最前面加反斜杠\。使用完全限定的名字可以让PHP知道,这次调用是从全局空间开始的,而不是相对于当前所处的命名空间。示例如下:

<?php

namespace MyProject\Database;

 

require 'myproject/fileaccess/input.php';

 

// Trying to access the MyProject\FileAccess\Input class

// This time it will work because we use the fully qualified name, note the leading backslash

$input = new \MyProject\FileAccess\Input();

对于PHP的内部函数来说,我们不必要使用完全限定的名字。在当前所处的命名空间中,调用一个不存在的未限定的名字的类或函数,PHP会搜索全局空间。
记住了这个规则,我们就可以像下面那样重写PHP的内部函数:
<?php

namespace MyProject;

 

var_dump($query); // Overloaded

\var_dump($query); // Internal

 

// We want to access the global Exception class

// The following will not work because there's no class called Exception in the MyProject\Database namespace and unqualified class names do not have a fallback to global space

// throw new Exception('Query failed!');

 

// Instead, we use a single backslash to indicate we want to resolve from global space

throw new \Exception('ailed!');

 

function var_dump() {

    echo 'Overloaded global var_dump()!<br />';

}

动态调用
PHP是一门动态语言,也可以将PHP的这种特性用来调用命名空间。这在本质上与实例化一个变量类和包含一个变量文件是相同的。在字符串中,PHP使用的命名空间分隔符(\)也是一个元字符,因此需要转义。

<?php

namespace OtherProject;

 

$project_name = 'MyProject';

$package_name = 'Database';

$class_name = 'Connection';

 

// Include a variable file

require strtolower($project_name . '/'. $package_name .  '/' . $class_name) . '.php';

 

// Name of a variable class in a variable namespace. Note how the backslash is escaped to use it properly

$fully_qualified_name = $project_name . '\\' . $package_name . '\\' . $class_name;

 

$connection = new $fully_qualified_name();

namespace关键字
关键字namespace不仅仅可以用来定义一个命名空间,它也可以用来显示的表示当前命名空间,它此时的作用相当于类中的self关键字。

<?php

namespace MyProject;

 

function run() 

{

    echo 'Running from a namespace!';

}

 

// Resolves to MyProject\run

run();

// Explicitly resolves to MyProject\run

namespace\run();

__NAMESPACE__常量
就像self关键字不能表示当前类的名字一样,namespace关键字也不能用来表示当前命名空间的名字。__NAMESPACE__关键字就是用来解决这个问题的。

<?php

namespace MyProject\Database;

 

// 'MyProject\Database'

echo __NAMESPACE__;

这个关键字对于判断当前代码是否从命名空间开始时非常有用,而且也可以用来调试代码。

导入或别名
PHP中得命名空间也支持导入,导入也被成为别名。只有类、接口和命名空间可以被导入(别名)。导入是命名空间中一个非常有用和基础的功能。它使我们可以使用外部的代码包,而不用担心名字的冲突。使用use关键字可以实现导入功能。也可以使用as关键字,在导入的时候指定一个别名。

use [name of class, interface or namespace] as [optional_custom_alias]

一个完全限定的名字可以用一个未限定的别名来代替,这样我们就不用在每次使用的时候都使用完全限定的名字,达到简化代码的目的。导入应该在命名空间的最高层或者全局空间中使用,在函数作用域内使用导入功能是非法的语法。

<?php

namespace OtherProject;

 

// This holds the MyProject\Database namespace with a Connection class in it

require 'myproject/database/connection.php';

 

// If we want to access the database connection of MyProject, we need to use its fully qualified name as we're in a different name space

$connection = new \MyProject\Database\Connection();

 

// Import the Connection class (it works exactly the same with interfaces)

use MyProject\Database\Connection;

 

// Now this works too! Before the Connection class was aliased PHP would not have found an OtherProject\Connection class

$connection = new Connection();

 

// Import the MyProject\Database namespace

use MyProject\Database;

 

$connection = new Database\Connection()

我们可以通过使用别名来简化上面的代码:
<?php

namespace OtherProject;

 

require 'myproject/database/connection.php';

 

use MyProject\Database\Connection as MyConnection;

 

$connection = new MyConnection();

 

use MyProject\Database as MyDatabase;

 

$connection = new MyDatabase\Connection();

总结

命名空间是用来避免定义冲突,并且为代码引入了更加灵活和组织的方式。有一点需要注意的时,我们并没有义务去使用命名空间,它是和面向对象结合使用的一种工作方式。但是,如果使用了命名空间,我们的代码可能会达到一种新的层次,逼格也会显得更高吧。

PHP 相关文章推荐
PHP中实现图片的锐化
Oct 09 PHP
php下载远程文件类(支持断点续传)
Nov 14 PHP
PHP $_FILES中error返回值详解
Jan 30 PHP
ThinkPHP项目分组配置方法分析
Mar 23 PHP
PHP7+Nginx的配置与安装教程详解
May 10 PHP
php rmdir使用递归函数删除非空目录实例详解
Oct 20 PHP
PHP-FPM运行状态的实时查看及监控详解
Nov 18 PHP
php从身份证获取性别和出生年月
Feb 09 PHP
laravel 5.4 + vue + vux + element的环境搭配过程介绍
Apr 26 PHP
PHP实现搜索时记住状态的方法示例
May 11 PHP
PHP利用DWZ.CN服务生成短网址
Aug 11 PHP
laravel 去掉index.php伪静态的操作方法
Oct 12 PHP
PHP+JS实现大规模数据提交的方法
Jul 02 #PHP
PHP中iconv函数知识汇总
Jul 02 #PHP
php统计数组元素个数的方法
Jul 02 #PHP
mod_php、FastCGI、PHP-FPM等PHP运行方式对比
Jul 02 #PHP
PHP中的流(streams)浅析
Jul 02 #PHP
PHP curl使用实例
Jul 02 #PHP
PHP中使用curl入门教程
Jul 02 #PHP
You might like
测试您的 PHP 水平的题目
2007/05/30 PHP
解析MySql与Java的时间类型
2013/06/22 PHP
10个值得深思的PHP面试题
2016/11/14 PHP
PHP进程通信基础之信号
2017/02/19 PHP
PHP内置函数生成随机数实例
2019/01/18 PHP
有效的捕获JavaScript焦点的方法小结
2009/10/08 Javascript
ECMAScript 创建自己的js类库
2012/11/22 Javascript
js中用window.open()打开多个窗口的name问题
2014/03/13 Javascript
Javascript window对象详解
2014/11/12 Javascript
JavaScript中的console.log()函数详细介绍
2014/12/29 Javascript
jQuery大于号(&gt;)选择器的作用解释
2015/01/13 Javascript
微信小程序页面开发注意事项整理
2017/05/18 Javascript
angular.js指令中transclude选项及ng-transclude指令详解
2017/05/24 Javascript
微信小程序自定义组件
2017/08/16 Javascript
jquery一键控制checkbox全选、反选或全不选
2017/10/16 jQuery
js实现图片推拉门效果代码实例
2019/05/18 Javascript
[02:36]DOTA2混沌骑士 英雄基础教程
2013/11/26 DOTA
[06:24]DOTA2亚洲邀请赛小组赛第三日 TOP10精彩集锦
2015/02/01 DOTA
一步步教你用Python实现2048小游戏
2017/01/19 Python
Python设计模式之命令模式原理与用法实例分析
2019/01/11 Python
分析运行中的 Python 进程详细解析
2019/06/22 Python
keras做CNN的训练误差loss的下降操作
2020/06/22 Python
Python实现七个基本算法的实例代码
2020/10/08 Python
CSS3中的content属性使用示例
2015/07/20 HTML / CSS
html5唤起app的方法
2017/11/30 HTML / CSS
HTML实现代码雨源码及效果示例
2020/02/25 HTML / CSS
BCBG官网:BCBGMAXAZRIA
2017/12/29 全球购物
IGK Hair官网:喷雾、洗发水、护发素等
2020/11/03 全球购物
医科学校毕业生自荐信
2013/11/09 职场文书
大学生简短的自我评价分享
2014/02/20 职场文书
北体毕业生求职信
2014/02/28 职场文书
放飞中国梦演讲稿
2014/04/23 职场文书
关于护士节的演讲稿
2014/05/26 职场文书
2016年寒假政治学习心得体会
2015/10/09 职场文书
拔河比赛队名及霸气口号
2015/12/24 职场文书
JavaScript 数组去重详解
2021/09/15 Javascript