PHP PSR-4 Autoloader自动加载

在PSR-4之前,PHP组件和框架会使用魔术方法_autoload()或spl_autoload_register()方法实现各自持有的自动加载器,因此我们要学习使用每个组件和框架各自特有的自动加载器,而现如今,大家遵循PSR-4,就意味着我们只需使用一个自动加载器就能混合搭配多个PHP组件。

PHP框架之间通过自动加载机制合作。自动加载是指PHP解释器在运行时按需自动找到并加载PHP类的过程。这是个了不起的功能,把现代PHP生态系统中很多可互操作的组件联系起来了。

1. 概述

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

2. 详细说明

此处的“类”泛指所有的class类、接口、traits可复用代码块以及其它类似结构。

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

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

1).完整的类名必须要有一个顶级命名空间,被称为 "vendor namespace";

2).完整的类名可以有一个或多个子命名空间;

3).完整的类名必须有一个最终的类名;

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

5).完整的类名可以由任意大小写字母组成;

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

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

1).完整的类名中,去掉最前面的命名空间分隔符,前面连续的一个或多个命名空间和子命名空间,作为“命名空间前缀”,其必须与至少一个“文件基目录”相对应;

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

3).末尾的类名必须与对应的以.php 为后缀的文件同名。

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

3. 例子

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

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

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

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

计算机