the-documentation-compendium/ru/CODING_GUIDELINES.md

Гайдлайн по написанию кода

• Вы можете проверить, соответствует ли ваш код этому гайдлайну, запустив stuff/php-format.py validate
• Табуляция, без пробелов
• Конец строки должен быть в стиле Unix (\n), а не в стиле Windows (\r\n)
• Открывающие скобки находятся в той же строке, что и последний оператор.

    if (condition) {
        stuff;
    }

• Пробел между ключевыми словами и круглыми скобками для: if, else, while, switch, catch, function
• В вызовах функций нет пробела перед круглыми скобками
• В скобках нет пробелов
• Пробел после каждой запятой, но без пробела перед
• Все бинарные операторы должны иметь один пробел до и один после
• Не должно быть более одной непрерывной пустой строки
• Пустых комментариев быть не должно
• Вы не должны использовать блоки комментариев / * ... * /, только строку // ...
• Изменения в функциональности должны сопровождаться соответствующими новыми/ модифицированными тестами
• Исключения должны использоваться для сообщения об ошибочных состояниях. Использование функций, возвращающих true/false, разрешено, когда они являются ожидаемыми значениями
• При необходимости используйте [RAII] (http://en.wikipedia.org/wiki/Resource_Acquisition_Is_Initialization), в основном при администрировании ресурсов (файлов и т. д.)