PHP命名空间(Namespace)的使用详解

时间 2019-11-08

标签 php 命名空间 namespace 使用详解栏目 PHP 繁體版

原文原文链接

对于命名空间，官方的文档已经说的很详细，在这里我作了一下实践和总结。php

命名空间一个最明确的目的就是解决重名问题。Php中不容许两个函数或者类出现相同的名字，不然会产生一个致命的错误。这种状况下只要避免命名重复就能够解决，最多见的一种作法是约定一个前缀。html

例：项目中有两个模块：article和message board，它们各自有一个处理用户留言的类comment。以后我可能要增长对全部用户留言的一些信息统计功能，好比说我想要获得全部留言的数量。这时候调用它们comment提供的方法是很好的作法，可是同时引入各自的comment类显然是不行的，代码会出错，在另外一个地方重写一个comment也会下降维护性。那这时只能重构类名，我约定一个命名规则，在类名前面加上模块名，像这样：article_comment、messageBoard_comment。ide

能够看到，名字变得很长，那就意味着之后使用comment的时候会写上更多的代码。而且，之后若是要对各个模块增长更多的一些整合功能，或者是互相调用，发生重名的时候就须要重构名字。固然在项目开始的时候就注意到这个问题，并规定命名规则就能很好的避免这个问题。另外一个解决方法是能够考虑使用命名空间。函数

注明：本文提到的常量php5.3开始const关键字能够用在类的外部。Const和define都是来声明常量的，可是在命名空间里，define的做用是全局的，而const则做用与当前的空间。我在文中提到的常量是使用const声明的常量。spa

基础：命名空间将代码划分出不一样放入空间（区域），每一个空间的常量、函数、类的名字互不影响，这个有点相似咱们经常提到的’封装’的概念。code

建立一个命名空间须要使用 namespace关键词：htm

<?php
// 建立一个名为‘Article’的命名空间
namespace Article;
?>

注：当前脚本的第一个命名空间前面不能有任何代码，下面的写法是错误的：blog

<?php
// 在脚本前面写了一些逻辑代码
$path = '/';
class Comment{}
namespace Article;
?>

为何要说第一个命名空间呢？由于同一个脚本文件中能够建立多个命名空间。ci

下面我建立了两个命名空间，顺便为这两个空间各自添加一个Comment类元素：文档

在不一样空间之间不能够直接调用其余元素，须要使用命名空间的语法：

<?php
// 建立一个名为“Article”的命名空间
namespace Article;
// 此Comment属于Article空间的元素
class Comment{}

// 建立一个名为“MessageBoard”的命名空间
namespace MessageBoard;
// 此Comment属于MessageBoard空间元素
class Comment{}

// 调用当前空间（MessageBoard）的Comment类
$comment = new Comment();

// 调用Article空间的Comment类
$article_comment = new \Article\Comment();
?>

能够看到，在MessageBoard 空间中调用Article空间里的Comment类时，使用了一种像文件路径的语法：\空间名\元素名。

除了类以外，对函数和常量的用法是同样的，下面我为两个空间建立了新的元素，并在MessageBoard空间中输出了它们的值。

<?php
namespace Article;
const PATH = '/article';
function getCommentTotal(){
return 100;
}
class Comment{}

namespace MessageBoard;
const PATH = '/message_board';
function getCommentTotal(){
return 300;
}
class Comment{}

// 调用当前空间的常量、函数和类
echo PATH;
echo getCommentTotal();
$comment = new Comment();

// 调用Article空间的常量、函数和类
echo \Article\PATH;
echo \Article\getCommentTotal();
$article_comment = new \Article\Comment();
?>

子空间：命名空间的调用语法像文件路径同样是有道理的，它容许咱们自定义子空间来描述各个空间之间的关系。

Article和message board这两个模块都是处于同一个blog项目内。若是用命名空间来表示它们的关系，是这样：

<?php
// 我用这样的命名空间表示处于blog下的article模块
namespace Blog\Article;
class Comment{}

// 我用这样的命名空间来表示处于blog下的message board模块
namespace Blog\MessageBlog;
class Comment{}

// 调用当前空间的类
$comment = new Comment();

// 调用Blog\Article空间的类
$article_comment = new \Blog\Article\Comment();
?>

而却，子空间还能够定义不少层次，好比说Blog\Article\Archives\Date

公共空间：我有一个common_inc.php脚本文件，里面有一些好用的函数和类。

<?php
function getIP(){}
class FilterXSS{}
?>

在一个命名空间里引入这个脚本文件，脚本里的元素不会归属到这个命名空间。若是这个脚本里没有定义其余命名空间，它的元素始终处于公共空间中：

<?php
namespace Blog\Article;
// 引入脚本文件
include './common_inc.php';
$filter_XSS = new FilterXSS(); // 出现致命错误，找不到Blog\Article\FilterXSS类
$filter_XSS = new \FilterXSS(); // 正确
?>

调用公共空间的方式直接在元素名称前加’\‘就能够了，不然php解析器会认为我想要调用当前空间下的元素。除了自定义的元素，还包括php自带的元素，都属于公共空间。

