最小惊讶原则（POLA）

关键概念

1. 一致的方法命名

命名方法时，一致性至关重要。在这个糟糕的例子中，我们使用三个不同的动词（get、fetch、retrieve）来执行类似的操作。这迫使开发人员记住同一类型操作的不同术语。好的示例在所有方法中一致地使用“get”，使 API 更可预测且更容易记住。当开发人员需要访问数据时，他们会直观地知道寻找以“get”开头的方法。

2. 预期回报类型

这个坏例子混合了返回类型 - 有时返回字符串（文件内容），有时返回布尔值（false）。这给如何处理返回值带来了不确定性。这个很好的例子通过声明字符串返回类型并使用错误情况的异常来确保类型安全。这与 PHP 的内置行为相匹配，并使错误处理更加明确和可预测。

3. 可预测的参数顺序

相似方法中的参数顺序应该保持一致。这个糟糕的例子将相似的参数放在不同的位置，使 API 变得混乱。好的示例保持了逻辑顺序：首先是标识符（userId/orderId），然后是主要数据（项目），最后是可选/元数据参数（日期）。这种模式符合 PHP 框架中的常见约定，并使 API 更加直观。

4. 清晰的方法行为

方法应该有明确、单一的职责。坏例子的“add”方法不明确 - 它可能会添加一个新项目或更新一个现有项目。这个很好的例子将其分为两个不同的方法，具有明确的名称和目的。这使得代码的行为可预测，并遵循单一职责原则 (SRP)。

5. 一致的错误处理

此示例演示了通过异常进行一致的错误处理。当出现问题时，它总是抛出特定的异常类型（PaymentFailedException），而不是返回不同的类型或使用错误代码。这为整个应用程序的错误处理创建了一个可预测的模式。该方法还为成功案例使用专用的 PaymentResult 对象，保持类型一致性。

这些实践中的每一种都有助于使代码更易于维护、更易于理解且不易出现错误，因为它的行为方式是开发人员基于 PHP 开发中的常见模式和约定所期望的方式。

以上是最小惊讶原则（POLA）的详细内容。更多信息请关注PHP中文网其他相关文章！