[翻译]如何使用PHP命名空间(一):基础知识

命名空间是一个重要的概念。该系列文章详细介绍了PHP对命名空间的支持及用法。原文地址:http://www.sitepoint.com/php-53-namespaces-basics/


命名空间是PHP 5.3诸多重要更新中的一个。它会使C#和Java开发者感到友好,同时很有希望使PHP应用的程序结构变得更好。

为什么需要命名空间?
     随着你的PHP代码库的增长,意外重定义之前已声明过的函数的风险也在增加。这个问题会在引入第三方组件或插件时恶化——如果多段代码都实现了"Database"或者"User"类, 会发生什么呢?  
     直到现在,唯一的解决方案就是命名一个较长的类或函数名。例如,WordPress在每一个命名前使用"WP_"前缀。Zend Framework使用高度可描述的命名约定,而这会导致产生诸如Zend_Search_Lucene_Analysis_Analyzer_Common_Text_CaseInsensitive这样冗长的类名。
     命名空间可解决命名冲突的问题。可以把PHP常量、类和函数组织到使用了命名空间的代码库中。

如何定义命名空间?
     默认情况下,所有的常量、类及函数命名都位于全局空间内——就像PHP未支持命名空间之前的样子。
     命名空间化的代码在PHP文件的顶部使用namespace关键字。该关键字之前不能有PHP或HTML代码,只可有空白字符或declare关键字。
<?php

// define this code in the 'MyProject' namespace

namespace MyProject;

// ... code ...

  在namespace关键字之后的代码都会纳入"MyProject"命名空间。命名空间不能嵌套或在同一代码处声明多次(只有最后一次会被识别)。但是,你能在同一个文件中定义多个命名空间化的代码。

<?php

namespace MyProject1;

// PHP code for the MyProject1 namespace

namespace MyProject2;

// PHP code for the MyProject2 namespace

// Alternative syntax

namespace MyProject3 {

	// PHP code for the MyProject3 namespace

}

?>

  虽然这种用法从语法方面讲是可行的,但明智的做法是每个文件定义一个命名空间。

  子命名空间
     PHP允许定义命名空间层级。子命名空间使用反斜线来分隔。例如:
  • MyProject\SubName
  • MyProject\Database\MySQL
  • CompanyName\MyProject\Library\Common\Widget1
调用已命名空间化的代码
     在lib1.php文件中的App\Lib1命名空间内定义一个常量、一个函数以及一个类
  lib1.php
<?php

// application library 1

namespace App\Lib1;

const MYCONST = 'App\Lib1\MYCONST';

function MyFunction() {

     return __FUNCTION__;

}

class MyClass {

     static function WhoAmI() {

          return __METHOD__;

     }

}

?>

  在另一个PHP文件中包含此文件。

  myapp.php

<?php

header('Content-type: text/plain');

require_once('lib1.php');

echo \App\Lib1\MYCONST . "\n";

echo \App\Lib1\MyFunction() . "\n";

echo \App\Lib1\MyClass::WhoAmI() . "\n";

?>

  因在myapp.php中未定义任何命名空间,所以全部代码都位于全局空间内。任何对MYCONST、MyFunction 或者MyClass 的直接引用都会失败,因为他们位于App\Lib1命名空间内。当想调用lib1.php中的代码,必须加上"\App\Lib1"前缀形成完全限定名(fully-qualified names)。myapp.php的运行结果为:
App\Lib1\MYCONST

App\Lib1\MyFunction

App\Lib1\MyClass::WhoAmI

  完全限定名也会很长,而且相对于诸如 App-Lib1-MyClass这样的长类名并无明显好处。因此,在下篇文章中将会讨论命名空间别名,同时对PHP如何处理命名空间做近距离观察。



你可能感兴趣的:(namespace)