最新公告
  • 欢迎您访问爱上源码网,分享精品整站源码,网站模板,游戏源码,APP小程序源码以及视频教程免费下载;服务永无止境!立即加入我们
  • PHP——命名空间(namespace)使用详细介绍

    对于命名空间,官方文档已经说得很详细[查看],我在这里做了一下实践和总结。

    命名空间一个最明确的目的就是解决重名问题,PHP中不允许两个函数或者类出现相同的名字,否则会产生一个致命的错误。这种情况下只要避免命名重复就可以解决,最常见的一种做法是约定一个前缀。

    例:项目中有两个模块:article和message board,它们各自有一个处理用户留言的类Comment。之后我可能想要增加对所有用户留言的一些信息统计功能,比如说我想得到所有留言的数量。这时候调用它们Comment提供的方法是很好的做法,但是同时引入各自的Comment类显然是不行的,代码会出错,在另一个地方重写任何一个Comment也会降低维护性。那这时只能重构类名,我约定了一个命名规则,在类名前面加上模块名,像这样:Article_Comment、MessageBoard_Comment

    可以看到,名字变得很长,那意味着以后使用Comment的时候会写上更多的代码(至少字符多了)。并且,以后如果要对各个模块增加更多的一些整合功能,或者是互相调用,发生重名的时候就需要重构名字。当然在项目开始的时候就注意到这个问题,并规定命名规则就能很好的避免这个问题。另一个解决方法可以考虑使用命名空间。

    注明:

    本文提到的常量:PHP5.3开始const关键字可以用在类的外部。const和define都是用来声明常量的(它们的区别不详述),但是在命名空间里,define的作用是全局的,而const则作用于当前空间。我在文中提到的常量是指使用const声明的常量。

    基础:

    命名空间将代码划分出不同的空间(区域),每个空间的常量、函数、类(为了偷懒,我下边都将它们称为元素)的名字互不影响, 这个有点类似我们常常提到的‘封装’的概念。

    创建一个命名空间需要使用namespace关键字

    代码如下:

    <?php 
    //创建一个名为'Article'的命名空间
    namespace Article;
    ?>

    要注意的是,当前脚本文件的第一个命名空间前面不能有任何代码,下面的写法都是错误的:

    代码如下:

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

    或者如下:

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

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

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

    代码如下:

    <?php 
    //创建一个名为'Article'的命名空间
    namespace Article;
    //此Comment属于Article空间的元素
    class Comment { }
    
    //创建一个名为'MessageBoard'的命名空间
    namespace MessageBoard;
    //此Comment属于MessageBoard空间的元素
    class Comment { }
    ?>

    在不同空间之间不可以直接调用其它元素,需要使用命名空间的语法:

    代码如下:

    <?php 
    namespace Article;
    class Comment { }
    
    namespace 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; ///message_board
    echo getCommentTotal(); //300
    $comment = new Comment();
    //调用Article空间的常量、函数和类
    echo \Article\PATH; ///article
    echo \Article\getCommentTotal(); //100
    $article_comment = new \Article\Comment();
    ?>

    子空间:

    命名空间的调用语法像文件路径一样是有道理的,它允许我们自定义子空间来描述各个空间之间的关系。

    抱歉我忘了说,article和message board这两个模块其实都是处于同一个blog项目内。如果用命名空间来表达它们的关系

    <?php 
    //我用这样的命名空间表示处于blog下的article模块
    namespace Blog\Article;
    class Comment { }
    
    //我用这样的命名空间表示处于blog下的message board模块
    namespace Blog\MessageBoard;
    class Comment { }
    //调用当前空间的类
    $comment = new Comment();
    //调用Blog\Article空间的类
    $article_comment = new \Blog\Article\Comment();
    ?>

    公共空间

    我有一个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为什么要这样做),但是为了正确区分元素,还是建议调用函数的时候加上 \

    3、名称术语

    在说别名和导入之前,需要知道关于空间三种名称的术语,以及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并不支持导入函数或常量。

    它们都是通过使用use操作符来实现

    代码如下:

    <?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 { }
    
    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; ///Blog/article
    $comment = new namespace\Comment();
    //魔法常量__NAMESPACE__的值是当前空间名称
    echo __NAMESPACE__; //Blog\Article
    //可以组合成字符串并调用
    $comment_class_name = __NAMESPACE__ . '\Comment';
    $comment = new $comment_class_name();
    ?>

    字符串形式调用问题:

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

    1、使用””时特殊字符可能被转义

    <?php 
    namespace 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类不存在
    //我想使用限定名称调用Blog\Article\Common
    $common_class_name = 'Article\Common';
    //实际会被当作完全限定名称,也就表示Article空间下的Common类,但我下面只定义了Blog\Article空间而不是Article空间
    $common = new $common_class_name(); //发生致命错误:Article\Common类不存在
    
    namespace Blog\Article;
    class Common { }
    ?>

    总结
    我对PHP的命名空间刚刚接触,也不能随便给一些没有实践的建议。我个人认为命名空间的作用和功能都很强大,如果要写插件或者通用库的时候再也不用担心重名问题。不过如果项目进行到一定程度,要通过增加命名空间去解决重名问题,我觉得工作量不会比重构名字少。也不得不承认它的语法会对项目增加一定的复杂度,因此从项目一开始的时候就应该很好的规划它,并制定一个命名规范。

    更多相关问题请访问PHP中文网:PHP视频教程

    以上就是PHP——命名空间(namespace)使用详细介绍的详细内容,更多请关注爱上源码网其它相关文章!

  • 微信
  • 分享
  • 相关标签:namespace
  • 本文转载于:博客园,如有侵犯,请联系916990011@qq.com删除
    • 上一篇:TP5框架下MySQL通过LOAD DATA INFILE批量导入数据详细操作
    • 下一篇:PHP魔术常量、魔术函数、预定义常量详细介绍及实例讲解

    相关文章

    相关视频

    • PHP命名空间namespace定义详解
    • php命名空间的namespace关键字
    • PHP命名空间(namespace)
    • PHP命令空间namespace及use的用法(实…
    • PHP——命名空间(namespace)使用详细介…
    • 重载的方法的课堂练习评讲
    • 属性的重载
    • 方法重载

    本文有爱上源码下载完入驻作者发布,如果对您版权造成侵害,可以联系本站站长管理进行维权删除,本站收到维权24小时内进行处理,谢谢您关注23ym.cn!
    本站分享大量程序员技术文章以及对编程开发的初级入门教程,包括图文讲解笔记和高清视频下载~

    重要声明:
    1.本站视频教程,软件及网站源码版权均属于原作者所有,您必须在下载后的24个小时之内,从您的电脑中删除!非法商业用途,后果自负!
    2.本站不保证所提供下载资源的安全性和完整性,仅供下载学习之用!如链接失效或资源含外站广告,请联系客服处理!给予奖励!
    3.本站所有资源来源于用户上传和网络,因此不包含技术服务请大家谅解!本站提供有偿服务!如有侵权请联系在线客服!
    4.如您手中有优质资源或教程,可以自助投稿发布,成功分享后有奖励和额外收入!
    5.如您需要正版微擎模块可联系本站客服,我们有价值30w+商业微擎应用出售微擎坑位和招收代理!
    6.400电话/软著/ICP,EDI许可证/商标特价办理中!
    爱上源码下载网 » PHP——命名空间(namespace)使用详细介绍

    常见问题FAQ

    从网站下载的源码都有安装教程么?不会安装怎么办?
    本站发布的网站源码和模板资源大部分在压缩包内都有教程,如您不会安装可以联系本站在线技术进行付费安装。
    爱上源码的所有源码都是亲测能正常运行的么?
    本站目前拥有资源10w+,包含整站源码,网站模板,游戏源码,小程序源码,视频教程,破解软件等,每天也在测试更新;因时间和精力有限我们无法对资源进行一一测试,只能保证所分享资源内容无误,希望理解。
    我手中的优质资源可以在你这换钱或者VIP么?
    爱上源码支持投稿,欢迎发布您手中的优质资源进行售卖;本站VIP支持免费获取,目前邀请10人注册爱上源码即可免费获取VIP。
    爱上源码除了资源分享还有其他业务没?
    【价值30W+微擎模块出售正版商业微擎坑位及招收代理,详情咨询本站客服!】我们团队目前运营并推广几套商业化saas智能小程序系统能满足大部分小程序开发需求,并由SaaS和独立部署版商城小程序系统;另外销售400电话,各种ICP/EDI资质证书办理,软著和商标注册服务等。

    发表评论

    • 32会员总数(位)
    • 35644资源总数(个)
    • 0本周发布(个)
    • 0 今日发布(个)
    • 657稳定运行(天)

    提供最优质的资源集合

    开通VIP 源码下载