WORDPRESS编码标准:简介

我们经常谈到在创建WordPress产品时编写高质量代码的重要性。然而,这不仅仅是关于职业精神和自豪感。实际上,任何网站都可能因代码质量差而破坏,这可能严重损害您的专业地位。

幸运的是,“质量”的含义已被提炼成WordPress编码标准。这些将帮助您确保您的代码达到标准,并为您提供在处理重要项目时要遵循的各种路线图。

在这篇文章中,我们将更详细地介绍WordPress编码标准。我们还将介绍标准的GitHub版本,并解释为什么您可能希望将它们用作您的首选资源。但是,在此之前,让我们谈谈代码质量!

关于如何高质量代码的快速(和友好)讲座

我们愿意打赌你是一个对自己所做的事感到无比自豪的人。至少,如果你称自己为开发人员,那么你就是一个聪明人。你可能拥有神秘的连帽衫,牛仔裤,以及手头上无数的其它新奇玩意儿,但是你能说你的编码质量达到了与你的野心相匹配的程度吗?

现实情况是,无论你身在何处,都会有一些改进。简而言之,你尝试提供的最佳代码通常会带有以下目标:

  1. 你是否能识别(或已识别)代码中某些不符合标准的方面。
  2. 通过一段时间的学习和实施,您是否可以提高自己的能力。
  3. 您是否可以确定另一个可以改进的领域。

想象一下钟形曲线,你的最差技能画在左边,你最好的画在右边。你应该不断地向左看,并选择编码中最不稳定的元素来进行工作。

这将使整个钟形曲线向右移动,并导致其他方面成为新的“最差”。这种做法被称为“Inchworm”技术  ,是一种不断发展自己能力的纪律方式。最好的消息是WordPress开发人员在实现这种技术时具有优势。

WordPress有措施让你接受强有力的编码实践

努力发展你的劣势是一个崇高的目标,一路上的帮助永远是受欢迎的。当然,WordPress的核心开发人员在确保社区在为平台创建时具有学习曲线方面的考虑。如果WordPress难以编码,那么几乎不会被很多开发人员采用。

对于初学者,请考虑WordPress本身是如何编码的。它实际上是由钩子缝合在一起的,这意味着你可以在每个项目中实现基本功能,而不会引入任何深奥的问题。您还可以看到这种开发人员友好的立场,即  如何使用模板拼凑布局,甚至是每个PHP文件中包含的综合注释。

事实上,WordPress在这个领域拥有如此可靠的声誉,常规用户经常破解代码编辑器并修改他们自己网站的后端。还有  官方的Codex,其中充满了关于如何在WordPress中实现任何内容的参考资料。

对于开发人员来说,也许唯一需要确保代码高质量(并将潜在问题保持在最低限度)的文档 – 是官方编码标准。

介绍WordPress的官方编码标准

该核心贡献者手册提供了大量消化WordPress的核心开发的问题。而且,它还包含官方编码标准,这是我们将在此重点关注的内容。

正如您可能已经收集的那样,这些标准包含  将代码提交到WordPress核心准则。虽然我们已经讨论了为什么它们不一定适用于主题和插件开发,但它们在这些情况下仍然会有所帮助。

简而言之,您将使用官方标准编写验证的代码,并且不会引入任何基本错误。让我们快速快速浏览每一组:

  • PHP 与缩进,大括号样式,格式化SQL语句等相关的大量标准集可以说是WordPress用户最重要的集合。
  • HTML 鉴于复杂性相对降低,HTML的条目少于其他语言。即便如此,此处还会显示缩进和自闭标签等重要元素。
  • CSS 在PHP旁边,CSS是最重要的样式语言。虽然有比一般元素更通用的指令,但在这个集合中有很多东西要看。
  • JavaScript 由于其在WordPress中的初出茅庐实现,JavaScript在这里是所有编码标准中最密集的,这是可以理解的。事实上,你可以认为这是PHP编码标准的一面镜子,特别是随着它在线上的突出地增长。

一旦你花了一点时间与它们,你会发现,即使是最全面的这些标准仍然容易消化。这是个好消息,因为这意味着你可以在不涉及大量指令的情况下实施它们。

寻找最新版本的编码标准(并确保您坚持使用)

在我们完成之前,我们想让您了解GitHub – 特别是WordPress编码标准页面。这类似于制作WordPress的标准,但是有一些新增代表当前更改,这些更改未在官方网站上列出。

我们认为,这使得GitHub版本成为事实上的官方编码标准。版本1.0于2018年7月发布,并且有一个关键区别 – 它本质上是PHP_CodeSniffer规则(或“嗅探”)的集合。如果您不熟悉此工具,它会对您的PHP,CSS和JavaScript进行标记,并检测代码与标准之间的任何差异或违规。

如果您遵循核心贡献的标准(如您所愿),利用这些嗅探实际上是必不可少的。我们建议您阅读GitHub文档  并选择首选安装方法。然后,您可以利用一些可用的额外嗅探,例如内联文档的嗅探,您将可以访问核心标准中未包含的一些最佳实践。

结论

我们可以使用一个low的程序员范例来描述你应该如何处理编码的每个方面:“垃圾输入,垃圾输出。”最终,如果你的代码质量低于一流,就是对自己和你的用户的一种伤害。

幸运的是,WordPress 有一套记录在案的标准,任何开发人员都可以遵循这些标准,以确保他们的代码值得被包含。遵循这些标准,您只需保证专门的审核小组批准您的提交。这为您开始下一个项目提供了先机。

说点什么

500