Php
- PHP 编码规范(6)
-
4.2 单行注释
短注释可以显示在一行内,并与其后的代码具有一样的缩进层级。如果一个注释不能在一行内写完,就该采用块注释。单行注释之前应该有一个空行。以下是一个代码中单行注释的例子:
if (condition) {
/* 以下代码运行的条件 */ ...}4.3 尾端注释
极短的注释可以与它们所要描述的代码位于同一行,但是应该有足够的空白来分开代码和注释。若有多个短注
- 分类:Php 查阅全文
- PHP 编码规范(5)
-
3.6 换行
当一个表达式无法容纳在一行内时,可以依据如下一般规则断开之:
- 在一个逗号后面断开- 在一个操作符前面断开- 宁可选择较高级别(higher-level)的断开,而非较低级别(lower-level)的断开- 新的一行应该与上一行同一级别表达式的开头处对齐- 如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边,那就代之以缩进8个空格。
以下是断开方法调用的
- 分类:Php 查阅全文
- PHP 编码规范(4)
-
3.4 缩进排版
4个空格常被作为缩进排版的一个单位。缩进的确切解释并未详细指定(空格 vs. 制表符)。一个制表符等于8个空格(而非4个),所以在某些编辑器中,需要特别指定一下制表符的长度为4(UltraEdit),而在某些编辑器中,会将制表符转换为空格3.5 行长度
尽量避免一行的长度超过80个字符,因为很多终端和工具不能很好处理之。
- 分类:Php 查阅全文
- PHP 编码规范(3)
-
3.2 引入语句
引入语句应该位于文件的头部,并在引入时说明引入文件的作用。例如:
//数据库操作类require( “db.php” );3.3 类的声明
1 类文档注释(/**……*/) 该注释中所需包含的信息,参见"文档注释" 2 类的声明3 类实现的注释(/*……*/)如果有必要的话 该注释应包含任何有关整个类的信息,而这些信息又不适合作为类文档注释。4 类的(静态)变
- 分类:Php 查阅全文
- PHP 编码规范(28)
-
10 代码范例
/* * @(#)Cngift.php 1.82 03/06/25 * * 开花石头编写的示例文档 * 将对编码规范做简单的示范 * */
require( “db.php” );
/** * 示范用类 * * @version 1.82 03.06.25 * @author 开花石头 */class Blah extends SomeClass { /*
- 分类:Php 查阅全文
- PHP 编码规范(27)
-
9.3.4 运算符"?"前的表达式
如果一个包含二元运算符的表达式出现在三元运算符" ? : "的"?"之前,那么应该给表达式添上一对圆括号。例如:(x >= 0) ? x : -x;
9.3.5 特殊注释
在注释中使用XXX来标识某些未实现(bogus)的但可以工作(works)的内容。用FIXME来标识某些假的和错误的内容。
- 分类:Php 查阅全文
- PHP 编码规范(26)
-
9.3.3 返回值
设法让你的程序结构符合目的。例如:if (booleanExpression) { return true;} else { return false;}应该代之以如下方法:return booleanExpression;类似地:if (condition) { return x;}return y;应该写做:return (condition ? x
- 分类:Php 查阅全文
- PHP 编码规范(25)
-
9.3 大括号
在三种主要的大括号放置规则中,有两种是可以接受的,如下的第一种是最好的: 将大括号放置在关键词下方的同列处: if (condition){ ... while (condition) { ... } }传统的UNIX的括号规则是,首括号与关键词同行,尾括号与关键字同列: if (condition) { ... while (conditio
- 分类:Php 查阅全文
- PHP 编码规范(24)
-
9.3.1 圆括号
一般而言,在含有多种运算符的表达式中使用圆括号来避免运算符优先级问题,是个好方法。即使运算符的优先级对你而言可能很清楚,但对其他人未必如此。你不能假设别的程序员和你一样清楚运算符的优先级。if ($a == $b && $c == $d) // 错误if (($a == $b) && ($c == $d)) // 正确
- 分类:Php 查阅全文
- PHP 编码规范(22)
-
8.4 变量
除了变量名外,所有实例,包括类,类常量,均采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写。变量名不应以下划线或美元符号开头,尽管这在语法上是允许的。变量名应简短且富于描述。变量名的选用应该易于记忆,即,能够指出其用途。尽量避免单个字符的变量名,除非是一次性的临时变量。临时变量通常被取名为i,j,k,m和n,它们一般用于整型;c,d,e,它们一般用于
- 分类:Php 查阅全文
- PHP 编码规范(21)
-
8.3 函数
方法名是一个动词,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写。function run();function runFast();function getBackground();
通常每个方法都是执行一个动作的,所以对它的命名应该清楚的说明它是做什么的:用checkForErrors()代替errorCheck(),用dumpDataToF
- 分类:Php 查阅全文
- PHP 编码规范(20)
-
8.1 命名空间
一个唯一命名空间的前缀总是全部小写的ASCII字母并且是一个顶级域名,通常是com,edu,gov,mil,net,org,或1981年ISO 3166标准所指定的标识国家的英文双字符代码。命名空间的后续部分根据不同机构各自内部的命名规范而不尽相同。这类命名规范可能以特定目录名的组成来区分部门(department),项目(project),机器(machine)
- 分类:Php 查阅全文
- PHP 编码规范(19)
-
7.2 空格
下列情况应该使用空格:- 一个紧跟着括号的关键字应该被空格分开,例如:while ( true ) {...}注意:空格不应该置于方法名与其左括号之间。这将有助于区分关键字和方法调用。- 空白应该位于参数列表中逗号的后面- 所有的二元运算符,除了".",应该使用空格将之与操作数分开。一元操作符和操作数之间不因该加空格,比如:负号("-")、自增("++")和自减("-
- 分类:Php 查阅全文
- PHP 编码规范(18)
-
7.1 空行
空行将逻辑相关的代码段分隔开,以提高可读性。下列情况应该总是使用两个空行:- 一个源文件的两个片段(section)之间- 类声明声明之间 下列情况应该总是使用一个空行:- 两个方法之间- 方法内的局部变量和方法的第一条语句之间- 块注释或单行注释之前- 一个方法内的两个逻辑段之间,用以提高可读性
- 分类:Php 查阅全文
- PHP 编码规范(17)
-
6.9 try...catch语句
一个try-catch语句应该具有如下格式:try { statements;} catch (ExceptionClass e) { statements;}一个try-catch语句后面也可能跟着一个finally语句,不论try代码块是否顺利执行完,它都会被执行。try { statements;} catch (ExceptionC
- 分类:Php 查阅全文
- PHP 编码规范(15)
-
6.5 for语句
一个for语句应该具有如下格式:
for (initialization; condition; update) { statements;}
一个空的for语句(所有工作都在初始化,条件判断,更新子句中完成)应该具有如下格式:
for (initialization; condition; update);
当在for语句的初始化或更新子句中使用逗
- 分类:Php 查阅全文
- PHP 编码规范(14)
-
6 if与else语句
if-else语句应该具有如下格式:
if (condition){ /* 进行操作的条件 */ statements;}
if (condition) {/*进行操作的条件. */ statements;} else {/*进行操作的条件*/ statements;}
if (condition) {/*进行操作的条件*/ statement
- 分类:Php 查阅全文
- PHP 编码规范(13)
-
6.3 返回语句
一个带返回值的return语句不使用小括号"()",除非它们以某种方式使返回值更为显见。例如:
return;
return myDisk.size();
return ($size ? $size : $defaultSize);
- 分类:Php 查阅全文
- PHP 编码规范(12)
-
6.1 简单的语句
每行至多包含一条语句,例如:
$argv++; // 正确的$argc--; // 正确的$argv++; $argc--; // 错误的
6.2 复合语句
复合语句是包含在大括号中的语句序列,形如"{ 语句 }"。例如下面各段。
- 被括其中的语句应该较之复合语句缩进一个层次- 左大括号"{"应位于复合语句起始行的行尾;右大括号"}"应另起一行并与复合
- 分类:Php 查阅全文
- PHP 编码规范(11)
-
5.4 类的声明
当编写类时,应该遵守以下格式规则:
- 在方法名与其参数列表之前的左括号"("间不要有空格- 左大括号"{"位于声明语句同行的末尾- 右大括号"}"另起一行,与相应的声明语句对齐,除非是一个空语句,"}"应紧跟在"{"之后
class Sample extends Object { int $ivar1; int $ivar2;
function Sa
- 分类:Php 查阅全文