php基础之初识namespace命名空间

冰芒 PHP 2018-02-01 68 次浏览 没有评论

6.jpg

在应用程序开发过程中,类和类成员的名称是丰富的,为了描述一个具体的对象,需要对类成员进行设计。在设计类和类成员过程中,不可避免的类成员中的方法或者类的名称会出现相同的情况,这样就会使类的使用变得复杂,代码的混乱造成可读性降低,使用命名空间可以解决此类难题。

引入的多个文件中可能存在同名的类、函数、常量,就会报错(重复定义的错误),比如下图

6.jpg

运行结果:

8.jpg

PHP如何使用命名空间 namespace

对a.php和b.php分别定义命名空间,

9.png

10.png

注意:第一个命名空间前面不能有任何代码。

下面的写法是错误的:

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

<html></html>
<?php
//在脚本的前面输出了一些字符
namespace Article;
?>

为什么要说第一个命名空间呢?因为同一个脚本文件中可以创建多个命名空间。

使用了命名空间怎么调用对应的函数呢?

\命名空间名\空间名下的函数

12.png

对于和常量也是同理,代码可以下参见下文的命名空间实例


使用命名空间 优势

简单的说,就是解决代码冲突。具体如下:

使用框架、第三方类库,可以避免的类、函数、常量的冲突。

可以分工协作,有利于多人同时开发一个项目,提高开发效率。

定义命名空间

一旦namespace声明了命名空间,后面的代码都属于该空间。

在定义的命名空间之前不能有任何输出。如html代码等。

在声明命名空间之前唯一合法的代码是用于定义源文件编码方式的 declare 语句,如:declare(encoding='UTF-8');

项目中,只在一个php文件的开头进行定义命名空间,并且只定义一个。

通常该命名空间要遵循PSR-0命名规范(命名空间和目录结构保持一致)。

空间分类

分为两类:全局空间 和 命名空间

全局空间

不在namespace声明的空间里面的代码都属于全局空间。

命名空间

如:namespace Think;

如:namespace Think\Controller; 这种反斜线分割的、层次化的,就是子命名空间。

如果需要在命名空间使用全局空间的类、函数、常量,在调用时,需要加上反斜线(代表全局空间)。

命名空间的使用

使用限定名称、非限定名称访问

非限定名称:  访问当前命名空间。(在当前文件中直接使用)

限定名称:     类似于相对路径,访问当前空间下的子命名空间,如:new People\Person();

完全限定名称:类似于绝对路径,访问全局空间,如:new \Person();实例化全局空间下的Person类

导入 命名空间,然后直接使用

语法:use 命名空间,可以起别名(as 别名)。

目的:在当前文件中使用其他命名空间的 类、函数、常量。(使用时,就不用加上限定名称)

命名空间实例

下面我创建了两个命名空间,顺便为这两个空间各自添加一个Comment类元素:

<?php
//创建一个名为“Article”的命名空间
namespace Article;
//此Comment属于Article空间的元素
class Comment{}
//创建一个名为“MessageBoard”的命名空间
namespace MessageBoard;
//此Comment属于MessageBoard空间元素
class 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是怎样解析它们的。

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

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

3、完全限定名称,或包含了全局前缀操作符的名称。例如$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();
?>

字符串形式调用问题:上面的动态调用的例子中,我们看到了字符串形式的动态调用方式,如果要使用这种方式要注意两个问题。

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

<?php
namespace Blog\Article;
const PATH = '/Blog/article';
class name{}
//我想调用Blog\Article\name
$class_name = __NAMESPACE__."\name";//但是\n将被转义为换行符
$name = new $class_name();//发生致命的错误
?>

2、不会认为是限定名称: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{}
?>

发表评论

电子邮件地址不会被公开。 必填项已用*标注

回顶部