If you want to write a good PHP program, you must know what PHP specifications are. This article mainly shares the analysis of PHP specifications with you, hoping to help everyone.
nameTest = new TestClass(); // 链式操作 $this->nameTest->functionOne() ->functionTwo() ->functionThree(); // 一段代码逻辑执行完毕 换行 // code... } /** * 成员方法名称. * * 成员方法描述 * * @param string $value 形参名称/描述 * * @return 返回值类型 返回值描述 * 返回值类型:string,array,object,mixed(多种,不确定的),void(无返回值) */ public function testFunction($value = '')// 成员方法必须小写开头驼峰 { // code... } /** * 成员方法名称. * * 成员方法描述 * * @param string $value 形参名称/描述 * * @return 返回值类型 返回值描述 */ private function _privateTestFunction($value = '')// 私有成员方法【个人建议】下划线小写开头驼峰 { // code... } /** * 成员方法名称. * * 成员方法描述 * * @param string $value 形参名称/描述 * * @return 返回值类型 返回值描述 */ public static function staticFunction($value = '')// static位于修饰符之后 { // code... } /** * 成员方法名称. * * 成员方法描述 * * @param string $value 形参名称/描述 * * @return 返回值类型 返回值描述 */ abstract public function abstractFunction($value = ''); // abstract位于修饰符之前 /** * 成员方法名称. * * 成员方法描述 * * @param string $value 形参名称/描述 * * @return 返回值类型 返回值描述 */ final public function finalFunction($value = '')// final位于修饰符之前 { // code... } /** * 成员方法名称. * * 成员方法描述 * * @param string $valueOne 形参名称/描述 * @param string $valueTwo 形参名称/描述 * @param string $valueThree 形参名称/描述 * @param string $valueFour 形参名称/描述 * @param string $valueFive 形参名称/描述 * @param string $valueSix 形参名称/描述 * * @return 返回值类型 返回值描述 */ public function tooLangFunction( $valueOne = '', // 变量命名可小写开头驼峰或者下划线命名,个人那习惯,据说下划线可读性好 $valueTwo = '', $valueThree = '', $valueFour = '', $valueFive = '', $valueSix = '')// 参数过多换行 { if ($valueOne === $valueTwo) {// 控制结构=>后加空格,同{一行,(右边和)左边不加空格 // code... } switch ($valueThree) { case 'value': // code... break; default: // code... break; } do { // code... } while ($valueFour <= 10); while ($valueFive <= 10) { // code... } for ($i=0; $i < $valueSix; $i++) { // code... } } }
编码规范 PHP代码文件必须以 doSomething(); do_something(); 控制结构的开始花括号 { 必须 写在声明的同一行,而结束花括号 } 必须 写在主体后自成一行。 if ($valueOne === $valueTwo) { // code... } switch ($valueThree) { case 'value': // code... break; default: // code... break; } do { // code... } while ($valueFour <= 10); while ($valueFive <= 10) { // code... } for ($i = 0; $i < $valueSix; $i++) { // code... } 控制结构的开始左括号后和结束右括号前,都一定不可有空格符。 if ($valueOne === $valueTwo) {// 控制结构(右边和)左边不加空格 // code... } 编码建议 sql过长 // heredoc语法 $sql = <<0 && $b > 0 && $c > 0 && $d > 0 && $e > 0) { } 方法或函数参数大于三个换行 public function tooLangFunction( $valueOne = '', $valueTwo = '', $valueThree = '', $valueFour = '', $valueFive = '', $valueSix = '') { //coding... } 链式操作超过两个 $this->nameTest->functionOne() ->functionTwo() ->functionThree(); 数组php5.4以后,使用[] $a = [ 'aaa' => 'aaa', 'bbb' => 'bbb' ]; /*单引号多引号 字符串中无变量,单引号 字符串中有变量,双引号 $str = 'str'; $arg = "$str"; 声明类或者方法或函数添加描述&属性描述&作者*/ /** * 类描述 * * desc */ class StandardExample { /** * 常量描述. * * @var string */ const THIS_IS_A_CONST = ''; /** * 属性描述. * * @var string */ public $nameTest = ''; /** * 构造函数. * * 构造函数描述 * @author name * @param string $value 形参名称/描述 * @return 返回值类型 返回值描述 * 返回值类型:string,array,object,mixed(多种,不确定的),void(无返回值) */ public function __construct($value = '') { // coding... } //api方法提供测试样例example /** * 成员方法名称. * * 成员方法描述 * * @param string $value 形参名称/描述 * * @example domain/api/controller/action?argu1=111&argu2=222 */ public function testFunction($value = '') { // code... } 使用try...catch... try { // coding... } catch (\Exception $e) { // coding... } // 连续调用多个方法(大于3个)使用foreach // 改写doSome为doSomething class StandardExample { /** * 方法列表 * * @var array */ private $_functionList = []; public function __construct($functionList = array()) { $this->_functionList = $value; } public function doSome() { $this->functionOne(); $this->functionTwo(); $this->functionThree(); $this->functionFour(); } public function doSomething() { foreach($this->_functionList as $function) { $this->$function(); } } ... } 文件顶部进行版权声明 // +---------------------------------------------------------------------- // | Company Name xx服务 // +---------------------------------------------------------------------- // | Copyright (c) 2017 http://domain All rights reserved. // +---------------------------------------------------------------------- // | Author: name // +----------------------------------------------------------------------
Related recommendations:
PHP specification PSR-1 php language php manual php development engineer
The above is the detailed content of PHP specification analysis. For more information, please follow other related articles on the PHP Chinese website!