企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
PSR是 PHP Standard Recommendation的缩写,即PHP推荐标准。 ### **PSR-0(自动加载规范)已作废** 1.一个完全合格的命名空间和类名必须遵循以下结构 "\VendorName\Namespace\ClassName" 2.每个命名空间必须有顶级的命名空间 "VendorName" 3.每个命名空间可以有任意多个子命名空间 4.每个命名空间在被文件系统加载时必须被转换为操作系统路径分隔符 (DIRECTORY_SEPARATOR) 5.每个"_"字符在"类名"中被转换为DIRECTORY_SEPARATOR。而在 PSR-4 中使用下划线没有任何特殊含义 6.符合命名标准的命名空间和类名必须以".php"结尾来加载文件 7.命名空间和类名可以由大小写字母组成,但必须对大小写敏感以保证多系统兼容性 ### **PSR-1(基本代码规范)** 1.PHP代码源文件必须以 <?php 或 <?= 标签开始 2.PHP代码源文件必须使用不带 BOM 的 UTF-8 编码 3.类的命名必须遵循 StudlyCaps 大写开头的驼峰式命名规范 4.类中的常量所有字母都必须大写,单词间用下划线分隔 5.方法名必须符合 camelCase 式的小写开头驼峰式命名规范 ### **PSR-2(代码风格规范)** 1.代码必须遵循 PSR-1 中的编码规范 2.代码必须使用4个空格来进行缩进,而非制表符(TAB) 3.建议每行代码字符数保持在80个以内,理论上不可多于120个,但不做硬性限制 4.每个 namespace 命名空间语句和 use 声明语句块后面必须插入一个空白行 5.类的左花括号 "{" 必须写在声明后自成一行,右花括号 "}" 也必须在类主体下自成一行 6.方法的左花括号 "{" 必须放在声明后自成一行,右花括号 "}" 也必须于主体下自成一行 7.类的属性和方法必须添加访问修饰符(private、protected、public),abstract 以及 final 必须声明在访问修饰符之前,而 static 必须声明在访问修饰符之后(例:final public static) 8.在控制结构关键字的后面必须有一个空格,而调用方法或函数时一定不能有(控制结构:if-else、switch-case、try-catch、while、foreach ...) 9.控制结构的左花括号 "{" 必须跟其处于同一行,右花括号 "}" 必须在控制结构主体之后自成一行 10.控制结构的开始左括号之后,和结束右括号之前都不可以有空格 ### **PSR-3(日志接口规范)** PSR-3(Logger Interface)日志接口规范,主要目的是为了让日志类库通过接收一个 LoggerInterface 对象来记录日志信息。 1.LoggerInterface 接口对外定义了八个方法,分别用来记录 RFC 5424 中定义的八个等级的日志:debug、info、notice、warning、error、critical、alert、emergency 2.第九个方法 log(),第一个参数为记录等级。可使用一个预先定义的等级常量作为参数来调用此方法,必须与直接调用以上八个方法具有相同的效果。如果传入的等级常量没有预先定义,则必须抛出 psr\Log\InvalidArgumentException 类型的异常。不推荐使用自定义的日志等级,除非你非常确定当前类库对其有所支持。 ### **PSR-4(自动加载新规)** PSR-4(Improved Autoloading)本规范是关于自动载入对应类的相关规范,是 PSR-0 自动加载规范的补充。 1.此处的“类”是一个泛称,它包含类、接口、traits 以及其他类似的结构 2.完全限定类名需要遵循以下结构:\<命名空间>(\<子命名空间>)*\<类名> * 完全限定类名必须要有一个顶级命名空间,被称为 "vendor namespace"; * 完全限定类名可以有一个或多个子命名空间; * 完全限定类名必须有一个终止类名; * 完全限定类名中任意一部分中的下划线都没有特殊含义; * 完全限定类名可以由任意大小写字母组成; * 完全限定类名必须以大小写敏感的方式引用; 3.当根据完整的类名载入相应的文件时: * 完全限定类名中,连续的一个或几个子命名空间构成的命名空间前缀(不包括顶级命名空间的分隔符),至少对应着至少一个基础目录; * 紧接命名空间前缀后的子命名空间必须与相应的”文件基目录“相匹配,其中的命名空间分隔符将作为目录分隔符; * 终止类名对应一个以 .php 结尾的文件,文件名必须和终止类名大小写匹配; 4.自动加载器(autoloader)的实现不能抛出异常,不可引发任一级别错误,也不应该有返回值