转载地址:http://www.cnblogs.com/fengliang/p/3586494.html
PSR是Proposing a Standards Recommendation(提出标准建议)的缩写,是由PHP Framework Interoperability Group(PHP通用性框架小组,简称PHP-FIG)发起的,通过他们命名就可以看出,这是个主要是针对框架通用性而做努力的开放性小组,他们的在Github上有自己的仓库地址,目前只有一个被接受的标准,那就是PSR-0标准,标准定义了PHP自动加载的命名规范和文件路径规范。 针对PSR-0标准主要提到了以下几点:
要求
- 一个完全合格的命名空间和类名必须有以下的结构“\<提供者名称>\(<命名空间>\)*<类名>”
- 每个命名空间必须有顶级的命名空间(“提供者”)
- 每个命名空间可以有任意多个子命名空间
- 每个命名空间在被从文件系统加载时必须被转换为“操作系统路径分隔符”(DIRECTORY_SEPARATOR )
- 每个“_”字符在“类名”中被转换为DIRECTORY_SEPARATOR 。“_”符号在命名空间中没有这个含义
- 符合命名标准的命名空间和类名必须以“.php”结尾来加载文件
- 提供商名称,命名空间,类名可以由大小写字母组成,其中命名空间和类名是大小写敏感的以保证多系统兼容性
- 如果文件不存在需要返回false
例子
1
2
3
4
|
\Doctrine\Common\IsolatedClassLoader => /path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php
\Symfony\Core\Request => /path/to/project/lib/vendor/Symfony/Core/Request.php
\Zend\Acl => /path/to/project/lib/vendor/Zend/Acl.php
\Zend\Mail\Message => /path/to/project/lib/vendor/Zend/Mail/Message.php
|
下划线在命名空间和类名中的使用
1
2
|
\
namespace
\package\Class_Name => /path/to/project/lib/vendor/
namespace
/package/Class/Name.php
\
namespace
\package_name\Class_Name => /path/to/project/lib/vendor/
namespace
/package_name/Class/Name.php
|
设置这个标准是为了保证最基本的共同点。你可以通过实现5.3的SplClassLoader来测试这个标准。
扩展例子
提供一个函数来展示如何使用上述标准。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<?php
function
autoload(
$className
)
{
$className
= ltrim(
$className
,
'\\'
);
$fileName
=
''
;
$namespace
=
''
;
if
(
$lastNsPos
=
strripos
(
$className
,
'\\'
)) {
$namespace
=
substr
(
$className
, 0,
$lastNsPos
);
$className
=
substr
(
$className
,
$lastNsPos
+ 1);
$fileName
=
str_replace
(
'\\'
, DIRECTORY_SEPARATOR,
$namespace
) . DIRECTORY_SEPARATOR;
}
$fileName
.=
str_replace
(
'_'
, DIRECTORY_SEPARATOR,
$className
) .
'.php'
;
require
$fileName
;
}
|
SplClassloader的实现
接下来这个gist实现了SplClassLoader可以加载你按照上面标准来实现的通用类库,这是5.3里面推荐的加载方式。
扩展实现
因为这个标准提到了如果文件不存在的时候应该范围false,但是在上面函数的例子中并没有实现该机制,所有有人实现了优化的SplClassLoader。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
<?php
class
ClassLoader
{
/**
* @var array Contains namespace/class prefix as key and sub path as value
*/
protected
$paths
;
/**
* Construct a loader instance
*
* @param array $paths Containing class/namespace prefix as key and sub path as value
*/
public
function
__construct(
array
$paths
)
{
$this
->paths =
$paths
;
}
/**
* Load classes/interfaces following PSR-0 naming
*
* @param string $className
* @return null|boolean Null if no match is found, bool if match and found/not found.
*/
public
function
load(
$className
)
{
if
(
$className
[0] ===
'\\'
)
$className
=
substr
(
$className
, 1 );
foreach
(
$this
->paths
as
$prefix
=>
$subPath
)
{
if
(
strpos
(
$className
,
$prefix
) !== 0 )
continue
;
$lastNsPos
=
strripos
(
$className
,
'\\'
);
$prefixLen
=
strlen
(
$prefix
) + 1;
$fileName
=
$subPath
. DIRECTORY_SEPARATOR;
if
(
$lastNsPos
>
$prefixLen
)
{
// Replacing '\' to '/' in namespace part
$fileName
.=
str_replace
(
'\\'
,
DIRECTORY_SEPARATOR,
substr
(
$className
,
$prefixLen
,
$lastNsPos
-
$prefixLen
)
) . DIRECTORY_SEPARATOR;
}
// Replacing '_' to '/' in className part and append '.php'
$fileName
.=
str_replace
(
'_'
, DIRECTORY_SEPARATOR,
substr
(
$className
,
$lastNsPos
+ 1 ) ) .
'.php'
;
if
( (
$fileName
= stream_resolve_include_path(
$fileName
) ) === false )
return
false;
require
$fileName
;
return
true;
}
}
}
|