PHP中PSR-[0-4]规范

最新推荐文章于 2024-07-22 17:45:00 发布
最新推荐文章于 2024-07-22 17:45:00 发布
阅读量7k 收藏 11
点赞数 4
分类专栏： PHP
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/think2me/article/details/42844391
版权
本文详细介绍了PHP中的PSR-[0-4]编码规范，包括自动加载标准、基础编码标准、编码风格指南、日志接口和自动加载增强版。这些规范由PHP-FIG创建，旨在统一PHP的编码风格，提高代码可读性和互操作性。文章首先解释了PHP-FIG的背景，然后逐一解析了PSR-0到PSR-4的各个要点，如命名空间、自动加载、类命名和代码格式等。
摘要由CSDN通过智能技术生成


PHP中PSR-[0-4]规范

更好排版：https://www.zybuluo.com/phper/note/65033

PHP是世界上最伟大的语言，这一点是毋庸置疑的吧。哈哈哈哈哈哈 。这个霸气的开头不错！(^__^)

但是正是因为伟大，所以用的人也就多了，人一多，再牛逼再伟大的东西，都会产生问题，逐渐就造成了很多的分歧。每个人的习惯不一样，所以在一些PHP语法上的一些表现也是千差万别，比如这些问题：

function 函数名是否驼峰命名， 
花括号{}是否换行写， 
是该写注释呢还是不写 
变量名是大写还是小写， 
一个php文件中是一个类好还是允许有多个

等等一系列的问题，接踵而至，你说你的这种方式屌，我说你傻逼啊我的才好。所以。各种争执声此起彼伏。

特别是当你去接手上任留下的坑的时候，如果你有自己的规范或者你是处女座，你就会骂死那个狗日的一万遍了，每改一次就会改一遍骂：“麻痹的写的都是什么狗shit烂代码啊”。所以，在PHP程序员的心中一个共有的心愿诞生了：“能不能他妈的大家都遵守同一规范啊”。

好，既然大家都有共同的心声，那么这样一个的公共的规范就出来了，他就是PSR-[0-4]规范，它出来后，大家都觉得挺不错的啊，还蛮符合自己的书写风格的，渐渐的大家都知道了它，也慢慢的接受了它，越来越多的人知道了它，一些大牛的项目都慢慢的遵守了这个规范，然后也一帮菜鸟一看大牛都在用这个规范，我为啥不也尝试着规范一下呢？

所以，渐渐的PSR-[0-4]规范成为了PHP的一个王牌规范，你写PHP就最好必须按照这里面的规范写，全球共享好代码。

PHP-FIG

在说啥是PSR-[0-4]规范的之前，我觉得我们有必要说下它的发明者和规范者：PHP-FIG，它的网站是：www.php-fig.org。就是这个联盟组织发明和创造了PSR-[0-4]规范，膜拜吧，屌丝们！

FIG 是 Framework Interoperability Group（框架可互用性小组）的缩写，由几位开源框架的开发者成立于 2009 年，从那开始也选取了很多其他成员进来，虽然不是 “官方” 组织，但也代表了社区中不小的一块。组织的目的在于：以最低程度的限制，来统一各个项目的编码规范，避免各家自行发展的风格阻碍了程序设计师开发的困扰，于是大伙发明和总结了PSR，PSR是Proposing a Standards Recommendation（提出标准建议）的缩写，截止到目前为止，总共有5套PSR规范，分别是：

PSR-0 (Autoloading Standard) 自动加载标准 
PSR-1 (Basic Coding Standard) 基础编码标准 
PSR-2 (Coding Style Guide) 编码风格向导 
PSR-3 (Logger Interface) 日志接口 
PSR-4 (Improved Autoloading) 自动加载的增强版，可以替换掉PSR-0了。

接下来的篇目，我们会针对这5套，深入了解下。仔细学习下受万千PHPer热捧的这5套规范到底有啥出众之处。

PSR-0 规范

PRS-0规范是他们出的第1套规范，主要是制定了一些自动加载标准（Autoloading Standard），如果你英文比较好，可以直接看官网的这个：PSR-0，很短。但是如果，你英语烂成狗，那么就继续往下看我的瞎比比讲解吧！

我们打开PSR-0的主页时，发现多了一个警告：

Deprecated - As of 2014-10-21 PSR-0 has been marked as deprecated. PSR-4 is now recommended as an alternative.

英语狗不好的，来，听我翻译：

不推荐使用 - 在2014年10月21日PSR-0已被标记为过时。PSR-4现在推荐作为替代。

那么也就是说PSR-0已！经！过！时！了！，别哭，PHP代码狗。虽说已经过时，但是我们也可以看看嘛，这不影响我们的学习，好了。废话不说了，开始吧：

