文档章节

[中高级] PHP命名空间规则解析及高级功能

be-quiet
 be-quiet
发布于 2015/02/27 11:10
字数 1926
阅读 22
收藏 0
为了便于对比,我定义了两个几乎一样的代码块,只有命名空间的名字不同。
lib1.php
< ?php  
// application library 1  
namespace App\Lib1;  
 
const MYCONST = 'App\Lib1\MYCONST';  
 
function MyFunction() {  
 return __FUNCTION__;  
}  
 
class MyClass {  
 static function WhoAmI() {  
eturn __METHOD__;  
 }  
}  
?>  


lib2.php
< ?php  
// application library 2  
namespace App\Lib2;  
 
const MYCONST = 'App\Lib2\MYCONST';  
 
function MyFunction() {  
 return __FUNCTION__;  
}  
 
class MyClass {  
 static function WhoAmI() {  
eturn __METHOD__;  
 }  
}  
?>
开始之前先要理解几个PHP命名空间相关术语。

◆完全限定名称(Fully-qualified name)

    任何PHP代码都可以引用完全限定名称,它是一个以命名空间反斜线开头的标识符,如\App\Lib1\MYCONST,\App\Lib2\MyFunction( )等。

    完全限定名称是没有任何歧义的,开头的反斜线和文件路径的作用有点类似,它表示“根”全局空间,如果我们在全局空间中实现了一个不同的MyFunction( ),可以使用\MyFunction( )从lib1.php或lib2.php调用它。

    完全限定名称对一次性函数调用或对象初始化非常有用,但当你产生了大量的调用时它们就没有实用价值了,在下面的讨论中我们将会看到,PHP提供了其它选项以解除我们为命名空间打字的烦恼。

◆限定名称(Qualified name)

    至少有一个命名空间分隔符的标识符,如Lib1\MyFunction( )。

◆非限定名称(Unqualified name)

    没有命名空间分隔符的标识符,如MyFunction( )。

在相同的命名空间内工作

仔细思考下面的代码:
myapp1.php

< ?php  
namespace App\Lib1;  
 
require_once('lib1.php');  
require_once('lib2.php');  
 
header('Content-type: text/plain');  
echo MYCONST . "\n";  
echo MyFunction() . "\n";  
echo MyClass::WhoAmI() . "\n";  
?>
    即使我们同时包括了lib1.php和lib2.php,MYCONST,MyFunction和MyClass标识符只能在lib1.php中引用,这是因为myapp1.php的代码在相同的App\Lib1命名空间内。

    执行结果:
App\Lib1\MYCONST  
App\Lib1\MyFunction  
App\Lib1\MyClass::WhoAmI

命名空间导入

可以使用 use操作符导入命名空间,如:
myapp2.php
< ?php  
use App\Lib2;  
 
require_once('lib1.php');  
require_once('lib2.php');  
 
header('Content-type: text/plain');  
echo Lib2\MYCONST . "\n";  
echo Lib2\MyFunction() . "\n";  
echo Lib2\MyClass::WhoAmI() . "\n";  
?>
可以定义任意数量的use语句,或使用逗号分隔成独立的命名空间,在这个例子中我们导入了App\Lib2命名空间,但我们仍然不能直接引用MYCONST,MyFunction和MyClass,因为我们的代码还在全局空间中,但如果我们添加了“Lib2\”前缀,它们就变成限定名称了,PHP将会搜索导入的命名空间,直到找到匹配项。

执行结果:
App\Lib2\MYCONST  
App\Lib2\MyFunction  
App\Lib2\MyClass::WhoAmI

命名空间别名

命名空间别名可能是最有用的构想了,别名允许我们使用较短的名称引用很长的命名空间。
myapp3.php
< ?php  
use App\Lib1 as L;  
use App\Lib2\MyClass as Obj;  
 
header('Content-type: text/plain');  
require_once('lib1.php');  
require_once('lib2.php');  
 
