Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 В этом уроке мы узнаем, что такое стандарты по написанию кода. Они облегчают разработку и делают код более понятным. Мы подробнее разберем две основные рекомендации по PHP, которые содержат правила по написанию кода.

2 Код нужно оформлять так, чтобы он был понятным и простым в поддержке. Для этого существуют специальные наборы правил -стандарты. Они описывают различные аспекты написания кода.

3 В PHP самыми распространенными являются стандартыPSR- PHP Standards Recommendations или стандартные рекомендации PHP от<a>PHP-FIG</a>. Это набор правил, которые облегчают разработку и решают определенную проблему.

4 На текущий момент существует несколько утвержденных рекомендаций, каждая из них обозначена цифрой: PSR-1, PSR-2, PSR-3 и<a>другие</a>. Со всеми рекомендациями вы познакомитесь во время обучения и работы. В этом уроке разберем подробнее следующие:

5 <ul><li>PSR-1.<a>Basic Coding Standard</a>- базовый стандарт написания кода. Это набор правил, которые определяют, как следует оформлять программный код: как писать теги PHP, по каким правилам именовать классы, методы и константы классов. Он также затрагивает вопросы кодировки, автозагрузки, пространства имен и разделения ответственности между файлами</li>

6 <li>PSR-12.<a>Extended Coding Style</a>- расширенный стандарт стиля кодирования, заменяет и дополняет устаревший PSR-2. Этот стандарт требует выполнения правил PSR-1. Также он добавляет множество новых требований: к отступам, файлам, строкам, ключевым словам, классам, управляющим конструкциям, области видимости и другим элементам</li>

7 </ul><h2>Линтеры в PHP</h2>

8 В любом языке программирования существуют специальные инструменты -линтеры. Они проверяют код на соответствие стандартам. Повсеместно используемым линтером в PHP является<a>PHP_CodeSniffer</a>.

9 Допустим, у нас есть файл с таким PHP-кодом:

10 При проверке файла линтер найдет следующие ошибки:

11 <ul><li>Spaces must be used to indent lines; tabs are not allowed - PSR-12 рекомендует делать отступ размером в четыре пробела, а в примере выше использована табуляция</li>

12 <li>A closing tag is not permitted at the end of a PHP file - стандарт содержит требование опускать завершающий тег ?></li>

13 <li>Space before opening parenthesis of function call prohibited - при вызове функции между именем функции и круглыми скобками не должно быть пробельных символов, а в проверяемом коде после имени print_r стоит один пробел</li>

14 </ul>Исправим код - уберем закрывающий тег, отступы и пробел после имени функции:

15 Этот вариант уже не нарушает правил, и линтер будет "молчать".

16 <h2>Выводы</h2>

17 В этом уроке мы разобрали стандарты по написанию кода в PHP: PSR-1 и PSR-12. Не стоит пугаться большого количества рекомендаций и правил. Зачастую они простые и понятные и их можно интуитивно придерживаться в коде. К остальным можно привыкнуть с опытом.