PSR-0强制性要求几点：

  1. 一个完全合格的namespace和class必须符合这样的结构：“\< Vendor Name>(< Namespace>)*< Class Name>”
  2. 每个namespace必须有一个顶层的namespace（"Vendor Name"提供者名字）
  3. 每个namespace可以有多个子namespace
  4. 当从文件系统中加载时，每个namespace的分隔符(/)要转换成 DIRECTORY_SEPARATOR(操作系统路径分隔符)
  5. 在类名中，每个下划线(_)符号要转换成DIRECTORY_SEPARATOR(操作系统路径分隔符)。在namespace中，下划线(_)符号是没有（特殊）意义的。
  6. 当从文件系统中载入时，合格的namespace和class一定是以 .php 结尾的
  7. verdor name,namespaces,class名可以由大小写字母组合而成（大小写敏感的）

是不是有点看不懂啊。什么namespace啊，什么autoloading啊。所以，如果你对命名空间还不是特别懂的话，可以google下namespace 和 自动加载相关的php知识。或者看下一篇，我专门来讲讲他们：namespace 和 autoloading

好，我们接着一条条举例来分析下：

第1条

比如我的文件 /Doctrine/Common/IsolatedClassLoader.php 这样子的一个类文件，那么你的namespace命名就必须声明称这样：

声明：namespace  \Doctrine\Common\
调用：\Doctrine\Common\IsolatedClassLoader

其中，Doctrine 表示一个模块目录 Vendor name, common就是namesapce, IsolatedClassLoader是class name。这样一看就知道这个文件的目录层次，一目了然。

再比如：/path/to/project/lib/vendor/Symfony/Core/Request.php 文件：

声明：namespace \Symfony\Core
调用：\Symfony\Core\Request

第2，3条

namespace \Zend\Acl => /path/to/project/lib/vendor/Zend/Acl.php
namespace \Zend\Mail\Message => /path/to/project/lib/vendor/Zend/Mail/Message.php

必须有一个顶级的zend的namespace, zend 下面可以有message子命名空间。

第4条

看这个例子，我们需要new 一个这样的类

new \Symfony\Core\Request

那么我再加载这个类文件时候，就要将分隔符\ 转换成 目录，也就是去 Vendor -> Symfony->Core->Request.php 一层层的目录找到这个文件。其实也就是和第1,2,3是反过来的对应关系。

第5条

第5条是说namespace命名中的这个 _符号 没有任何用处，就是用来表示目录分隔符的，但是注意在PRS-4中已经取消了这个_ ，那么我们还是看一下，这个过时的规定是怎么样的：

\namespace\package\Class_Name => /path/to/project/lib/vendor/namespace/package/Class/Name.php

\namespace\package_name\Class_Name => /path/to/project/lib/vendor/namespace/package_name/Class/Name.php

以上2个namespace中的_ 其实是目录分隔符。并不是class name就是那样的。现在PSR-4出来后，确实觉得这样的规定有点不好。怪怪的。

第6条

第6条不用多说。既然你用php，文件名当然是得用.php 后缀结尾。这个规定的原因，我大致猜一下，估计是有人用 .php3 后缀的。好吧。这个是个神话了。因为在apache的配置文件中是允许的：

<IfModule dir_module>
    DirectoryIndex index.php index.php3 index.html index.htm
</IfModule>

所以，老老实实的用.php作为后缀名吧。

第7条

文件大小写的问题，这个其实是很重要的。因为Linux系统下是区分文件名和目录名大小写的，而在Windows下是不区分的。所以就会经常出现问题，比如：

namespace  \Doctrine\Common\IsolatedClassLoader

在Linux下就去严格按照大小写去找目录和文件了。但是如果你在windows下开发，全是小写也不会报错，你一发布到Linux上就悲剧了，提示找不到文件。所以，大小写太重要了。

PSR-1 规范

还是那句话，如果你英文比较好，可以直接看官网的这个：PSR-1，也不长，基本能看懂。但是如果你英语烂成狗，那么还是请继续往下看我的瞎比比！

  1. PHP源文件必须只使用 <?php 和 <?= 这两种标签。
  2. 源文件中php代码的编码格式必须是不带字节顺序标记(BOM)的UTF-8。
  3. 一个源文件建议只用来做声明（类(class)，函数(function)，常量(constant)等）或者只用来做一些引起副作用的操作（例如：输出信息，修改.ini配置等）,但不建议同时做这两件事。
  4. 命名空间(namespace)和类(class) 必须遵守PSR-0标准。
  5. 类名(class name) 必须使用骆驼式(StudlyCaps)写法 (注：驼峰式(cameCase)的一种变种，后文将直接用StudlyCaps表示)。
  6. 类(class)中的常量必须只由大写字母和下划线(_)组成。
  7. 方法名(method name) 必须使用驼峰式(cameCase)写法。

