不完整的元标签是不专业的

tl;dr：不完整或空元标记会破坏功能和用户体验。

问题

• 标签出现在输出中
• 电子邮件文本包含人类可读文本之间的占位符
• 丢失的占位符会让用户感到困惑
• 网站呈现奇怪的字符
• 空值会触发错误
• 潜在的安全注入漏洞

解决方案

1. 验证元标记
2. 尽早断言完整性
3. 快速失败
4. 避免空值
5. 抛出有意义的异常
6. 自动元验证

语境

当您留下未完成的元标记（例如 {user_name} 或 {product_name}）时，它们通常会潜入您的最终输出中。想象一下发送一封电子邮件，内容是：“您好 {user_name}，您的 {product_name} 订单已准备就绪。”

它让人尖叫不专业并且让用户感到困惑。

空值会导致崩溃或静默故障，从而导致糟糕的用户体验或进程中断，从而使情况变得更糟。

您可以通过在渲染或发送之前断言完整性来避免这种情况。

当您的代码发现不完整的元标记或空值时，立即停止进程并抛出异常。

示例代码

错误的

<?php

$emailbody = "hello {user_name}, 
your order for {product_name} is confirmed.";

// you forget to make the replacements
sendemail($emailbody);

正确的

<?php

$emailBody = "Hello {user_name},
your order for {product_name} is confirmed.";

if (strpos($emailBody, '{') !== false) {
    throw new Exception(
        "Incomplete meta tags found in email body.");
}
sendEmail($emailBody);

检测

[x] 自动

您可以通过自动化测试或短绒扫描未完成的占位符（{} 或类似模式）来检测这种气味。

标签

• 快速失败

等级

[x] 初学者

为什么双射很重要

在使用占位符表示用户数据时，您的系统必须维护一对一的映射。

如果您的 {user_name} 占位符存在但缺少相应的真实姓名，则您将破坏此映射。

这会导致错误、混乱以及对您的应用程序失去信任。

确保双射合规性可以避免这些问题。

人工智能一代

人工智能工具有时会在生成带有占位符的模板时引入这种气味，但无法替换真实数据。

在使用输出之前，您必须验证并完成所有占位符。

人工智能检测

如果您正确配置，诸如 linter 或电子邮件渲染验证器之类的 ai 工具可以检测未完成的元标记。

使用这些工具自动进行元标记检测并减少人为错误。

尝试一下！

记住：人工智能助手会犯很多错误

结论

不完整的元标记不仅仅是草率，而且是有害的。验证标签、断言完整性并在需要时引发异常。

仔细处理元标签可以防止错误并确保专业体验。

关系

代码气味 12 – 空

马克西·孔蒂耶里 ・2020 年 10 月 31 日

#codenewbie
＃教程
#哎呀

code smell 139 – 用户界面中的业务代码

马克西·孔蒂耶里 ・22 年 6 月 9 日

#哎呀
#webdev
#javascript
#初学者

code smell 97 – 没有同理心的错误消息

马克西·孔蒂耶里 ・2021 年 10 月 27 日

#开源
#ux
＃编程
#javascript

更多信息

快速失败

马克西·孔蒂耶里 ・2020 年 12 月 6 日

#codenewbie
＃编程
#webdev
#哎呀

空：十亿美元的错误

马克西·孔蒂耶里 ・ 十一月 18 ’20

#codenewbie
＃教程
＃编程
#webdev

免责声明

代码味道是我的观点。

制作人员

托马斯·马丁内斯 (tomas martinez) 在 unsplash 上拍摄的照片

最好的错误消息是永远不会出现的错误消息。

托马斯·福克斯

软件工程精彩名言

马克西·孔蒂耶里 ・ 2020 年 12 月 28 日

#codenewbie
＃编程
＃引号
＃软件

本文是 codesmell 系列的一部分。

如何查找代码中的臭部分

马克西·孔蒂耶里 ・ 21 年 5 月 21 日

#codenewbie
＃教程
#代码质量
#初学者

以上就是代码气味 – 未解析的元标签的详细内容，更多请关注php中文网其它相关文章！

https://www.php.cn/faq/1136654.html