最小惊讶原则(POLA)
知识点掌握了,还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战,手把手教大家学习《最小惊讶原则(POLA)》,在实现功能的过程中也带大家重新温习相关知识点,温故而知新,回头看看说不定又有不一样的感悟!
关键概念
1. 一致的方法命名
// bad - inconsistent naming class usermanager { public function getuser($id) { /* ... */ } public function fetchrole($id) { /* ... */ } public function retrievepermissions($id) { /* ... */ } } // good - consistent naming pattern class usermanager { public function getuser($id) { /* ... */ } public function getrole($id) { /* ... */ } public function getpermissions($id) { /* ... */ } }
命名方法时,一致性至关重要。在这个糟糕的例子中,我们使用三个不同的动词(get、fetch、retrieve)来执行类似的操作。这迫使开发人员记住同一类型操作的不同术语。好的示例在所有方法中一致地使用“get”,使 api 更可预测且更容易记住。当开发人员需要访问数据时,他们会直观地知道寻找以“get”开头的方法。
2. 预期回报类型
// bad - unexpected return types class filehandler { public function readfile($path) { if (!file_exists($path)) { return false; // unexpected boolean } return file_get_contents($path); } } // good - consistent return types with exceptions class filehandler { public function readfile($path): string { if (!file_exists($path)) { throw new filenotfoundexception("file not found: {$path}"); } return file_get_contents($path); } }
这个糟糕的例子混合了返回类型 - 有时返回字符串(文件内容),有时返回布尔值(false)。这给如何处理返回值带来了不确定性。这个很好的例子通过声明字符串返回类型并使用错误情况的异常来确保类型安全。这与 php 的内置行为相匹配,并使错误处理更加明确和可预测。
3. 可预测的参数顺序
// bad - inconsistent parameter order class orderprocessor { public function createorder($items, $userid, $date) { /* ... */ } public function updateorder($date, $orderid, $items) { /* ... */ } } // good - consistent parameter order class orderprocessor { public function createorder($userid, $items, $date) { /* ... */ } public function updateorder($orderid, $items, $date) { /* ... */ } }
相似方法中的参数顺序应该保持一致。糟糕的示例将相似的参数放在不同的位置,使 api 变得混乱。好的示例保持了逻辑顺序:首先是标识符(userid/orderid),然后是主要数据(项目),最后是可选/元数据参数(日期)。这种模式符合 php 框架中的常见约定,并使 api 更加直观。
4. 清晰的方法行为
// bad - ambiguous behavior class cart { public function add($product) { // sometimes creates new item, sometimes updates quantity // unpredictable! } } // good - clear, single responsibility class cart { public function addnewitem($product) { /* ... */ } public function updatequantity($productid, $quantity) { /* ... */ } }
方法应该有明确、单一的职责。坏例子的“add”方法不明确 - 它可能会添加一个新项目或更新一个现有项目。这个很好的例子将其分为两个不同的方法,具有明确的名称和目的。这使得代码的行为可预测,并遵循单一职责原则 (srp)。
5. 一致的错误处理
class PaymentProcessor { public function processPayment(float $amount): PaymentResult { try { // Process payment return new PaymentResult(true, 'Payment successful'); } catch (PaymentException $e) { // Always handle errors the same way throw new PaymentFailedException($e->getMessage()); } } }
此示例演示了通过异常进行一致的错误处理。当出现问题时,它总是抛出特定的异常类型(paymentfailedexception),而不是返回不同的类型或使用错误代码。这为整个应用程序的错误处理创建了一个可预测的模式。该方法还为成功案例使用专用的 paymentresult 对象,保持类型一致性。
这些实践中的每一种都有助于使代码更易于维护、更易于理解且不易出现错误,因为它的行为方式是开发人员基于 php 开发中的常见模式和约定所期望的方式。
以上就是本文的全部内容了,是否有顺利帮助你解决问题?若是能给你带来学习上的帮助,请大家多多支持golang学习网!更多关于文章的相关知识,也可关注golang学习网公众号。

- 上一篇
- 康希通信参加上交所专题培训,深化并购重组政策理解

- 下一篇
- Typecho中如何判断getDescription()返回值是否为空?
-
- 文章 · php教程 | 1天前 |
- PHPCMS与织梦CMS移动端适配对比分析
- 220浏览 收藏
-
- 文章 · php教程 | 1天前 |
- PHP读取IP文件实现访问控制教程
- 480浏览 收藏
-
- 文章 · php教程 | 1天前 |
- PHP函数定义与调用全解析
- 242浏览 收藏
-
- 文章 · php教程 | 1天前 |
- PHP验证手机号正则表达式教程
- 426浏览 收藏
-
- 文章 · php教程 | 1天前 |
- Symfony中MongoDB转数组的实用方法
- 300浏览 收藏
-
- 文章 · php教程 | 1天前 |
- WooCommerce分类筛选问题解决方法
- 198浏览 收藏
-
- 文章 · php教程 | 1天前 |
- PHP图片处理进阶:GD库实战教程
- 386浏览 收藏
-
- 文章 · php教程 | 1天前 |
- RESTfulAPI开发:PHP接口设计全解析
- 117浏览 收藏
-
- 文章 · php教程 | 1天前 |
- Twilio语音通话保持与恢复方法
- 213浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 511次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 498次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 484次学习
-
- 千音漫语
- 千音漫语,北京熠声科技倾力打造的智能声音创作助手,提供AI配音、音视频翻译、语音识别、声音克隆等强大功能,助力有声书制作、视频创作、教育培训等领域,官网:https://qianyin123.com
- 142次使用
-
- MiniWork
- MiniWork是一款智能高效的AI工具平台,专为提升工作与学习效率而设计。整合文本处理、图像生成、营销策划及运营管理等多元AI工具,提供精准智能解决方案,让复杂工作简单高效。
- 135次使用
-
- NoCode
- NoCode (nocode.cn)是领先的无代码开发平台,通过拖放、AI对话等简单操作,助您快速创建各类应用、网站与管理系统。无需编程知识,轻松实现个人生活、商业经营、企业管理多场景需求,大幅降低开发门槛,高效低成本。
- 151次使用
-
- 达医智影
- 达医智影,阿里巴巴达摩院医疗AI创新力作。全球率先利用平扫CT实现“一扫多筛”,仅一次CT扫描即可高效识别多种癌症、急症及慢病,为疾病早期发现提供智能、精准的AI影像早筛解决方案。
- 143次使用
-
- 智慧芽Eureka
- 智慧芽Eureka,专为技术创新打造的AI Agent平台。深度理解专利、研发、生物医药、材料、科创等复杂场景,通过专家级AI Agent精准执行任务,智能化工作流解放70%生产力,让您专注核心创新。
- 151次使用
-
- PHP技术的高薪回报与发展前景
- 2023-10-08 501浏览
-
- 基于 PHP 的商场优惠券系统开发中的常见问题解决方案
- 2023-10-05 501浏览
-
- 如何使用PHP开发简单的在线支付功能
- 2023-09-27 501浏览
-
- PHP消息队列开发指南:实现分布式缓存刷新器
- 2023-09-30 501浏览
-
- 如何在PHP微服务中实现分布式任务分配和调度
- 2023-10-04 501浏览