Finar.ru
web.finar.ru
video.finar.ru
Темы для BootstrapNew!

CodeStyle, или стандартизация подходов к написанию кода

наводим порядок в собственных головах

Автор: Филипп Казаков, дата: 2014-01-24, просмотров 4620
Тэги

тип: FAQ, темы: Веб-технологии

Многие умеют писать код, кое-кто даже пишет много кода каждый день; но большая часть создаваемого кода никуда не годится. А все дело в том, что программирование - это не решение конкретных практических задач, а умение видеть задачу в целом, смотреть на несколько шагов вперед, и, конечно, восхищаться совершенством, красотой и универсальностью того, что создаешь. Программирование, применяемое для взаимодействия с абсолютно точными машинами, не терпит отсутствия самоорганизации: человек, терпящий дисгармонию и суету внутри себя, скорее всего не сможет стать хорошим программистом.

В фундаменте знания всегда заложены одинаковые принципы. Верстка, программирование, видеомонтаж и планетология - такие разные вещи, а способы познания схожие. Вот например, в статье Что вам не кругло?  очень понятно изложены проблемы современной планетологии. И эти проблемы чем-то очень напоминают вопросы с именованием функций, переменных и классов в программировании.

Filosoff представляет свой взгляд на CodeStyle, сформированный на базе личного опыта и различных открытых источников. Смотрите:




Finar — 2014-01-24, 12:23

Два вопроса к автору:

1) Не используйте "магические числа" - числа, значения которых неочевидны.

Объясните, пожалуйста, смысл ( $action == self::CROP ) в контексте приведенного примера.

2) Не используйте в коде символ подчеркивания.

Просьба пояснить эту рекомендацию.

Finar,

  1. Смысл в том, чтобы использовать константы с говорящими именами. Т.к. в условиях мы будем сравнивать нечто не с абстрактной цифрой, которая ясна только разработчику, а с константой. Пример в публикации... (self::CROP - это константа класса http://php.net/manual/ru/language.oop5.constants.php )
  2. Не совсем понял, что именно пояснить. Я не рекоммендую использовать подчеркивание, кроме неких "исключений" (например, имя константы). Используем camelCase и радуемся : )
taurus — 2014-01-24, 12:27

В Хроме примеры не разворачиваются.

Это временный косяк-с был, fixed.

AlexeyG — 2014-01-24, 12:53

Я бы к пункту про транслит еще бы добавил, следить за правописанием. А то вот прям вчера встретил прекрасную переменную $lenght.

А в хроме все прекрасно разворачивается.

Полностью согласен.

Оставить комментарий 


Ваше имя:
->