前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >PSR-4 自动加载规范

PSR-4 自动加载规范

作者头像
mousemin
发布2023-06-10 17:40:38
3110
发布2023-06-10 17:40:38
举报
文章被收录于专栏:mouseminmousemin

PSR-4 自动加载规范

PSR-4 描述了从文件路径中 自动加载 类的规范。 它拥有非常好的兼容性,并且可以在任何自动加载规范中使用,包括 PSR-0。 PSR-4 规范也描述了放置 autoload 文件(就是我们经常引入的 vendor/autoload.php)的位置。

本文中的 必须不得需要不应应该不应该推荐可以可选 等能愿动词按照 RFC 2119 中的描述进行解释。

规范

术语class指的是类(classes)、接口(interfaces)、特征(traits)和其他类似的结构。

全限定类名具有以下形式:

代码语言:javascript
复制
1\<NamespaceName>(\<SubNamespaceNames>)*\<ClassName>
  1. 全限定类名必须拥有一个顶级命名空间名称,也称为供应商命名空间(vendor namespace)。
  2. 全限定类名可以有一个或者多个子命名空间名称。
  3. 全限定类名必须有一个最终的类名(我想意思应该是你不能这样 \<NamespaceName>(\<SubNamespaceNames>)*\ 来表示一个完整的类)。
  4. 下划线在全限定类名中没有任何特殊含义(在 PSR-0 中下划是有含义的)。
  5. 全限定类名可以是任意大小写字母的组合。
  6. 所有类名的引用必须区分大小写。

全限定类名的加载过程

  1. 在全限定的类名(一个 命名空间前缀)中,一个或多个前导命名空间和子命名空间组成的连续命名空间,不包括前导命名空间的分隔符,至少对应一个根目录
  2. 命名空间前缀后面的相邻子命名空间与根目录下的目录名称相对应(且必须区分大小写),其中命名空间的分隔符表示目录分隔符。
  3. 最终的类名与以.php 结尾的文件名保持一致,这个文件的名字必须和最终的类名相匹配(意思就是如果类名是 FooController,那么这个类所在的文件名必须是 FooController.php)。

自动加载文件禁止抛出异常,禁止出现任何级别的错误,也不建议有返回值。

范例

下表显示了与给定的全限定类名、命名空间前缀和根目录相对应的文件的路径。

完全限定的类名

命名空间前缀

基本目录

结果文件路径

\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

想要了解一个符合规范的自动加载器的实现可以查看示例文件。示例中的自动加载器禁止被视为规范的一部分,它随时都可能发生改变。

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2021年07月28日,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • PSR-4 自动加载规范
    • 规范
      • 范例
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档