PSR-4:自动加载器

Autoloader

本文件中的关键词“必须”,“不得”,“必须”,“应该”,“不应该”,“应该”,“不应该”,“推荐”,“可以”和“可选”按照RFC 2119中的描述进行解释

1.概述

此PSR描述了从文件路径自动加载的规范它完全可互操作,除了包括PSR-0在内的任何其他自动加载规范外,还可以使用它此PSR还描述了根据规范放置将自动加载的文件的位置。

2.规格

  1. 术语“类”指的是类,接口,特征和其他类似结构。

  2. 完全限定的类名具有以下形式:

     \<NamespaceName>(\<SubNamespaceNames>)*\<ClassName>
    
    1. 完全限定的类名必须具有顶级命名空间名称,也称为“供应商命名空间”。

    2. 完全限定的类名可以具有一个或多个子命名空间名称。

    3. 完全限定的类名必须具有终止类名。

    4. 下划线在完全限定类名的任何部分都没有特殊含义。

    5. 完全限定类名中的字母字符可以是小写和大写的任意组合。

    6. 必须以区分大小写的方式引用所有类名。

  3. 加载对应于完全限定类名的文件时...

    1. 完全限定类名称(“名称空间前缀”)中的一个或多个前导命名空间和子命名空间名称的连续系列(不包括前导命名空间分隔符)对应于至少一个“基本目录”。

    2. “名称空间前缀”之后的连续子命名空间名称对应于“基本目录”中的子目录,其中名称空间分隔符表示目录分隔符。子目录名称必须与子命名空间名称的大小写相匹配。

    3. 终止类名对应于以.php结尾的文件名文件名必须与终止类名称的大小写相匹配。

  4. 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.php
\Zend\Acl Zend /usr/includes/Zend/ /usr/includes/Zend/Acl.php

有关符合规范的自动加载器的实现,请参阅示例文件示例实现绝不能被视为规范的一部分,并且可以随时更改。