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

cvlig

　　命名空间是一个重要的概念。该系列文章详细介绍了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如何处理命名空间做近距离观察。