[翻译]如何使用PHP命名空间(一):基础知识 <How to Use PHP Namespaces, Part 1: The Basics>

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



posted on 2011-10-31 14:28  followflows  阅读(2457)  评论(1编辑  收藏  举报

导航