[翻译]如何使用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) 编辑 收藏 举报