3.11. 記錄所有的空語句

總是記錄下for或者是while的空塊語句，以便清楚的知道該段代碼是漏掉了，還是故意不寫的。

while ($dest++ = $src++)
; // VOID

3.12. 不要采用缺省方法測試非零值

不要采用缺省值測試非零值，也就是使用：

if (FAIL != f())
比下面的方法好：

if (f())

即使 FAIL 可以含有 0 值 ，也就是PHP認(rèn)為false的表示。在某人決定用-1代替0作為失敗返回值的時候，一個顯式的測試就可以幫助你了。就算是比較值不會變化也應(yīng)該使用顯式的比較；例如：if (!($bufsize % strlen($str)))應(yīng)該寫成：if (($bufsize % strlen($str)) == 0)以表示測試的數(shù)值（不是布爾）型。一個經(jīng)常出問題的地方就是使用strcmp來測試一個字符等式，結(jié)果永遠(yuǎn)也不會等于缺省值。
非零測試采用基于缺省值的做法，那么其他函數(shù)或表達(dá)式就會受到以下的限制:
· 只能返回0表示失敗，不能為/有其他的值。
· 命名以便讓一個真(true)的返回值是絕對顯然的，調(diào)用函數(shù)IsValid()而不是Checkvalid()。

3.13. 布爾邏輯類型

大部分函數(shù)在FALSE的時候返回0，但是發(fā)揮非0值就代表TRUE，因而不要用1（TRUE，YES，諸如此類）等式檢測一個布爾值，應(yīng)該用0（FALSE，NO，諸如此類）的不等式來代替：

if (TRUE == func()) { ...
應(yīng)該寫成：

if (FALSE != func()) { ...

3.14. 通常避免嵌入式的賦值

有時候在某些地方我們可以看到嵌入式賦值的語句，那些結(jié)構(gòu)不是一個比較好的少冗余，可讀**強(qiáng)的方法。

while ($a != ($c = getchar()))
{
process the character
}
++和--操作符類似于賦值語句。因此，出于許多的目的，在使用函數(shù)的時候會產(chǎn)生副作用。使用嵌入式賦值提高運(yùn)行時**能是可能的。無論怎樣，程序員在使用嵌入式賦值語句時需要考慮在增長的速度和減少的可維護(hù)**兩者間加以權(quán)衡。例如：

a = b + c;
d = a + r;
不要寫成：

d = (a = b + c) + r;

雖然后者可以節(jié)省一個周期。但在長遠(yuǎn)來看，隨著程序的維護(hù)費(fèi)用漸漸增長，程序的編寫者對代碼漸漸遺忘，就會減少在成熟期的最優(yōu)化所得。


4. 幫助與共享

4.1. 重用您和其他人的艱苦工作

跨工程的重用在沒有一個通用結(jié)構(gòu)的情況下幾乎是不可能的。對象符合他們現(xiàn)有的服務(wù)需求，不同的過程有著不同的服務(wù)需求環(huán)境，這使對象重用變得很困難。
開發(fā)一個通用結(jié)構(gòu)需要預(yù)先花費(fèi)許多的努力來設(shè)計。當(dāng)努力不成功的時候，無論出于什么原因，有幾種辦法推薦使用：

4.2. 請教！給群組發(fā)Email求助

這個簡單的方法很少被使用。因?yàn)橛行┏绦騿T們覺得如果他向其他人求助，會顯得自己水平低，這多傻啊!做新的有趣的工作，不要一遍又一遍的做別人已經(jīng)做過的東西。
如果你需要某些事項(xiàng)的源代碼，如果已經(jīng)有某人做過的話，就向群組發(fā)email求助。結(jié)果會很驚喜哦！
在許多大的群組中，個人往往不知道其他人在干什么。你甚至可以發(fā)現(xiàn)某人在找一些東西做，并且自愿為你寫代碼，如果人們在一起工作，外面就總有一個金礦。

4.3. 告訴！當(dāng)你在做事的時候，把它告訴所有人

如果你做了什么可重用的東西的話，讓其他人知道。別害羞，也不要為了保護(hù)自豪感而把你的工作成果藏起來。一旦養(yǎng)成共享工作成果的習(xí)慣，每個人都會獲得更多。

4.4. 小型代碼庫

對于代碼重用，一個常見的問題就是人們不從他們做過的代碼中做庫。一個可重用的類可能正隱蔽在一個程序目錄并且決不會有被分享的激動，因?yàn)槌绦騿T不會把類分拆出來加入庫中。
這樣的其中一個原因就是人們不喜歡做一個小庫，對小庫有一些不正確感覺。把這樣的感覺克服掉吧，電腦才不關(guān)心你有多少個庫呢。
如果你有一些代碼可以重用，而且不能放入一個已經(jīng)存在的庫中，那么就做一個新的庫吧。如果人們真的考慮重用的話，庫不會在很長的一段時間里保持那么小的。

