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

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

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

    1. 此处的「类」泛指所有的「Class类」、「接口」、「traits 可复用代码块」以及其它类似结构。

    2. 一个完整的类名需具有以下结构:

      1. 完整的类名 必须 要有一个顶级命名空间，被称为 “vendor namespace”；

      3. 完整的类名中任意一部分中的下滑线都是没有特殊含义的；

      4. 完整的类名 可以 由任意大小写字母组成；

      5. 所有类名都 必须 是大小写敏感的。

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

      2. 紧接命名空间前缀后的子命名空间 必须 与相应的「文件基目录」相匹配，其中的命名空间分隔符将作为目录分隔符。

      3. 自动加载器（autoloader）的实现 一定不可 抛出异常、一定不可 触发任一级别的错误信息以及 不应该 有返回值。

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

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