PHP-Dokumentation zu Codierungsstandards (Sammlung)

Um die Arbeitseffizienz zu verbessern, die Effektivität und Rationalität der Entwicklung sicherzustellen, die Lesbarkeit und Wiederverwendbarkeit des Programmcodes zu maximieren und die Kommunikationseffizienz zu verbessern, ist eine Spezifikation zum Schreiben von Code erforderlich. Lassen Sie alle gute Programmiergewohnheiten entwickeln und Fehler im Code reduzieren.
CleverCode hat einige Spezifikationen zusammengestellt. Diese Spezifikation umfasst Namenskonventionen, Code-Einrückungsregeln, Kontrollstrukturen, Funktionsaufrufe, Funktionsdefinitionen, Kommentare, enthaltene Codes, PHP-Tags und allgemeine Namensregeln bei der Programmcodierung während der PHP-Entwicklung.

1 Dateiformat

1.1 Datei-Tag

Alle PHP-Dateien verwenden vollständige PHP-Tags für ihre Code-Tags. Es wird nicht empfohlen, kurze Tags zu verwenden, wie zum Beispiel:

<?php  
//推荐  
echo &#39;hello world&#39;;  
?>  
  
  
<?  
//短标签格式不推荐  
echo &#39; hello world &#39;;  
?>

1) Die Verwendung des Kurz-Tag-Formats kann leicht mit XML verwechselt werden, und nicht alle PHP-Versionen und Server unterstützen oder aktivieren standardmäßig die Kurz-Tag-Option (ab PHP5.4 ist die Kurz-Tag-Option in php.ini hat keinen Einfluss auf die Verwendung von Short-Tags. Bei Dateien, die nur PHP-Code enthalten, wird das ?> am Ende der Datei ignoriert. Dadurch soll verhindert werden, dass zusätzliche Leerzeichen oder andere Zeichen den Code beeinträchtigen.
2) Tatsächlich tritt dieses Problem nur auf, wenn die Komprimierung oder die zwischengespeicherte Ausgabe nicht aktiviert ist, zum Beispiel:
php.ini-disable komprimierte Ausgabe und zwischengespeicherte Ausgabe

zlib.output_conpression = off
output_buffering = off

foo .php, bitte beachten Sie, dass danach einige Leerzeichen oder Zeilenumbrüche stehen, diese sind auf der Seite natürlich nicht zu sehen.

<?php  
    $foo= &#39;foo&#39;;  
?>

index.php gibt zwar foo.php ein, gibt jedoch tatsächlich einige Leerzeichen oder Zeilenumbrüche aus.

<?php  
    include &#39;foo.php&#39;;  
    session_start();  
?>

Sie werden eine Warnung sehen: „...Cannotsendsessioncachelimiter-headersalreadysent...“

1.2 Datei- und Verzeichnisbenennung

Programm Dateinamen und Verzeichnisnamen müssen in aussagekräftigem Englisch benannt werden. Es sind nur Buchstaben, Zahlen, Unterstriche und Unterstreichungszeichen zulässig und sie müssen mit „.php“ enden (außer bei Vorlagendateien).

//Klassen verwenden einheitlich
DemoTest.php

2 Namenskonventionen

2.1 Variablenbenennung

Variablen in PHP verwenden ein The Auf das Dollarzeichen folgt der Variablenname. Bei Variablennamen muss die Groß-/Kleinschreibung beachtet werden. Ein gültiger Morph-Name beginnt mit einem Buchstaben oder einem Unterstrich, gefolgt von einer beliebigen Anzahl von Buchstaben, Zahlen oder Unterstrichen. Der normale

reguläre Ausdruck wird wie folgt ausgedrückt: [a-zA-Z_x7f-xff][a-zA-ZO-9_'x7f-xff]. Variablen.

2.1.1 Das gesamte Programm

Das gesamte Programm wird in Kamelschrift benannt, beginnend mit einem Kleinbuchstaben, und der Name muss aussagekräftig sein, wie zum Beispiel:

function displayName($name){  
    echo $name;  
}

2.1.2 PHP-Global-Variablenschlüsselwert

Der PHP-Global-Variablenschlüsselwert hat auf beiden Seiten einen zweiten Vornamen und verwendet die Kamel-Fall-Benennung.

2.1.3 Gewöhnliche Variablen

Gewöhnliche Variablen übernehmen als Ganzes die Kamelschreibung,

werden gemäß der Konvention benannt und vermeiden die Verwendung allgemeiner Schlüsselwörter oder Wörter mit mehrdeutiger Bedeutung. Variablen sollten auf Substantiven basieren.
String:$myName
Array:$myArray

Nicht empfohlen:
$yes: Es sollte nicht als Bool-Variable verwendet werden, da die Variable wahrscheinlich geändert wird, was dazu führen kann Syeszflase, was die Codelogik verwirrend macht.
$sex: Ein englisches Wort mit vager Bedeutung und Unechtheit. Der Name des Geschlechts sollte $gender sein.

2.1.4 Funktionsnamen

Funktionsnamen sollten aussagekräftig sein, damit Sie auf einen Blick wissen, was sie tun werden, und sie sollten außerdem so weit wie möglich abgekürzt werden. Es wird empfohlen, eine Benennungsmethode aus Verb oder Verb plus Adjektiv

zu verwenden, z. B. showMsg. Der folgende Funktionsname wird nicht empfohlen:

getPublishedAdvertisementBy
CategoryAndCategoryldAndPosition()

Der obige Funktionsname kann verfeinert werden in:

getAd($category,$categoryid，$position,$published)

Zum Beispiel 1) Öffentliche Klassenfunktion:

