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 输出简单动态WAP页面
Jun 09 PHP
关于Appserv无法打开localhost问题的解决方法
Oct 16 PHP
PHP数组内存耗用太多问题的解决方法
Apr 05 PHP
PHP生成Gif图片验证码
Oct 27 PHP
PHP引用(&amp;)各种使用方法实例详解
Mar 20 PHP
PHP中开启gzip压缩的2种方法
Jan 31 PHP
PHP实现自动对图片进行滚动显示的方法
Mar 12 PHP
PHP写的简单数字验证码实例
May 23 PHP
PHP在弹框中获取foreach中遍历的id值并传递给地址栏
Jun 13 PHP
PHP实现表单提交数据的验证处理功能【防SQL注入和XSS攻击等】
Jul 21 PHP
PHP实现分布式memcache设置web集群session同步的方法
Apr 10 PHP
PHP 技巧 * SVG 保存为图片(分享图生成)
Apr 02 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
Terran历史背景
2020/03/14 星际争霸
php 生成WML页面方法详解
2009/08/09 PHP
PHP处理CSV表格文件的常用操作方法总结
2016/07/01 PHP
javascript打开新窗口同时关闭旧窗口
2009/01/16 Javascript
EasyUI中的tree用法介绍
2011/11/01 Javascript
js中页面的重新加载(当前页面/上级页面)及frame或iframe元素引用介绍
2013/01/24 Javascript
jQuery之字体大小的设置方法
2014/02/27 Javascript
JavaScript判断FileUpload控件上传文件类型
2015/09/28 Javascript
EasyUI加载完Html内容样式渲染完成后显示
2016/07/25 Javascript
jQuery序列化表单成对象的简单实现
2016/11/29 Javascript
详解js几个绕不开的事件兼容写法
2017/08/30 Javascript
JS使用tofixed与round处理数据四舍五入的区别
2017/10/25 Javascript
Vue2.0实现组件数据的双向绑定问题
2018/03/06 Javascript
JQuery实现ajax请求的示例和注意事项
2018/12/10 jQuery
深入理解JavaScript 箭头函数
2019/05/30 Javascript
[03:24]CDEC.Y赛前采访 努力备战2016国际邀请赛中国区预选赛
2016/06/25 DOTA
Python科学画图代码分享
2017/11/29 Python
python之线程通过信号pyqtSignal刷新ui的方法
2019/01/11 Python
python 字典访问的三种方法小结
2019/12/05 Python
解决tensorboard多个events文件显示紊乱的问题
2020/02/15 Python
python matplotlib包图像配色方案分享
2020/03/14 Python
python求解汉诺塔游戏
2020/07/09 Python
Python使用Selenium模拟浏览器自动操作功能
2020/09/08 Python
python 用opencv实现图像修复和图像金字塔
2020/11/27 Python
使用HTML5的File实现base64和图片的互转
2013/08/01 HTML / CSS
Woolworth官网:澳洲第一大超市
2017/06/25 全球购物
泰国健康和美容服务预订网站:GoWabi
2019/06/03 全球购物
俄罗斯达美乐比萨外送服务:Domino’s Pizza
2020/12/18 全球购物
thinkphp5 redis缓存新增方法实例讲解
2021/03/24 PHP
招商经理岗位职责
2013/11/16 职场文书
机械个人求职信范文
2014/01/24 职场文书
中学家长会邀请函
2014/02/03 职场文书
小学红领巾广播稿(3篇)
2014/09/13 职场文书
2014年政风行风评议工作总结
2014/10/21 职场文书
公司表扬信格式
2015/05/04 职场文书
小学班级标语口号大全
2015/12/26 职场文书