项目设计方法签名仔细

仔细选择方法名称：

• 名称必须遵循约定（第 68 条）。
• 优先考虑易于理解且与包和普遍共识一致的名称。
• 避免长名称。

不要用方便的方法夸大：

• 每种方法都必须“完成自己的部分工作”。
• 许多方法使得 API 的使用、维护和文档化变得困难。
• 仅在经常使用时提供缩写方法。

避免长参数列表：

• 限制为四个或更少的参数。
• 长列表很难记住并且容易出错。
• 相同类型的参数按顺序排列可能会造成混乱。

减少长参数列表的三种技巧：

• 将方法分成几个更小的方法。
• 为参数组创建辅助类。
• 对具有许多参数的方法使用构建器模式，尤其是可选参数。

在参数中优先选择接口而不是类：

• 使用 Map 等接口而不是 HashMap 等特定类以获得更大的灵活性。

在参数中更喜欢枚举而不是布尔值：

• 枚举使代码更具可读性，并有助于将来扩展选项，如带有温标的温度计的示例。
• 这些实践有助于创建更易于使用且不易出错的 API。

以上是项目设计方法签名仔细的详细内容。更多信息请关注PHP中文网其他相关文章！