PSR 类自动加载规范的翻译与看法

标签：

先列举一些资源：

• PSR-0官网原文
• PSR的Github源
• PSR中文翻译的Github源

有几点事先说明：

• 翻译部分，我只挑选PSR-0和PSR-4中的主要规范内容进行翻译。
• 我的翻译，侧重以理解的角度，而不是严格的文法翻译。

关键修饰词的说明：

**MUST**        __务必__
**MUST_NOT**    __绝不__
**REQUIRED**    __务必__
**SHALL**       __务必__
**SHALL_NOT**   __绝不__
**SHOULD**      __应该__
**SHOULD_NOT**  __不应该__
**RECOMMENDED** __建议__
**MAY**         __可以__
**OPTIONAL**    __可选__

为啥这样子，看看rfc2119的定义吧！

PSR-0 类自动加载规范（Autoloading Standard）

已弃用，从2014年10月21日起，PSR-0规范已弃用，并推荐以PSR-4规范作为替代。

规范正文

1. 命名空间（Namespace）和类（Class）务必拥有如右侧所示的标准结构\<Vendor Name>\(<Namespace>\)*<Class Name>。
2. （所有）命名空间（Namespace）务必拥有一个顶级的命名空间，如：Vendor Name。
3. （所有）命名空间（Namespace）可选根据实际需要，定义多个子命名空间（注意不是必选项）。
4. 在加载时，（所有）命名空间（Namespace）的分隔符 \ 会转换为目录分隔符 DIRECTORY_SEPARATOR。
5. 类名（Class Name）中的 _ 会转换为目录分隔符 DIRECTORY_SEPARATOR，但在命名空间（Namespace） _ 不具备任何含义（纯粹修饰性）。
6. 在加载时，命名空间（Namespace）和类（Class）时，源文件应该以.php为后缀（这条规则其实定义的很笼统）。
7. 命名时，命名空间（Vendor Name，Namespace）、类名（Class Name）应该由半角英文字母、大小写组合而成。

演示

return [
    ‘\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‘,
];

下划线在命名空间和类名的使用

return [
    ‘\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‘
];

PSR-4 类加载器（Autoloader）

1. 本文中的类（Class），可指代包括： 类 （Class，这里可以理解为代码上对类定义的结构体）、 接口 （Interface）、 特征 （Trait），等与之相似的结构体。
2. 类全称（the fully qualified class name），如右侧所示 \<顶级命名空间>(\<子级命名空间>)*\<类名>
   1. 类全称务必拥有一个顶级命名空间，常见的如 “Vendor namespace”。
   2. 类全称可以有一个或者多个子命名空间名。
   3. 类全称务必以一个类名（ClassName）终结。
   4. 下划线 _ 不再具有任何指义（区别于 PSR-0#5）。
   5. 类全称中的英文字母，可以由大小写任意组合而成。
   6. 所有类名在引用时，务必遵守其命名的大小写风格。
3. 加载（类源文件）时的一致性规则：
   1. 前缀映射规则：将类全称中的命名空间前缀，去掉最左边的分隔符 \，映射到一个基础目录上去（注意这里所说的命名空间前缀，可以指单个命名空间前缀，也可以是多个命名空间前缀，比如Acme\Log指向一个目录，再把Acme\Log\Writer指向另外一个目录）。
   2. 前缀映射剩余的子命名空间，务必与他所映射的基础目录下的目录结构一一对应（这里只说目录结构，不说文件命名）。
   3. 类源文件需以 .php 为结尾，且务必与类命名大小写吻合。
4. 类加载器（Autoloader），绝不抛出任何异常、任意级别的错误、返回任意的结果。

看法

PSR-0其实是一个完全没有约束力的规范，因为从第三点开始，已经完全给不出有力的修饰词。

PSR-4就务实多了，从Standard转为er。不过这个前缀映射法，从AgiMVC 3我就开始在玩了，但说实在的，这个东西就是个鸡肋。为啥这么说呢？

PSR-4中的前缀映射，是无限映射，假定我有个类全称是 \My\Sub1\Sub2\Sub3\ClassA，我将 My\Sub1\Sub2 指向了目录1，将 My\Sub1 指向了目录2，那么在引用这个类的时，loadClass应该如何设计呢？最直接的做法就是，从 My\Sub1\Sub2\Sub3 开始匹配，那么到 My\Sub1\Sub2 时候，我就命中了目录1。天哪，假如我的定义的命名空间很多的话，这个匹配，需要走多少次循环呢？所以就算是Composer也不得不提供一个优化的参数，把一个类库的所有定义的类都做一个枚举。

项目刚开始的时候，我们可能真的需要无限量的空间，但是进入到具体的开发环节，所有的一切都是具体得不能再具体的了。

或者说，这就是PHP语言本身的失败的地方所在，他坚定不移的走在微软无限抄的道路上，但却不给出任何具体的语言规范，乃至更先进一点的加载机制，而把所有的一切都让给了他身后的诸多山寨框架联盟——PSR联盟。

Composer和PSR把所有傻帽坑爹耗性能的事情都一股脑的扣在了PHP这个性能最差的开发语言上……

前些日子用node.js做了一些东西，真心觉得node.js的包机制明确而具体。PHP就不能学学node.js吗，哎，被后来的小弟超越了，PHP啊，你也该甩甩你的老包袱了吧？

PSR 类自动加载规范的翻译与看法

标签：

原文地址：http://my.oschina.net/janpoem/blog/386988