标签：arc rfc space ida 抛出异常 argument cas comm 大小写
psr规范
引言： PSR 是 PHP Standard Recommendations 的简写，由 PHP FIG 组织制定的 PHP 规范，是 PHP 开发的实践标准。这些规范的目的是：通过框架作者或者框架的代表之间讨论，以最低程度的限制，制定一个协作标准，各个框架遵循统一的编码规范，避免各家自行发展的风格阻碍了 PHP 的发展，解决这个程序设计师由来已久的困扰。截止到笔者文章psr在用的共11套规范，下面介绍了其中四个和已经弃用的psr0规范。
PSR-0 (Autoloading Standard) 自动加载标准 (2014年10月21起被官方弃用 由psr4替代)
PSR-1 (Basic Coding Standard) 基础编码标准
PSR-2 (Coding Style Guide) 编码风格向导
PSR-3 (Logger Interface) 日志接口
PSR-4 (Improved Autoloading) 自动加载的在用版本。
#注：另有psr6（缓存接口规范）psr7（HTTP消息接口规范）psr11、psr13、psr15、psr16、psr17本文不做介绍
附上官网地址psr
自动加载标准
注：因为已经废弃，这里不再多做介绍
这里先介绍psr4，好和上面的psr0作对比,因为他是升级版的PSR-0自动加载规范
PSR4是关于由文件路径自动载入对应的类的相关规范，本规范是可互操作的。可以作为任一自动（包括PSR-0）载入规范的补充，此外，PSR4还包括自动载入的类对应的文件存放路径规范。
此处的“类”泛指所有的class类、接口、traits可复用代码块以及其他类似结构。
一个完整的类名需要具有以下结构
<命名空间>(<子命名空间>)*<类名>
当根据完整的类名载入相应的文件
例如：
#完整的类名为
\a\b\c\Log
#命名空间前缀前缀为：
a\b
#前缀对应的基础目录为：
./vendor
#文件实际目录为：
./vendor/c/Log.php
#注：即把去掉最前面的命名空间分隔符后的a\b\c\Log中的命名空间前缀替换成基础目录，然后把命名空间分隔符替换成目录分隔符，并把文件名补上后缀 .php 。
PSR-4和PSR-0最大的区别是对下划线（underscore)的定义不同。PSR-4中，在类名中使用下划线没有任何特殊含义。而PSR-0则规定类名中的下划线_会被转化成目录分隔符。
一个源文件建议只用来做声明（类(class)，函数(function)，常量(constant)等）或者只用来做一些引起从属效应的操作（例如：输出信息，包含文件，修改.ini配置等），但不能同时使用两者。
注：“从属效应”(side effects)一词的意思是，仅仅通过包含文件，不直接声明类、函数和常量等，而执行的逻辑操作。 “从属效应”包含却不仅限于：生成输出、直接的 require 或 include、连接外部服务、修改 ini 配置、抛出错误或异常、修改全局或静态变量、读或写文件等。 这个很多人都不遵守，但是基本上所有框架里都不会把修改.ini配置和声明类或函数放到一起，比如框架index.php入口文件只定义宏常量和修改.ini等
方法名(method name) 必须使用驼峰式(cameCase)写法。
<?php
namespace Vendor\Package;
use FooInterface;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;
class Foo extends Bar implements FooInterface
{
public function sampleMethod($a, $b = null)
{
if ($a === $b) {
bar();
} elseif ($a > $b) {
$foo->bar($arg1);
} else {
BazClass::bar($arg2, $arg3);
}
}
final public static function bar()
{
// method body
}
}
通常还有以下几点需要注意
对于php文件：
关键字和 True/False/Null
命名空间
例如：
<?php
namespace Vendor\Package;
use FooClass;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;
// ... additional PHP code ...
控制结构
if ，else ，elseif ，while ，do while ，switch case ，for， foreach，try catch等。这一类的写法规范也是经常容易出现问题的，也要规范一下。在关键字和后面的判断条件中间应该加空格，在判断条件和左大括号之间也要加空格。
本规范的主要目的，是为了让类库以简单通用的方式接收一个Psr\Log\LoggerInterface对象，来记录日志信息。框架以及CMS内容管理系统如有需要，可以扩展接口以用于它们自己的
目的，但须遵循本规范，才能在使用第三方的类库文件时，保证日志接口仍能正常对接。
LoggerInterface 接口对外定义了八个方法，分别用来记录RFC 5424中定义的八个级别：debug、info、notice、warning、error、critical、alert，emergency。
第九个方法-log，其第一个参数为日志的等级，可使用一个预定义好的等级常量作为参数来调用此方法，必须与直接调用以上八个方法具有相同的效果。如果传入的等级常量参数没有预先定义，就必须抛出Psr\Log\InvalidArgumentException类型的异常，在不确定的情况下，使用者不该使用未支持的等级常量来调用此方法。如果有用过monolog就应该对这里有较深的理解。
例如，日志等级可以定义如下：
<?php
namespace Psr\Log;
/**
* Describes log levels
*/
class LogLevel
{
const EMERGENCY = ‘emergency‘;
const ALERT = ‘alert‘;
const CRITICAL = ‘critical‘;
const ERROR = ‘error‘;
const WARNING = ‘warning‘;
const NOTICE = ‘notice‘;
const INFO = ‘info‘;
const DEBUG = ‘debug‘;
}日志这里想必大家接触的也不多，如果想了解可以看一看monolog的源码。
本文到此就结束，希望大家get到了想要的知识。
标签：arc rfc space ida 抛出异常 argument cas comm 大小写
原文地址：https://www.cnblogs.com/vinter/p/9505154.html