名称术语：在别名和导入以前，须要知道关于空间三种名称术语，以及php是怎样解析它们的。

一、非限定名称，或不包括前缀的类名称。例如$comment = new Comment();。若是当前命名空间是Blog\Article，Comment将被解析为Blog\Article\Comment。若是使用Comment的代码不包括在任何命名空间中（全局空间），则Comment会被解析为Comment。

二、限定名称，或包括前缀的名称。例如$comment = new Article\Comment();。若是当前的命名空间是Blog，则Comment会被解析为Blog\Article\Comment。若是使用Comment的代码不包括在任何命名空间中（全局空间），则Comment会被解析为Comment。

三、彻底限定名称，或包含了全局前缀操做符的名称。例如$comment = new \Article\Comment();。在这种状况下，Comment老是被解析为代码中的文字名(literal name)Article\COmment。

其实能够把这三种名称类比为文件名（例如 comment.php）、相对路径名（例如./article/comment.php）、绝对路径名（例如/blog/article/comment.php），这样可能更容易理解。

<?php
// 建立空间Blog
namespace Blog;
class comment{}

// 非限定名称，表示当前Blog空间
//这个调用将被解析成Blog\Comment()
$blog_comment = new Comment();

// 限定名称，表示相对于Blog空间
//这个调用将被解析成Blog\Article\Comment()
$article_comment = new Article\Comment();

// 彻底限定名称，表示绝对于Blog空间
//这个调用将被解析成Blog\comment()
$article_comment = new \Blog\Comment();

// 彻底限定名称，表示绝对于Blog空间
//这个调用将被解析成Blog\Article\Comment()
$article_comment = new \Blog\Article\Comment();

// 建立Blog的子空间Article
namespace Blog\Article;
class Comment{}
?>

别名和导入：能够看做是调用命名空间元素的一种快捷方式。

<?php
namespace Blog\Article;
class Comment{}

// 建立一个BBS空间
namespace BBS;

// 导入一个命名空间
use Blog\Article;
// 导入命名空间后可以使用限定名称调用元素
$article_comment = new Article\Comment();

// 为命名空间使用别名
use Blog\Article as Arte;
// 使用别名代替空间名
$article_comment = new Arte\Comment();

// 导入一个类
use Blog\Article\Comment;
// 导入类后可以使用非限定名称调用元素
$article_comment = new Comment();

// 为类使用别名
use Blog\Article\Comment as Comt;
// 使用别名代替空间名
$article_comment = new Comt();
?>

若是导入元素的时候，当前空间有相同的名字元素将会怎样？显然结果会发生致命错误。

<?php
namespace Blog\Article;
class Comment{}

// 建立一个BBS空间
namespace BBS;
class Comment{}
class Comt{}

// 导入一个类
use Blog\Article\Comment;
$article_comment = new Comment(); // 与当前空间的Comment发生冲突，程序产生致命错误

//为类使用别名
use Blog\Article\Comment as Comt;
$article_comment = new Comt(); // 与当前空间的Comt发生冲突，程序产生致命错误
?>

动态调用：php提供了namespace关键字和__NAMESPACE__魔法常量动态的访问元素，__NAMESPACE__能够经过组合字符串的形式来动态的访问。

<?php
namespace Blog\Article;
const PATH = '/Blog/article';
class Comment{}

// namespace关键字表示当前空间
echo namespace\PATH;
$comment = new namespace\Comment();

// 魔法常量__NAMESPACE__的值是当前空间的名称
echo __NAMESPACE__;

// 能够组合成字符串并调用
$comment_class_name = __NAMESPACE__.'\Comment';
$comment = new $comment_class_name();
?>

字符串形式调用问题：上面的动态调用的例子中，咱们看到了字符串形式的动态调用方式，若是要使用这种方式要注意两个问题。

一、使用双引号的时候特殊字符串可能被转义

<?php
namespace Blog\Article;
const PATH = '/Blog/article';
class name{}

// 我想调用Blog\Article\name
$class_name = __NAMESPACE__."\name"; // 可是\n将被转义为换行符
$name = new $class_name(); // 发生致命的错误
?>

二、不会认为是限定名称：php在编译脚本的时候就肯定了元素所在的空间，以及导入的状况。而在解析脚本时字符串形式调用只能认为是非限定名称和彻底限定名称，而永远不多是限定名称。

<?php
namespace Blog;

// 导入Common类
use Blog\Article\Common;
// 我想使用非限定名称调用Blog\Article\Common
$common_class_name = 'Common';
// 实际会被看成非限定名称，也就表示当前空间的Common类，但我当前空间没有穿件Common类
$common = new $common_class_name(); // 发生致命错误，Common类不存在
//$common = new Common();

//我想使用限定名称调用Blog\Article\Common
$common_class_name = 'Article\Common';
// 实际会被看成彻底限定名称，也就是表示Article空间下的Common类，但我下面只定义了Blog\Article空间而不是Article空间
$common = new $common_class_name(); // 发生致命错误，Article\Common类不存在
//$common = new Article\Common();

namespace Blog\Article;
class Common{} ?>