Can
Be Better

PHP PSR-4 Autoloader 自动加载(中文版)

Autoloader

关键词 “必须”(“MUST”)、“一定不可/一定不能”(“MUST NOT”)、“需要”(“REQUIRED”)、
“将会”(“SHALL”)、“不会”(“SHALL NOT”)、“应该”(“SHOULD”)、“不该”(“SHOULD NOT”)、
“推荐”(“RECOMMENDED”)、“可以”(“MAY”)和”可选“(“OPTIONAL”)的详细描述可参见 [RFC 2119][] 。

1. 概述

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

2. 详细说明

  1. 此处的“类”泛指所有的class类、接口、traits可复用代码块以及其它类似结构。
  2. 一个完整的类名需具有以下结构:
    \<命名空间>(\<子命名空间>)*\<类名>
    1. 完整的类名必须要有一个顶级命名空间,被称为 “vendor namespace”;
    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

关于本规范的实现,可参阅 相关实例
注意:实例并属于规范的一部分,且随时有所变动。


原文:PizzaLiu github

 

<?php

/*
 * This file is part of Composer.
 * 当前文件是 依赖管理器的一部分
 * (c) Nils Adermann <[email protected]>
 *     Jordi Boggiano <[email protected]>
 * 版权声明吗?
 * For the full copyright and license information, please view the LICENSE
 * 如果想要查看版权跟许可信息,请查看许可文件
 * file that was distributed with this source code.
 * 文件用源码的方式进行分布
 */

namespace Composer\Autoload; // 这个命名空间,貌似感觉不符合你的标准呢。
// 命名空间 跟路径 不是很吻合啊

/**
 * ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
 * 类加载者执行了 PSR-0 PSR-4 和 classmap 的类加载
 *     $loader = new \Composer\Autoload\ClassLoader();
 *     // 对外面就是这样用的
 *     // register classes with namespaces 通过命名空间注册类
 *     $loader->add('Symfony\Component', __DIR__.'/component');
 *     $loader->add('Symfony',           __DIR__.'/framework');
 *
 *     // activate the autoloader 启动自动加载
 *     $loader->register();
 *
 *     // to enable searching the include path (eg. for PEAR packages)//启动 搜索路径
 *     $loader->setUseIncludePath(true); 设置包含路径
 *
 * In this example, if you try to use a class in the Symfony\Component
 * 在这个例子中,如果你试图使用一个位于 Symfony\commponent 下面的类
 * namespace or one of its children (Symfony\Component\Console for instance),
 * 命名空间或者 这个下面的一个子选项(Symfony\Component\Console 进行实例化)
 * the autoloader will first look for the class under the component/
 * 这个自动加载类会首先寻找在Component目录下进行寻找
 * directory, and it will then fallback to the framework/ directory if not
 * 并且返回返回给 framework/ 目录下,在这个最终查找之后。
 * found before giving up.
 * 坚持到放弃的查找。
 * This class is loosely based on the Symfony UniversalClassLoader.
 * 这些类松散的耦合到 联合加载类
 * @author Fabien Potencier <[email protected]>
 * @author Jordi Boggiano <[email protected]>
 * @see    http://www.php-fig.org/psr/psr-0/
 * @see    http://www.php-fig.org/psr/psr-4/
 */

 

不开启评论,如有问题疑问请发邮件。[email protected]最长的路 » PHP PSR-4 Autoloader 自动加载(中文版)

评论 抢沙发

评论前必须登录!