echo L\MYCONST . "\n";  
echo L\MyFunction() . "\n";  
echo L\MyClass::WhoAmI() . "\n";  
echo Obj::WhoAmI() . "\n";  
?>
    第一个use语句将App\Lib1定义为“L”,任何使用“L”的限定名称在编译时都会被翻译成“App\Lib1”,因此我们就可以引用L\MYCONST和L\MyFunction而不是完全限定名称了。

    第二个use语句定义了“obj”作为App\Lib2\命名空间中MyClass类的别名,这种方式只适合于类,不能用于常量和函数,现在我们就可以使用new Obj( )或象上面那样运行静态方法了。

    行结果:
App\Lib1\MYCONST  
App\Lib1\MyFunction  
App\Lib1\MyClass::WhoAmI  
App\Lib2\MyClass::WhoAmI

PHP命名解析规则


PHP标识符名称使用下列命名空间规则进行解析,请参考PHP用户手册了解更详细的信息:

1.在编译时调用完全限定函数、类或常量;

2.非限定名称和限定名称根据导入规则进行翻译,例如,如果A\B\C导入为C,调用C\D\e( )就会被翻译成A\B\C\D\e( );

3.在PHP命名空间内,所有限定名称尚未根据导入规则转换,例如,如果在命名空间A\B中调用C\D\e( ),那么会被翻译成A\B\C\D\e( );

4.非限定类名称根据当前的导入规则进行转换,使用全名替换导入的短名称,例如,如果类C在命名空间A\B中被导入为X,那么new X( )就会被翻译为new A\B\C( );

5.在命名空间中非限定函数调用在运行时解析,例如,如果MyFunction( )在命名空间A\B中被调用,PHP首先会查找函数\A\B\MyFunction( ),如果没有找到,然后会在全局空间中查找\MyFunction( );

6.调用非限定或限定类名在运行时被解析,例如,如果我们在命名空间A\B中调用new C( ),PHP将会查找类A\B\C,如果没有找到,PHP会尝试自动载入A\B\C。

PHP命名空间高级特性

    接下来让我们看一看PHP命名空间的一些高级特性。

__NAMESPACE__常量

    __NAMESPACE__是一个PHP字符串,它总是返回当前命名空间的名称,在全局空间中它是一个空字符串。
< ?php  
namespace App\Lib1;  
echo __NAMESPACE__; // outputs: App\Lib1  
?>

    这个值在调试时非常有用,它也可由于动态生成一个完全限定类名,如:

< ?php  
namespace App\Lib1;  
 
class MyClass {  
 public function WhoAmI() {  
return __METHOD__;  
 }  
}  
 
$c = __NAMESPACE__ . '\\MyClass';  
$m = new $c;  
echo $m->WhoAmI(); // outputs: App\Lib1\MyClass::WhoAmI  
?>
namespace关键字
    namespace关键字可以用于明确引用一个当前命名空间或子命名空间中的项目,它等价于类中的self命名空间:
< ?php  
namespace App\Lib1;  
 
class MyClass {  
 public function WhoAmI() {  
return __METHOD__;  
 }  
}  
 
$m = new namespace\MyClass;  
echo $m->WhoAmI(); // outputs: App\Lib1\MyClass::WhoAmI  
?>
自动载入命名空间类

    PHP 5中最省时省力的特性是自动载入,在全局(非命名空间)PHP代码中,可以写一个标准自动载入函数:
< ?php  
$obj= new MyClass1(); // classes/MyClass1.php is auto-loaded  
$obj= new MyClass2(); // classes/MyClass2.php is auto-loaded  
 
// autoload function  
function __autoload($class_name) {  
 require_once("classes/$class_name.php");  
}  
?>
    在PHP 5.3中,你可以创建一个命名空间类的实例,在这种情况下,完全限定命名空间和类名传递给__autoload函数,例如,$class_name的值可能是App\Lib1\MyClass。你可以在相同的文件夹下放置所有的PHP类文件,从字符串中提取命名空间,但那样会导致文件名冲突。

    另外,你的类文件层次结构会按照命名空间的结构重新组织,例如,MyClass.php文件可以创建在/classes/App/Lib1文件夹下:
/classes/App/Lib1/MyClass.php

< ?php  
namespace App\Lib1;  
 
class MyClass {  
 public function WhoAmI() {  
return __METHOD__;  
 }  
}  
?>
在根文件夹下的文件就使用下面的代码了:
myapp.php

< ?php  
use App\Lib1\MyClass as MC;  
 