4.5. 知識庫

很多公司不清楚現(xiàn)有什么代碼可用，而且大多數(shù)程序員仍然沒有通過溝通他們已經(jīng)做過了什么，或者一直在詢問現(xiàn)存什么代碼可用。解決這個的方法是有一個可用的知識庫。
理想的情況是，程序員可以到一個WEB頁，瀏覽或者查詢打包的知識庫列表，找到他們所要的。建立一個程序員可以自動維護(hù)的知識庫系統(tǒng)，是一個很不錯的做法。如果有一個專門的管理員來負(fù)責(zé)維護(hù)這個知識庫，那當(dāng)然更好。
另一種方法是自動的從代碼中產(chǎn)生知識庫的做法。把通用的類、方法和標(biāo)頭（subsystem headers）作為手冊或者是知識庫的一個條目。


5. 書寫注釋


5.1. 講一個故事

把你的注釋當(dāng)作描述系統(tǒng)的一個故事。并且使得你的注釋能被機(jī)器解析后，以固定的格式放到手冊中去。類的注釋是故事的一部分，方法的名稱、方法的注釋、方法的實(shí)現(xiàn)也是故事一部分。所有的這些部分編織在一起，使得人們在以后的時間里能夠準(zhǔn)確的知道你干了什么，為什么這么做。

5.2. 歸檔注釋

注釋的要?dú)w檔才有意義，否則，假如在一個地方放一條注釋描述你做了什么選擇和你為什么這么做，只有考古學(xué)家才能發(fā)現(xiàn)這是最有用的信息。（如何歸檔另行規(guī)范）

5.3. 注釋結(jié)構(gòu)

工程的每部分都有特定的注釋結(jié)構(gòu)。 程序中的注釋，這里給出示例作為規(guī)范，注釋中以 * @ 為關(guān)鍵字的開始，以:為注釋關(guān)鍵字結(jié)尾。

5.3.1. 預(yù)定義關(guān)鍵字

關(guān)鍵字 含義
Purpose 表示類、屬**、方法要做些什么或者什么含義。
Package Name 類名
Author 作者
Modifications 修改記錄（編號規(guī)則為“No”＋日期＋“－”＋序號）
See 參考
Method Name 方法名
Parameter 參數(shù)名（包括類型）
Return 返回值（包括類型）
Attribute/Variable Name 屬**/變量名
Type 屬**/變量類型

5.3.2. 類的注釋

/**
* @ Purpose:
* 訪問數(shù)據(jù)庫的類，以O(shè)DBC作為通用訪問接口
* @Package Name: Database
* @Author: Forrest Gump gump@crtvu.edu.cn
* @Modifications:
* No20020523-100:
* odbc_fetch_into()參數(shù)位置第二和第三個位置調(diào)換
* John Johnson John@crtvu.edu.cn
* @See: (參照)
*/
class Database
{
……
}

5.3.3. 方法注釋

/**
* @Purpose:
* 執(zhí)行一次查詢
* @Method Name: Query()
* @Parameter: string $queryStr SQL查詢字符串
* @Return: mixed 查詢返回值（結(jié)果集對象）
*/
function（$queryStr）{……}

5.3.4. 屬**或變量注釋

/**
* @Purpose:
* 數(shù)據(jù)庫連接用戶名
* @Attribute/Variable Name: mDbUserName
* @Type: string
*/
var mDbUserName;

5.3.5. if (0)來注釋外部代碼塊

有時需要注釋大段的測試代碼，最簡單的方法就是使用if (0)塊：
function example()
{
great looking code

if (0) {
lots of code
}

more code
}
你不能使用/**/，因?yàn)樽⑨寖?nèi)部不能包含注釋，而大段的程序中可以包含注釋。

5.3.6. 目錄文檔