好，就是上面的基本7大点，有些很简单，就不过多说明，第3点需要仔细说下。

第1条

最低0.47元/天 解锁文章
domorejojo
关注
专栏目录
PHP PSR-4与PSR-0规范
zHHHe的专栏
08-16 1万+
在上一篇文章中，介绍了PSR-0和autoload相关的内容。继PSR-0这个PHP自动加载的规范之后，PHP-FIG又推出了一个PSR-4，称为改进的autoload规范。 在此不详谈两者的定义了。在PSR-0中，\Symfony\Core\Request会被转换成文件系统的/path/to/project/lib/vendor/Symfony/Core/Request.php这个路径。PSR
PHP规范PSR0和PSR4的理解
热门推荐
zhibin的程序日记
07-29 3万+
一、PSR0简介 下文描述了若要使用一个通用的自动加载器(autoloader)，你所需要遵守的规范： 一个完全标准的命名空间(namespace)和类(class)的结构是这样的：\<Vendor Name>\(\)*每个命名空间(namespace)都必须有一个顶级的空间名(namespace)("组织名(Vendor Name)")。每个命名空间(namespace)
PSR-4——新鲜出炉的PHP规范
04-15 355
FIG 制定的PHP规范，简称PSR，是PHP开发的事实标准。 PSR原本有四个规范，分别是： PSR-0 自动加载PSR-1 基本代码规范PSR-2 代码样式PSR-3 日志接口 2013年底，新出了第5个规范—— PSR-4 。 PSR-4规范了如何指定文件路径从而自动加载类定义，同时规范了自动加载文件的位置。这个乍一看和PSR-0重复了，实际上，在功能上确实有所重复。区
PHP编程规范的推荐标准PSR
最新发布
gcnsc的专栏
07-22 69
PSR是指PHP Standard Recommendations，是由PHP-FIG（PHP Framework Interop Group）制定的一系列PHP编程规范的推荐标准。 具体来说，PSR-1是PHP基础编码规范，PSR-2是PHP代码风格指南，PSR-4是自动加载标准，PSR-7是HTTP消息接口。
php规范PSR-4
weixin_33843947的博客
06-06 130
1. 概况这个 PSR 描述的是通过文件路径自动载入类的指南；它作为对PSR-0的补充；根据这个 指导如何规范存放文件来自动载入；2. 说明（Specification）术语「类」是一个泛称；它包含类，接口，traits 以及其他类似的结构；完全限定类名应该类似如下范例：<NamespaceName>(<SubNamespaceNames>)*&l...
php psr-4 编码规范,PHP编码规范(PSR-4)-Autoloader 自动加载
weixin_33891841的博客
03-09 225
PSR-4 Autoloader1. 概述本 PSR 是关于由文件路径 自动载入 对应类的相关规范， 本规范是可互操作的，可以作为任一自动载入规范的补充，其中包括 PSR-0，此外， 本 PSR 还包括自动载入的类对应的文件存放路径规范。2. 详细说明1. 此处的“类”泛指所有的class类、接口、traits可复用代码块以及其它类似结构。2. 一个完整的类名需具有以下结构:\(\)*\完整的类名...
php中PSR-[0-4]代码规范学习记录
大智若愚的博客
06-27 230
php中PSR-[0-4]代码规范学习记录 1. PSR是什么？ PSR是一套代码编写规范，用于约束代码风格。以前没有规范的时候大家都是按照自己的习惯来书写代码，但每个人风格不一样，你的代码在别人看来就是很不爽。而且会导致许多问题： function 函数名是否驼峰命名， 花括号{}是否换行写， 是该写注释呢还是不写 变量名是大写还是小写， 一个php文件中是一个类好还是允许有多个 所以PSR-[0-4]规范就应运而生，大家都共同遵守，就没有风格差异了。 PSR是由PHP-FIG这个组织发明的，FIG 是
vscode-php-formatter:Visual Studio代码扩展。 Sensiolabs PHP CS Fixer的包装。 分析一些PHP源代码并尝试解决编码标准问题（与PSR-1和PSR-2兼容）-Form source code
03-25
使用Visual Studio Code作为扩展安装后，此扩展会根据PSR-0，PSR-1， 或Symfony样式约定自动格式化PHP代码。 特征 仅格式化当前选择或整个文件的格式。 使用自定义键绑定或操作触发格式。 支持保存时格式化。 ...
ComposerPSR4Example:使用Composer进行PSR-4自动加载的基本示例
04-29
当尝试学习如何在PHP中结合Composer的PSR-4自动加载规范使用命名空间时，我找不到一个可靠的工作示例。 我了解自动加载的原理，了解名称空间为什么很好-我只想要一个工作模板，以便可以开始编码。 好吧，我找不到一...
psr7:超轻量级PSR-7实施
04-28
PSR-7的实施 一种超轻量级的PSR-7实现。 非常严格而且非常快速。 描述 食尸鬼 薄片 苗条的 尼霍尔姆 代码行 3.300 3.100 1.900 1.000 PSR-7 * 66％ 100％ 75％ 100％ PSR-17 不 是的 是的 是的 HTTPlug ...
PHP编码规范之PSR-4
大愚Talk
05-09 1869
Autoloader关键词 “必须”(“MUST”)、“一定不可/一定不能”(“MUST NOT”)、“需要”(“REQUIRED”)、 “将会”(“SHALL”)、“不会”(“SHALL NOT”)、“应该”(“SHOULD”)、“不该”(“SHOULD NOT”)、 “推荐”(“RECOMMENDED”)、“可以”(“MAY”)和”可选“(“OPTIONAL”)的详细描述可参见 [RFC 211
一文读懂PHP最新加载规范PSR-4
藏经阁
04-11 5623
FIG制定的PHP规范，简称PSR，是PHP开发的事实标准。 PSR原本有四个规范，分别是： PSR-0 自动加载 PSR-1 基本代码规范 PSR-2 代码样式 PSR-3 日志接口 2013年底，新出了第5个规范——PSR-4。 PSR-4规范了如何指定文件路径从而自动加载类定义，同时规范了自动加载文件的位置。这个乍一看和PSR-0重复了，实际上，在功能上确实有所重复。区别在于...
关于php规范的PSR-4
云客的技术博客【云游天下 做客四方】
04-06 672
PSR-4规范了如何通过名字空间自动加载类，该规范由php-fig（PHP Framework Interop Group的缩写，php框架交互组）制定，网站http://www.php-fig.org/ 以下是规范的中文翻译： Autoloader 关键词 “必须”("MUST")、“一定不可/一定不能”("MUST NOT")、“需要”("REQUIRED")、 “将会”("S
php psr4规范
qq_34345149的博客
12-31 1302
参考文章： 1、类、方法、常量的定义和副操作（输出结果，处理数据）只能同时存在一种 2、命名空间和类必须遵循PSR-4自动加载器标准。（大驼峰，文件名和命名空间大小写一致） 3、类、成员方法大括号要单独一行 4、类名采用大驼峰，变量、方法名、函数名采用小驼峰，常量采用大写+下划线 5、控制语法小括号外侧1个空格，第一个大括号跟在小括号同行 6、php文件以<?php开头，代码最后空一行，?>不写 7、缩进采用4个空格 8、函数，方法的多个参数，逗号后要留1个空格 9、必要注释和空行 参考文章：
php psr-4,PHP类自动装载(PSR-4规范 简单版本)
weixin_31419153的博客
03-11 207
教学案例分享，PHP5.3以上带命名空间，如何做类的自动装载，采用PSR-4规范的简单版本。如果需要多条 autoload 函数，spl_autoload_register() 满足了此类需求。 它实际上创建了 autoload 函数的队列，按定义时的顺序逐个执行。相比之下， __autoload() 只可以定义一次。test.php// src目录中，使用PSR-4命名规范的类，使用时将被自动装...
PSR-4 自动加载规范
Yan 小铁匠
05-26 1308
1. 总览 PSR-4 描述了从文件路径中 自动加载 类的规范。 它拥有非常好的兼容性，并且可以在任何自动加载规范中使用，包括 PSR-0。 PSR-4 规范也描述了放置 autoload 文件（就是我们经常引入的 vendor/autoload.php）的位置。 2. 规范 术语「class」指的是类（classes）、接口（interfaces）、特征（traits）和其他类似的结构。 全限定...
【PHP系列】PHP推荐标准之PSR-4，自动加载器策略
W15034213725的博客
02-26 167
接上回的继续说，上回说到PSR-3日志记录器接口，这回我们来说说PSR的最后一个标准，PSR-4，自动加载器策略。 缘由 自动加载器策略是指，在运行时按需查找PHP类、接口或性状，并将其载入PHP解释器。 支持PSR-4自动加载器标准的PHP组件和框架，使用同一个自动加载器就能找到相关代码，然后将其载入PHP解释器。 怎么来理解呢，你可能看PHP代码的时候经常会看到下面的代码 ...
PHP编程：PSR-2编码规范详解
"PHP开发编码规范--PSR-2编码规范" PSR-2编码规范是PHP Framework Interoperability Group（PHP-FIG）为PHP开发者制定的一套代码风格指南，旨在提高代码可读性、一致性和项目的协作性。PSR-2是基于PSR-1的基础编码...
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值