$obj = new MC();  
echo $obj->WhoAmI();  
 
// autoload function  
function __autoload($class) {  
 // convert namespace to full file path  
 $class = 'classes/' . str_replace('\\', '/', $class) . '.php';  
 require_once($class);  
}  
?>
解释:

1.类App\Lib1\MyClass的别名是MC;

2. new MC( )在编译时被翻译成new App\Lib1\MyClass( );

3.字符串App\Lib1\MyClass被传递给__autoload函数,使用文件路径正斜线替换所有命名空间中的反斜线,然后修改字符串,classes\App\Lib1\MyClass.php文件被自动载入;

总结

有关PHP命名空间的使用就介绍到这里,希望您能够对PHP的命名空间有一个新的认识,并希望你能在新项目中真正使用命名空间。

本文转载自:http://developer.51cto.com/art/200908/146519_all.htm

共有 人打赏支持
be-quiet
粉丝 13
博文 9
码字总数 5133
作品 0
福州
Modern PHP 笔记(一)

现在正式加入世界上最好的语言大家庭了。jimbochen大佬给推荐了 Josh Lockhart 写的,安道翻译的《Modern PHP》. 准备记录下一些学习笔记。刚刚入坑,如果理解的不对,欢迎指出。 这本书刚看...

郝开心信札
2017/11/22
0
0
PHP命名空间(Namespace)初探

探完闭包[查看],再探命名空间。 对于命名空间,官方文档已经说得很详细[查看],我在这里做了一下实践和总结。 命名空间一个最明确的目的就是解决重名问题,PHP中不允许两个函数或者类出现相...

豆浆Melon
2013/05/04
0
34
深入理解自动加载(一)

自动加载是一个非常核心的功能。在没有自动加载的时候,引用某个文件,常常需要一个很长的列表(需要把用到的)。 先用一个简单的样例:autoload() 可以做到当在实例化某个没有的类的时候,会...

熊猫88
2015/12/11
73
0
PHP之新手自学基础知识(六)——拓展篇之命名空间

命名空间概述 什么是命名空间?从广义上来说,命名空间是一种封装事物的方法。在很多地方都可以见到这种抽象概念。例如,在操作系统中目录用来将相关文件分组,对于目录中的文件来说,它就扮...

天谴残魂
01/09
0
0
PHP命名空间(Namespace)的使用详解

对于命名空间,官方文档已经说得很详细[查看],我在这里做了一下实践和总结。 命名空间一个最明确的目的就是解决重名问题,PHP中不允许两个函数或者类出现相同的名字,否则会产生一个致命的错...

Surjur
2015/02/12
0
0

没有更多内容

加载失败,请刷新页面

加载更多

Coding and Paper Letter(三十九)

资源整理。 1 Coding: 1.Python库benchmark rio s3,用于在访问S3上的文件时对Rasterio / GDAL的多线程性能进行基准测试的工具。 benchmark rio s3 2.Pangeo-Binder Cookiecutter模板。 cook...

胖胖雕
30分钟前
0
0
Promise 对象

Promise(承诺) 的含义 Promise 是异步编程的一种解决方案,比传统的解决方案——回调函数和事件——更合理和更强大。它由社区最早提出和实现,ES6 将其写进了语言标准,统一了用法,原生提供...

简心
33分钟前
0
0
让UI设计师崩溃的瞬间,你经历过哪些?

隔行如隔山,这句话人人耳熟能详,但其实隔行并不可怕,大家各谋其事,各尽其职,倒也互不打扰,真正可怕的是,是内行还要受外行指点江山,而最难的部分,便是那沟通。流畅的沟通,和声细语,...

mo311
34分钟前
1
0
python进制转换

#进制转换print(bin(10)) #十进制转换成二进制print(oct(10)) #十进制转换成八进制print(hex(10)) #十进制转换成十六进制print(int('1010',2)) #二进制转十进制print(int(...

fadsaa
45分钟前
3
0
syntax error near unexpected token

最近不断重复在虚拟机CentOS测试安装gitlab,因为gitlab有一个脚本需要饭强才能下载,于是我先在windows下载好再上传到虚拟机,可是执行脚本的时候提示“syntax error near unexpected toke...

W_Lu
55分钟前
2
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部