[PSR规范]PSR-1基础编码规范
来源:互联网 发布:数据分析师职业前景 编辑:程序博客网 时间:2024/05/10 21:27
基础代码规范
本篇规定制定了代码基本元素的相关标准,以确保共享PHP代码间具有较高程度的技术互通性。
关于[能愿动词]的使用
为了避免歧义,文档大量使用了[能愿动词],对应的解释如下:
必须(MUST):绝对,严格遵循,请照做,无条件遵循。
一定不可(MUST NOT):禁令,严令禁止。
应该(SHOULD):强烈建议这样做,但是不强求。
不该(SHOULD NOT):强烈不建议这样做,但是不强求。
可以(MAY)和可选(OPTIONAL):选择性高一点,在这个文档内,此词语使用较少。
参见:RFC 2119
1.概览:
PHP代码文件必须以<?php 或者<?=标签开始。
PHP代码文件必须以不带BOM的UTF-8编码。
PHP代码中应该只定义类、函数、常量等声明,或者他会产生副作用的操作(如:生成文件输出以及修改 ini配置文件等),二者只能选其一。
命名空间以及类必须符合PSR的自动加载规范:PSR-4中的一个。
类的命名遵循StudlyCaps大写开头的驼峰式命名规范。
类中的常量所有字母都必须大写,单词间用下划线分割。
方法名称必须符合camelCase式的小写开头驼峰命名规范。
2.文件
2.1.PHP标签
PHP代码必须使用<?php?>长标签或<?=?>短输出标签,一定不可使用其他自定义标签。
2.2.字符编码
PHP代码必须且只可使用不带BOM的UTF-8编码。
2.3.副作用
一份PHP文件中应该要不就之定义新的声明,如类、函数或者常量等不产生副作用的操作,要不就只书写会产生副作用的逻辑操作,但不应该同时具有两者。
[副作用](side effects)一词的意思是,仅仅通过包含文件,不直接声明类、函数和常量等,而执行的逻辑操作。
[副作用]包含却不仅限于:
生成输出
直接的require或include
连接外部服务
修改ini配置
抛出错误或异常
修改全局或静态不变量
读或写文件等
以下是一个反例,一份包含[函数声明]以及产生[副作用]的代码:
<?php
// 「副作用」:修改 ini 配置
ini_set('error_reporting', E_ALL);
// 「副作用」:引入文件
include"file.php";
// 「副作用」:生成输出
echo"<html>\n";
// 声明函数
function foo()
{
// 函数主体部分
}
下面是一个范例,一份只包含声明不产生「副作用」的代码:
<?php
// 声明函数
function foo()
{
// 函数主体部分
}
// 条件声明 **不** 属于「副作用」
if(! function_exists('bar')){
function bar()
{
// 函数主体部分
}
}
<?php
// PHP 5.3及以后版本的写法
namespaceVendor\Model;
classFoo
{
}
5.2.x及之前的版本应该使用伪命名空间的写法,约定俗成使用顶级的组织名称(vendor name)如Vendor_为类前缀。
<?php
// 5.2.x及之前版本的写法
classVendor_Model_Foo
{
}
4.类的常量、属性和方法
此处[类]指所有的类、接口以及可复用代码块(traits)。
4.1.常量
类的常量中所有的字母都必须大写,词间以下划线分割。
参照以下代码:
<?php
namespaceVendor\Model;
classFoo
{
const VERSION ='1.0';
const DATE_APPROVED ='2012-06-01';
}
4.2. 属性
类的属性命名 可以 遵循:
大写开头的驼峰式 ($StudlyCaps)
小写开头的驼峰式 ($camelCase)
下划线分隔式 ($under_score)
本规范不做强制要求,但无论遵循哪种命名方式,都 应该 在一定的范围内保持一致。这个范围可以是整个团队、整个包、整个类或整个方法。
方法名称 必须 符合 camelCase() 式的小写开头驼峰命名规范。
- [PSR规范]PSR-1基础编码规范
- 「PSR 规范」PSR-1 基础编码规范
- PHP编码规范/PSR-1
- PSR-1 基本编码规范
- PSR规范--php编码规范
- PHP PSR-1 规范
- PSR-1规范
- PSR规范
- PSR规范
- PSR规范
- PSR规范
- psr规范
- PHP编码规范之PSR-1
- PHP PSR 1-4 编码规范
- PHP编码规范/PSR-2
- PHP编码规范/PSR-3
- PHP编码规范/PSR-4
- 「 PSR规范」PSR-2 编码风格规范
- GreenDAO—Android ORM框架(一)
- 主成分分析(PCA)深入剖析+Matlab模拟
- Jni从dll或so文件中获取信息
- SwiftyJSON不能被Objective-c调用
- 实验2:Android UI-聊天界面
- [PSR规范]PSR-1基础编码规范
- docker使用总结
- Win8/Win8下如何设置护眼色,myeclipse如何设置护眼色(RGB:199 237 204),myeclipse如何设置整个界面都为护眼色
- 架构设计:系统存储(2)——块存储方案(2)
- GreenDAO 3.x官方文档 — Android ORM框架(二)
- 权力的形状
- 英语口语收集(十)
- view的测量
- Trick: Disable USB read-only status under Windows