public function doGetUserName($job)

Zum Beispiel 2) Klassenprivate Funktion, beginnend mit „_“:

private function _doGetUserName($job)

Zum Beispiel 3) Klassengeschützte Funktion, beginnend mit „_“:

protected function _doGetUserName($job)

2.1.5 Attribute in der Klasse

Variablen in der Klasse folgen den Benennungsregeln gewöhnlicher Variablen.

Zum Beispiel 1) Öffentliche Attribute, statische Attribute:

public $userName = ’CleverCode’;
static $userType = array(1,2,3);

Zum Beispiel 2) Private Attribute, beginnend mit „_“:

private $_userName = ’CleverCode’;

Beispiel 3) Geschützte Attribute, beginnend mit „_“:

protected $_userName = ’CleverCode’;

Beispiel 4) Konstanten, alle in Großbuchstaben, getrennt durch „_“:

const TYPE_GZ = 4;

2.2 Datenbankbenennung

2.2.1 Bibliotheksbenennung

1) Verwenden Sie Kleinbuchstaben. (Windows unterscheidet nicht zwischen Groß- und Kleinschreibung und Linux unterscheidet nicht zwischen Groß- und Kleinschreibung. Aus Gründen der Portierungskompatibilität der Bibliothek werden alle Kleinbuchstaben verwendet.)

2) Es besteht aus mehreren Wörtern, die durch „_“ getrennt sind.
Zum Beispiel:

db_user,db_system。

2.2.2 Tabellenbenennung

1) Verwenden Sie Kleinbuchstaben für Tabellennamen.

2) Tabellennamen verwenden ein einheitliches Präfix, und das Präfix darf nicht leer sein (modular und kann effektiv MYSQL-reservierte Wörter vermeiden).
3) Für Tabellennamen, die aus mehreren Wörtern bestehen, verwenden Sie „_“-Intervalle.
Zum Beispiel:

pre_users,pre_user_shop

2.2.3 Tabellenfeldbenennung

1)全部使用小写字母命名。
2)多个单词不用下画线进行分割（重要）。
3)如果有必要，给常用字段加上表名首字母作为前缀。
4)避免使用关键字和保留字，但约定俗成的除外。
例如：

username,newsid,userid，logid

3 注释规范

3.1 文件注释

文件注释通常放在整个PHP文件头部，其内容包括文件版权、作者、编写日期、版本号等
重要信息。PHP中，可以参照phpdocument规范，便于利用程序自动生成文档。
文件注释遵循以下规则：
1)必须包含本程序的描述；
2)必须包含作者；
3)必须包含版权；
4)必须包含文件的名称；
5)可以包含书写日期；
6)可以包含版本信息；
7)可以包含重要的使用说明，如类的调用方法、注意事项等。
例如：

<?php  
  
  
/**  
 * SystemUser.php  
 *   
 * 系统用户操作操作  
 *  
 * Copyright (c) 2015 http://blog.csdn.net/CleverCode  
 *  
 * modification history:  
 * --------------------  
 * 2015/5/11, by Clever Code, Create  
 *

3.2 类与接口注释

类和接口的注释应该尽量简洁。按照一般的习惯，一个文件只包含一个类，在类注释中通常不需要再加上作者和版本等信息，加上可见性和简中的描述即可。如果文件注释已经足够详细,可以不用给类写注释。如果同时存在接口和接口的实现类，通常做法是仅在接口中进行注释。

3.3 方法和函数注释

方法和函数的注释写在前面，通常需要标明的信息主要是可见性、参数类型和返回值的类
例如1：

/** 
  * 对比新旧数据 
  * 
  * @param bigint $userid 人编号 
  * @param array $oldMap 旧数据 
  * @param array $newMap 新数据（输出参数） 
  * @return string 成功返回'OK'，失败返回错误信息 
  */  
 public static function diffRecommendInfo($userid, $oldMap, &$newMap){  
 }

例如2：

/** 
  * 插入日志数据 
  * 
  * @param bigint $data[‘userid’] 用户编号 
  * @param array $data[‘logintime’] 登录时间 
  * @return string 成功返回'OK'，失败返回错误信息 
  */  
 public static function insertLogData($data){  
 }

3.4 Action注释

