官术网_书友最值得收藏!

Coding standards

Coding standards are a result of conventions designed to produce high-quality code. Adopting certain standards yields better code quality, reduces the time taken to develop, and minimizes maintenance cost. Following coding standards requires knowing the standards in question and meticulously applying it to every aspect of the code that we write.

There are several coding standards that Magento abides by, such as the following ones:

  • The code demarcation standard
  • The PHP coding standard
  • The JavaScript coding standard
  • The jQuery widget coding standard
  • The DocBlock standard
  • JavaScript DocBlock standard
  • The LESS coding standard

The code demarcation standard speaks of decoupling HTML, CSS, and JS from PHP classes. By doing so, the backend-related development stays unaffected by frontend development and vice versa. This means that we can make business logic changes without fearing a broken frontend.

The PHP coding standard refers to PSR-1: Basic Coding Standard and PSR-2: Coding Style Guide that are described at on PHP filenames, class names, namespaces, class constant, properties, and methods. PSR-2 extends the PSR-1 by touching upon the actual inners of a class, such as spaces, braces, method and properties visibility, control structures, and so on.

The JavaScript coding standard is based on the Google JavaScript Style Guide found at https://google.github.io/styleguide/javascriptguide.xml. This coding standard touches on the JavaScript language and coding style rules. It is a lot like PSR-1 and PSR-2 for PHP.

The jQuery widget coding standard is flagged as mandatory for Magento core developers and recommended for third-party developers. It goes without saying how important jQuery UI widgets are in Magento. The standard describes several things, such as widget naming, instantiation, extension, DOM event bubbling, and so on.

The DocBlock standard touches on the requirements and conventions for the addition of inline code documentation. The idea is to unify the usage of code DocBlocks for all files regardless of the programming language in use. However, a DocBlock standard for that particular language may override it.

The JavaScript DocBlock standard relates to the JavaScript code files and their inline documentation. It is a subset of Google JavaScript Style Guide and JSDoc, which can be found at http://usejsdoc.org.

The LESS coding standard defines the formatting and coding style when working with LESS and CSS files.

Note

You can read more about the actual details of each standard at http://devdocs.magento.com, as they are too extensive to be covered in this book.

主站蜘蛛池模板: 大悟县| 宁乡县| 伊春市| 金堂县| 壤塘县| 巫山县| 扶余县| 密云县| 抚松县| 佛学| 钟山县| 东山县| 昌宁县| 廊坊市| 揭东县| 德惠市| 广饶县| 罗江县| 外汇| 邢台县| 闸北区| 襄汾县| 故城县| 阜平县| 饶阳县| 盘山县| 稷山县| 唐山市| 绵竹市| 禹州市| 娱乐| 宕昌县| 拉孜县| 郑州市| 太康县| 叶城县| 桂林市| 牙克石市| 海兴县| 邹平县| 平果县|