[計算機]php編碼規(guī)范(編輯修改稿)
2024-09-12 12:27 本頁面
【文章內(nèi)容簡介】 容。請使用 C 樣式的注釋“/* */”和標準 C++ 注釋“//” 。在 Discuz!每一個程序文件頭部中，應放入相應 CVS 控制字串，以方便 CVS 提交時自動更新：第 3 頁 共 9 頁 ? $RCSfile$ 程序文件名? $Revision$ 修訂版本號? $Date$ 最后更新時間例如：/*[DODI] (C)20222022 Comsenz Inc.This is NOT a freeware, use is subject to license terms$RCSfile: ,v $$Revision: $$Date: 2022/02/23 13:44:02 $*/程序開發(fā)中難免留下一些臨時代碼和調(diào)試代碼，此類代碼必須添加注釋，以免日后遺忘。所有臨時性、調(diào)試性、試驗性的代碼，必須添加統(tǒng)一的注釋標記“//debug”并后跟完整的注釋信息，這樣可以方便在程序發(fā)布和最終調(diào)試前批量檢查程序中是否還存在有疑問的代碼。例如：$num = 1。$flag = TRUE。 //debug 這里不能確定是否需要對$flag 進行賦值if(empty($flag)) {//Statements}. 縮進每個縮進的單位約定是一個 TAB(8 個空白字符寬度)，需每個參與項目的開發(fā)人員在編輯器(UltraEdit、 EditPlus、Zend Studio 等) 中進行強制設定，以防在編寫代碼時遺忘而造成格式上的不規(guī)范。本縮進規(guī)范適用于 PHP、JavaScript 中的函數(shù)、類、邏輯結構、循環(huán)等。. 大括號{}、if 和 switch首括號與關鍵詞同行，尾括號與關鍵字同列；if 結構中，else 和 elseif 與前后兩個大括號同行，左右各一個空格。另外，即便 if 后只有一行語句，仍然需要加入大括號，以保證結構清晰；第 4 頁 共 9 頁 switch 結構中，通常當一個 case 塊處理后，將跳過之后的 case 塊處理，因此大多數(shù)情況下需要添加 break。break 的位置視程序邏輯，與 case 同在一行，或新起一行均可，但同一 switch 體中，break 的位置格式應當保持一致。以下是符合上述規(guī)范的例子：if($condition) {switch($var) {case 1: echo ‘var is 1’。 break。case 2: echo ‘var is 2’。 break。default: echo ‘var is neither 1 or 2’。 break。}} else {switch($str) {case ‘a(chǎn)bc’:$result = ‘a(chǎn)bc’。break。default:$result = ‘unknown’。break。}}. 運算符、小括號、空格、關鍵詞和函數(shù)每個運算符與兩邊參與運算的值或表達式中間要有一個空格，唯一的特例是字符連接運算符號兩邊不加空格；左括號“(” 應和函數(shù)關鍵詞緊貼在一起，除此以外應當使用空格將“(”同前面內(nèi)容分開；右括號“)”除后面是 “)”或者“.”以外，其他一律用空格隔開它們；除字符串中特意需要，一般情況下，在程序以及 HTML 中不出現(xiàn)兩個連續(xù)的空格；任何情況下，PHP 程序中不能出現(xiàn)空白的帶有 TAB 或空格的行，即：這類空白行應當不包含任何TAB 或空格。同時，任何程序行尾也不能出現(xiàn)多余的 TAB 或空格。多數(shù)編輯器具有自動去除行尾空格的功能，如果習慣養(yǎng)成不好，可臨時使用它，避免多余空格產(chǎn)生；每段較大的程序體，上、下應當加入空白行，兩個程序塊之間只使用 1 個空行，禁止使用多行。程序塊劃分盡量合理，過大或者過小的分割都會影響他人對代碼的閱讀和理解。一般可以以較大函數(shù)定義、邏輯結構、功能結構來進行劃分。少于 15 行的程序塊，可不加上下空白行；說明或顯示部分中，內(nèi)容如含有中文、數(shù)字、英文單詞混雜，應當在數(shù)字或者英文單詞的前后加入空格。第 5 頁 共 9 頁 根據(jù)上述原則，以下舉例說明正確的書寫格式：$result = (($a + 1) * 3 / 2 + $num)).’Test’。$condition ? func1($var) : func2($var)。$condition ? $long_statement: $another_long_statement。if($flag) {//Statements//More than 15 lines}Showmessage(‘請使用 工具恢復數(shù)據(jù)。 ’)。. 函數(shù)定義? 參數(shù)的名字和變量的命名規(guī)范一致；? 函數(shù)定
環(huán)評公示相關推薦
鄂ICP備17016276號-1