所有的目錄下都需要具有README文檔，其中包括：
· 該目錄的功能及其包含內(nèi)容
· 一個對每一文件的在線說明（帶有l(wèi)ink），每一個說明通常還應(yīng)該提取文件標(biāo)頭的一些屬**名字。
· 包括設(shè)置、使用說明
· 指導(dǎo)人們?nèi)绾芜B接相關(guān)資源：
o 源文件索引
o 在線文檔
o 紙文檔
o 設(shè)計文檔
· 其他對讀者有幫助的東西
考慮一下，當(dāng)每個原有的工程人員走了，在6個月之內(nèi)來的一個新人，那個孤獨(dú)受驚嚇的探險者通過整個工程的源代碼目錄樹，閱讀說明文件，源文件的標(biāo)頭說明等等做為地圖，他應(yīng)該有能力穿越整個工程。


6. 其他


· 采用面向?qū)ο蟮脑O(shè)計方法；

理由
毫無疑問這是最接近人們自然思維的方法，可能前期會覺得沒有直接書寫來得快，能否試著保留自己的看法？好戲在后頭！

· 類的定義采用一個文件一個類，并且類名和文件名相同；

理由
o 越來越多的人接受了這種做法
o 事實(shí)證明這種方法使得項(xiàng)目的邏輯結(jié)構(gòu)更清晰

· 類定義文件中，定義體之外不得出現(xiàn)諸如echo、print等輸出語句；

理由
出現(xiàn)這樣的語句，應(yīng)該當(dāng)做出現(xiàn)bug來看。

· 輸出網(wǎng)頁的頁面不出現(xiàn)SQL語句

理由
這是n層結(jié)構(gòu)的編程思想所致，每層的任務(wù)不同，雖然可以越權(quán)行使，可能這樣很快捷，但我們不贊成這么干。

· 進(jìn)行SQL執(zhí)行的數(shù)據(jù)必須進(jìn)行有效**檢測

特殊符號：
對于MS SQL Server，’%_[ ] 這些符號都是在書寫SQL語句中的特殊含義字符，在SQL執(zhí)行前需要對這些字符進(jìn)行處理。
腳本符號：
對于PHP腳本標(biāo)記，如<??><%%><?php?><script lang<script language="php"></script>，在進(jìn)入數(shù)據(jù)庫前需要檢測處理。
理由
這是數(shù)據(jù)庫編程的一個約定，很多參考書上也是這么說，這里需要強(qiáng)調(diào)一下。

· 在HTML網(wǎng)頁中盡量不要穿插PHP代碼

循環(huán)代碼和純粹變量輸出（類似于<?=$UserName?>）除外。
理由
o 需要說明的是我們工作的上游，頁面設(shè)計者的工作，假如在頁面中穿插代碼，將破壞結(jié)構(gòu)，這應(yīng)當(dāng)是我們需要避免的。
o 在這里的PHP代碼只負(fù)責(zé)顯示，多余的代碼顯然是不應(yīng)該的。

· 沒有含義的數(shù)字

一個在源代碼中使用了的赤裸裸的數(shù)字是不可思議的數(shù)字，因?yàn)榘�括作者，在三個月內(nèi)，沒人它的含義。例如：
if (22 == $foo) { start_thermo_nuclear_war(); }
else if (19 == $foo) { refund_lotso_money(); }
else if (16 == $foo) { infinite_loop(); }
else { cry_cause_im_lost(); }
在上例中22和19的含義是什么呢？如果一個數(shù)字改變了，或者這些數(shù)字只是簡單的錯誤，你會怎么想？
使用不可思議的數(shù)字是該程序員是業(yè)余運(yùn)動員的重要標(biāo)志.
你應(yīng)該用define()來給你想表示某樣?xùn)|西的數(shù)值一個真正的名字，而不是采用赤裸裸的數(shù)字，例如：
define("PRESIDENT_WENT_CRAZY", "22");
define("WE_GOOFED", "19");
define("THEY_DIDNT_PAY", "16");

if (PRESIDENT_WENT_CRAZY == $foo) { start_thermo_nuclear_war(); }
else if (WE_GOOFED == $foo) { refund_lotso_money(); }
else if (THEY_DIDNT_PAY == $foo) { infinite_loop(); }
else { happy_days_i_know_why_im_here(); }
現(xiàn)在不是變得更好了么？


7. PHP文件擴(kuò)展名


常見的PHP文件的擴(kuò)展名有：html, .php, .php3, .php4, .phtml, .inc, .class...
這里我們約定：

· 所有瀏覽者可見頁面使用.html
· 所有類、函數(shù)庫文件使用.php

理由

· 擴(kuò)展名描述的是那種數(shù)據(jù)是用戶將會收到的。PHP是解釋為HTML的。


8. PHP代碼標(biāo)記

統(tǒng)一使用<?php ?>，只輸出變量時<?=$username?>