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 相关文章推荐
兼容firefox,chrome的网页灰度效果
Aug 08 PHP
Php header()函数语法及使用代码
Nov 04 PHP
php中HTTP_REFERER函数用法实例
Nov 21 PHP
php通过文件流方式复制文件的方法
Mar 13 PHP
php搜索文件程序分享
Oct 30 PHP
thinkphp微信开发(消息加密解密)
Dec 02 PHP
thinkPHP实现递归循环栏目并按照树形结构无限极输出的方法
May 19 PHP
几行代码轻松实现PHP文件打包下载zip
Mar 01 PHP
PHP7扩展开发之hello word实现方法详解
Jan 15 PHP
PHP使用ajax的post方式下载excel文件简单示例
Aug 06 PHP
laravel 实现根据字段不同值做不同查询
Oct 23 PHP
php设计模式之状态模式实例分析【星际争霸游戏案例】
Mar 26 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
Javascript和Ajax中文乱码吐血版解决方案
2009/12/21 Javascript
用JavaScript实现动画效果的方法
2013/07/20 Javascript
jQuery的DOM操作之删除节点示例
2014/01/03 Javascript
js动画效果制件让图片组成动画代码分享
2014/01/14 Javascript
JavaScript实现当网页加载完成后执行指定函数的方法
2015/03/21 Javascript
Bootstrap开发实战之响应式轮播图
2016/06/02 Javascript
JavaScript Base64 作为文件上传的实例代码解析
2017/02/14 Javascript
vue2实现数据请求显示loading图
2017/11/28 Javascript
vue监听用户输入和点击功能
2019/09/27 Javascript
vue的路由映射问题及解决方案
2019/10/14 Javascript
javascript实现视频弹幕效果(两个版本)
2019/11/28 Javascript
vue.js实现照片放大功能
2020/06/23 Javascript
vue使用canvas实现移动端手写签名
2020/09/22 Javascript
Vue3为什么这么快
2020/09/23 Javascript
wxPython窗口的继承机制实例分析
2014/09/28 Python
使用Python读取安卓手机的屏幕分辨率方法
2018/03/31 Python
在Python中实现替换字符串中的子串的示例
2018/10/31 Python
python 使用shutil复制图片的例子
2019/12/13 Python
python kafka 多线程消费者&amp;手动提交实例
2019/12/21 Python
解决img标签上下出现间隙的方法
2016/12/14 HTML / CSS
基于Html5实现的语音搜索功能
2019/05/13 HTML / CSS
英国户外玩具儿童游乐设备网站:TP Toys(蹦床、攀爬框架、秋千、滑梯和游戏屋)
2018/04/09 全球购物
巴西最大的在线约会网站:ParPerfeito
2018/07/11 全球购物
JSF如何进行表格处理及取值
2012/08/06 面试题
25道Java面试题集合
2013/05/21 面试题
30年同学聚会邀请函
2014/01/25 职场文书
小学生竞选班长演讲稿
2014/04/24 职场文书
个人评语大全
2014/05/04 职场文书
推广普通话演讲稿
2014/05/23 职场文书
项目经理任命书
2014/06/04 职场文书
2014年保卫工作总结
2014/12/05 职场文书
英语教师个人工作总结
2015/02/09 职场文书
公司更名通知函
2015/04/24 职场文书
党支部考察意见范文
2015/06/02 职场文书
2015暑假实习报告范文
2015/07/13 职场文书
2016清明节森林防火广播稿
2015/12/17 职场文书