項目設計方法簽名仔細

仔細選擇方法名稱：

• 名稱必須遵循約定（第 68 條）。
• 優先考慮易於理解且與套件和普遍共識一致的名稱。
• 避免長名。

不要用方便的方法誇大：

• 每種方法都必須「完成自己的部分工作」。
• 許多方法使得 API 的使用、維護和文件化變得困難。
• 僅在經常使用時提供縮寫方法。

避免長參數清單：

• 限制為四個或更少的參數。
• 長列表很難記住且容易出錯。
• 相同類型的參數依序排列可能會造成混亂。

減少長參數清單的三個技巧：

• 將方法分成幾個較小的方法。
• 為參數組建立輔助類別。
• 對具有許多參數的方法使用建構器模式，尤其是可選參數。

在參數中優先選擇介面而不是類別：

• 使用 Map 等介面而不是 HashMap 等特定類別以獲得更大的靈活性。

在參數中喜歡枚舉而不是布林值：

• 枚舉使程式碼更具可讀性，並有助於將來擴展選項，例如帶有溫標的溫度計的範例。
• 這些實踐有助於創建更易於使用且不易出錯的 API。

以上是項目設計方法簽名仔細的詳細內容。更多資訊請關注PHP中文網其他相關文章！