由于我们都是使用的zend开发模式，在Action是http请求处理逻辑的入口，那么必然会传递get,post等参数。可以注释如下.
例如1）没有get,post传递参数时候：

/** 
     * 自动设置名称 
     * 
     * @return void 
     */  
    public function autosetAction(){  
}

例如2 ）有get传递参数时候：

/** 
     * 获取用户名称 
     * 
     * @get int $userid 用户编号 
     * @get int $currpage 当前页 
     * @get int $pagesize 
     * 
     * @return void 
     */  
public function getusernameAction(){  
}

例如3） 有post传递参数时候：

/** 
     * 删除用户 
     * 
     * @post int $userid 用户编号 
     * @return void 
     */  
public function deleteuserAction(){  
}

3.5 单行注释

1)写在被注释代码前面，而不是后面。但对于单行语句，按照习惯可以把注释放在语句末尾,也可以写在行上面。
2)对于大段注释，使用/**/格式，通常在文件和函数注释中使用，而代码内部统一使用//注释，因为其写起来简单。
例如：
//姓名

$name = ’CleverCode’;

4 代码风格

4.1 缩进与空格

在书写代码的时候，必须注意代码的缩进规则：
1)使用4个空格作为缩进，而不使用tab缩进（如在UltraEdit中可以进行预先设置）。
2)变量赋值时，等号左右留出空格。
例如：
$name = 'CleverCode';//推荐
$name='CleverCode';//不推荐

为了最大程度减轻工作量，保持代码美观，建议使用大型IDE管理代码。比如，在zend studio中，使用Ctrl+Shift+F组合键对代码进行格式化。

4.2 语句断行

代码书写中应遵循以下原则：
1)尽量保证程序语句一行就是一句；
2)尽量不要使一行的代码太长，一般控制在80个字符以内；
如果一行代码太长，请使用类似.=的方式断行书写；
执行数据库的SQL语句操作时，尽量不要在函数内写SQL语句，而先用变量定义SQL
语句，然后在执行操作的函数中调用定义的变量。
例如：

//代码分割
$sql= "SELECTusername,password,address,age,postcode from test_t";
$sql.= "WHEREusername=${user}";
$ret = mysql_query($sql);

3)一个函数控制在200行以内；
4)if最多嵌套3层；
//不推荐

If(){  
    If(){  
        If(){  
            If(){  
                ……  
            }  
        }  
    }  
}

5)循环最多3层。

//不推荐  
For(){  
    For(){  
        For(){  
            For(){  
                ……  
            }  
        }  
    }  
}

6)if或者for语句块中只有一行时候，加上{}。当有语句变动的时候会带来不必要的bug。

//推荐  
If($a == 1){  
    echo 1;  
}  
  
//不推荐  
If($a == 1) echo 1;

4.3 空行

1）函数与函数之间空行。
2）同一个函数不同逻辑块之间空行，查阅不同的逻辑块条理更清晰。

4.4 函数结构

通常一个函数分为三部分。第一部分：检查参数；第二部分：处理逻辑；第三部分：返回结果。
例如：

/** 
 * 删除日志通过uid 
 * 
 * @param string $uid 用户uid 
 * @return string 成功返回'OK'，失败返回错误信息 
 */  
public static function deleteLogByUid($uid){  
  
  
    //第一步：检查参数。防止处理部分异常；比如$uid是传入array();  
    if (!is_numeric($uid)) {  
        return '!is_numeric($uid)';  
    }  
      
    //第二步：处理逻辑。  
    $affected = $userLogTable->delete('where userid = ' . $uid);  
      
    //第三步：返回结果。让调用者知道是否处理正常。  
    if($affected){  
        return 'OK';  
    }  
      
    return 'delete error!';  
}

4.5 函数返回函数

需要客户端的函数：
返回值

$ret = array(‘code’=> 1 ,msg=>’’,data => array());

4.6 更好的习惯

在代码中，使用下面列举的写法，可以使代码更优雅。
1)多使用PHP中已经存在的常量，而不要自己定义，例如：

echo$meg."\r\n";
echo$msg,PHPJEOL;

PHP中，PHP_EOL是一个预定义常量，表示一行结束，随着所使用系统的不同，使用PHP_EOL会让代码更具有可移植性。

2)更详尽的注释。
注释是一门艺术，好的注释可以比代码更精彩。不用担心效率问题。一则注释对代码的效
率影响不大，其次在正式产品中可以对代码中的注释进行批量删除。注释做到极致和完美的典型代表是Apache组织各种产品的源代码。

3)不要滥用语法糖。
语法糖也就是语言中的潜规则，即不具有普遍代表性的语法。少量使用语法糖会尝到甜
头，大量使用则是一种灾难。
例如以下代码，可读性比较差；

$a?$a-$b:3&&$c&&$d=1;

Das obige ist der detaillierte Inhalt vonPHP-Dokumentation zu Codierungsstandards (Sammlung). Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!