建站
咨詢
售后
建站咨詢
新聞中心
學(xué)習(xí)良好的編程習(xí)慣能夠提高代碼質(zhì)量和效率。像其他語言一樣，開發(fā)人員可以用 PHP 編寫出各種質(zhì)量級別的代碼。根據(jù)具體的情況，一般的開發(fā)人員往往比優(yōu)秀的開發(fā)人員的效率低 10%~20%。優(yōu)秀的開發(fā)人員的效率更高，因為他們擁有豐富的經(jīng)驗和良好的編程習(xí)慣。不良的編程習(xí)慣將會影響到效率。本文通過展示一些良好的編程習(xí)慣，幫助您成為更優(yōu)秀的程序員。
接上一篇>>
3. 為代碼添加注釋
要為代碼添加良好的注釋有時似乎和編寫代碼一樣難。要了解應(yīng)該為哪些內(nèi)容添加注釋并不容易，因為我們常常傾向于注釋代碼當(dāng)前做的事情。注釋代碼的目的是不錯的主意。在函數(shù)的不是很明顯的頭部代碼塊中，告訴讀者方法的輸入和輸出，以及方法的最初目標(biāo)。
注釋代碼當(dāng)前做什么是很常見的，但這是不必要的。如果代碼很復(fù)雜，不得不注釋它當(dāng)前在做什么，這將暗示您應(yīng)該重寫代碼，讓它更容易理解。學(xué)會使用良好的名稱和更短的方法，在不提供注釋說明其用途的情況下提高代碼的可讀性。
不良習(xí)慣：函數(shù)注釋過多或不足
清單 5 中的注釋僅告訴讀者代碼在做什么 — 它正在通過一個循環(huán)進行迭代或添加一個數(shù)字。但它忽略了它為什么 做當(dāng)前的工作。這使維護該代碼的人員不知道是否可以安全地更改代碼(不引入新缺陷)。
清單 5. 不良習(xí)慣：函數(shù)注釋過多或不足
- class ResultMessage
- {
- private $severity;
- private $message;
- public function __construct($sev, $msg)
- {
- $this->severity = $sev;
- $this->message = $msg;
- }
- public function getSeverity()
- {
- return $this->severity;
- }
- public function setSeverity($severity)
- {
- $this->severity = $severity;
- }
- public function getMessage()
- {
- return $this->message;
- }
- public function setMessage($msg)
- {
- $this->message = $msg;
- }
- }
- function cntMsgs($messages)
- {
- $n = 0;
- /* iterate through the messages... */
- foreach($messages as $m) {
- if ($m->getSeverity() == 'Error') {
- $n++; // add one to the result;
- }
- }
- return $n;}
- $messages = array(new ResultMessage("Error", "This is an error!"),
- new ResultMessage("Warning", "This is a warning!"),
- new ResultMessage("Error", "This is another error!"));
- $errs = cntMsgs($messages);
- echo("There are " . $errs . " errors in the result.\n");
- ?>
復(fù)制代碼良好習(xí)慣：帶注釋的函數(shù)和類
清單 6 中的注釋告訴讀者類和方法的目的。該注釋解釋了為什么代碼在做當(dāng)前的工作，這對未來維護代碼十分有用?？赡苄枰鶕?jù)條件變更而修改代碼，如果能夠輕松了解代碼的目的，則修改起來很容易。
清單 6. 良好習(xí)慣：帶注釋的函數(shù)和類
- /**
- *The ResultMessage class holds a message that can be returned
- * as a result of a process. The message has a severity and
- * message.
- *
- * @author nagood
- *
- */
- class ResultMessage
- {
- private $severity;
- private $message;
- /**
- * Constructor for the ResultMessage that allows you to assign
- * severity and message.
- * @param $sev See {@link getSeverity()}
- * @param $msg
- * @return unknown_type
- */
- public function __construct($sev, $msg)
- {
- $this->severity = $sev;
- $this->message = $msg;
- }
- /**
- * Returns the severity of the message. Should be one
- * "Information", "Warning", or "Error".
- * @return string Message severity
- */
- public function getSeverity()
- {
- return $this->severity;
- }
- /**
- * Sets the severity of the message
- * @param $severity
- * @return void
- */
- public function setSeverity($severity)
- {
- $this->severity = $severity;
- }
- public function getMessage()
- {
- return $this->message;
- }
- public function setMessage($msg)
- {
- $this->message = $msg;
- }
- }
- /*
- * Counts the messages with the given severity in the array
- * of messages.
- * @param $messages An array of ResultMessage
- * @return int Count of messages with a severity of "Error"
- */
- function countErrors($messages)
- {
- $matchingCount = 0;
- foreach($messages as $m) {
- if ($m->getSeverity() == "Error") {
- $matchingCount++;
- }
- }
- return $matchingCount;
- }
- $messages = array(new ResultMessage("Error", "This is an error!"),
- new ResultMessage("Warning", "This is a warning!"),
- new ResultMessage("Error", "This is another error!"));
- $errs = countErrors($messages);
- echo("There are " . $errs . " errors in the result.\n");
- ?>
#p#
4. 處理錯誤
根據(jù)大眾的經(jīng)驗，如果要編寫健壯的應(yīng)用程序，錯誤處理要遵循 80/20 規(guī)則：80% 的代碼用于處理異常和驗證，20% 的代碼用于完成實際工作。在編寫程序的基本邏輯(happy-path)代碼時經(jīng)常這樣做。這意味著編寫適用于基本條件的代碼，即所有的數(shù)據(jù)都是可用的，所有的條件符合預(yù)期。這樣的代碼在應(yīng)用程序的生命周期中可能很脆弱。另一個極端是，甚至需要花大量時間為從未遇到過的條件編寫代碼。
這一習(xí)慣要求您編寫足夠的錯誤處理代碼，而不是編寫對付所有錯誤的代碼，以致代碼遲遲不能完成。
不良習(xí)慣：根本沒有錯誤處理代碼
清單 7 中的代碼演示了兩個不良習(xí)慣。***，沒有檢查輸入的參數(shù)，即使知道處于某些狀態(tài)的參數(shù)會造成方法出現(xiàn)異常。第二，代碼調(diào)用一個可能拋出異常的方法，但沒有處理該異常。當(dāng)發(fā)生問題時，代碼的作者或維護該代碼的人員只能猜測問題的根源。
清單 7. 不良習(xí)慣：不處理錯誤條件
- // Get the actual name of the
- function convertDayOfWeekToName($day)
- {
- $dayNames = array(
- "Sunday",
- "Monday",
- "Tuesday",
- "Wednesday",
- "Thursday",
- "Friday",
- "Saturday");
- return $dayNames[$day];
- }
- echo("The name of the 0 day is: " . convertDayOfWeekToName(0) . "\n");
- echo("The name of the 10 day is: " . convertDayOfWeekToName(10) . "\n");
- echo("The name of the 'orange' day is: " . convertDayOfWeekToName('orange') . "\n");
- ?>
復(fù)制代碼良好習(xí)慣：處理異常
清單 8 展示了以有意義的方式拋出和處理異常。額外的錯誤處理不僅使代碼更加健壯，它還提高代碼的可讀性，使代碼更容易理解。處理異常的方式很好地說明了原作者在編寫方法時的意圖。
清單 8. 良好習(xí)慣：處理異常
- /**
- * This is the exception thrown if the day of the week is invalid.
- * @author nagood
- *
- */
- class InvalidDayOfWeekException extends Exception { }
- class InvalidDayFormatException extends Exception { }
- /**
- * Gets the name of the day given the day in the week. Will
- * return an error if the value supplied is out of range.
- *
- * @param $day
- * @return unknown_type
- */
- function convertDayOfWeekToName($day)
- {
- if (! is_numeric($day)) {
- throw new InvalidDayFormatException('The value \'' . $day . '\' is an ' .
- 'invalid format for a day of week.');
- }
- if (($day > 6) || ($day < 0)) {
- throw new InvalidDayOfWeekException('The day number \'' . $day . '\' is an ' .
- 'invalid day of the week. Expecting 0-6.');
- }
- $dayNames = array(
- "Sunday",
- "Monday",
- "Tuesday",
- "Wednesday",
- "Thursday",
- "Friday",
- "Saturday");
- return $dayNames[$day];
- }
- echo("The name of the 0 day is: " . convertDayOfWeekToName(0) . "\n");
- try {
- echo("The name of the 10 day is: " . convertDayOfWeekToName(10) . "\n");
- } catch (InvalidDayOfWeekException $e) {
- echo ("Encountered error while trying to convert value: " . $e->getMessage() . "\n");
- }
- try {
- echo("The name of the 'orange' day is: " . convertDayOfWeekToName('orange') . "\n");
- } catch (InvalidDayFormatException $e) {
- echo ("Encountered error while trying to convert value: " . $e->getMessage() . "\n");
- }
- ?>
復(fù)制代碼雖然檢查參數(shù)是一種確認(rèn) — 如果您要求參數(shù)處于某種狀態(tài)，這將對使用方法的人很有幫助 — 但是您應(yīng)該檢查它們并拋出有意義的異常：
- 處理異常要盡量與出現(xiàn)的問題緊密相關(guān)。
- 專門處理每個異常。
希望對你有幫助，接下一篇，經(jīng)驗分享：PHP編程的5個良好習(xí)慣（三）
【編輯推薦】
- PHP新手 詳細(xì)介紹PHP代碼規(guī)范
- PHP中IIS7實現(xiàn)基本身份驗證的方法
- 分享PHP網(wǎng)站建設(shè)的流程與步驟
- PHP新手 學(xué)習(xí)基本語法
- PHP新手 學(xué)習(xí)變量和常量
標(biāo)題名稱：經(jīng)驗分享：PHP編程的5個良好習(xí)慣（二）
分享鏈接：http://www.5511xx.com/article/dpphjoj.html
