「PSR 规范」PSR-4 自动加载规范

1.概述

---

本文 PSR 是关于由文件路径 自动载入 对应类的相关规范，本规范是可互操作的，可以作为任意自动载入规范的补充，其中包括 PSR-0 ，本 PSR 还包括自动载入的类对应的文件存放路径规范。

关于「能愿动词」的使用

---

为了避免歧义，文档使用了大量的 「能愿动词」，对应的解释如下：

• 必须（MUST）：绝对，严格遵循，请照做，无条件遵守；
• 一定不可（MUST NOT）：禁令，严令禁止；
• 应该（SHOULD）：强烈建议这样做，但不强求；
• 不该（SHOULD NOT）：强烈建议不要这样做，但不强求；
• 可以（MAY） 和 可选（OPTIONAL）：选择性较高，在这个文档内，此词语使用较少；

2.详细说明

---

1. 此处的 「类」泛指所有的「class 类」、「接口」、「trait 可复用代码块」以及其他类似结构。
2. 一个完整的类名需具有以下结构：

\ <命名空间>(\ <子命名空间>)*\ <类名>

• i. 完整的类名 必须 要有一个顶级的命名空间，被称之为 "vendor namespace"；
• ii. 完整的类名 可以 有一个或多个子命名空间；
• iii. 完整的类名 必须 有一个最终的类名；
• iv. 完整的类名中任意部分的下划线都是没有特殊含义的；
• v.完整的类名 可以 由任意的大小写字母组成；
• vi.所有类名都 必须 是大小写敏感的。

3.当根据完整的类名载入相应的文件

• i.完整的类名中，去掉最前面的命名空间分割符，前面连续的一个或多个命名空间和子命名空间，作为 「命名空间前缀」，其 必须 与至少一个 「文件基目录」相对应。
• ii.紧接命名空间前缀后的子命名空间 必须 与相应的 「文件基目录」相匹配，其中的命名空间分割符将作为目录分割符。
• iii. 末尾的类名 必须 与对应的以 .php 为后缀的文件同名。
• iv. 自动加载器（autoloader）的实现 一定不可 抛出异常、一定不可 触发任意级别的错误信息以及 不应该 有返回值。

3.例子

---

下表展示了符合规范完整类名、命名空间前缀和文件基目录所对应的文件路径。

完整类名	命名空间前缀	文件基目录	文件路径
\Acme\Log\Writer\File_Writer	Acme\Log\Writer	./acme-log-writer/lib/	./acme-log-writer/lib/File_Writer.php
\Aura\Web\Response\Status	Aura\Web	/path/to/aura-web/src/	/path/to/aura-web/src/Response/Status.php
\Symfony\Core\Request	Symfony\Core	./vendor/Symfony/Core/	./vendor/Symfony/Core/Request
\Zend\Acl	Zend	/usr/includes/Zend/	/usr/imcludes/Zend/Acl.php

关于本规范的实现，可参阅 相关实例。

注意：实例并 不 属于规范的一部分，而且随时 会 有所变动。