Стандарт оформления PHP-кода

Глава 1. Почему стандартизация кода так важна

Стандарты нужны уже потому, что одинаково достают всех и таким образом, эти все чувствуют себя командой. Все предложенное ниже использовалось многими компаниями во множестве проектов, и споры по этим правилам длились буквально недели. Предлагаемый стиль не является чьим-либо персональным стилем и, конечно, в стандартах допускаются частные дополнения.

Положительные моменты

Когда проект пытается принять тот или иной общепринятый стандарт, случаются следующие хорошие вещи:

  • программисты могут прочитать код и легко разобраться, что в нём происходит;

  • новые программисты быстрее вписываются в проект;

  • новые люди в PHP избавлены от необходимости разрабатывать свой персональный стиль и стоять насмерть, защищая его;

  • новые люди в PHP избавлены от "необходимости" допускать те же самые ошибки, которые всегда допускают новички;

  • в устойчивых системах люди делают меньше ошибок;

  • у программистов появляется общий враг :-)

Отрицательные моменты

Плохие вещи тоже случаются:

  • как правило, стандарты - это абсолютный хлам, поскольку разрабатывались людьми ничего не соображающими в PHP;

  • как правило, стандарты - это абсолютный хлам, поскольку это не то, что я хочу;

  • стандарты снижают креативность;

  • для состоявшихся программистов необходимость в стандартах исчезает;

  • стандарты насаждают слишком много структуры;

  • всё равно люди не следуют стандартам.

Обсуждение

Опыт многих проектов приводит нас к следующему заключению: с введением стандартов проект продвигается быстрее. Но тогда получается, что стандарты - залог успеха? Конечно, нет. Но они способствуют успеху, а нам нужно использовать все возможности! Будем честны с собой: большинство аргументов против того или иного стандарта исходит от нашего самолюбия. В хорошем стандарте редко случается найти ограничение, которое отрицательно сказалось бы на качестве проекта, в большинстве своём всё это - лишь дело вкуса. Итак, проявите больше гибкости, контролируйте своё самолюбие и помните, что проект продвигается единой командой, а не отдельными программистами.

--
Источник: http://tony2001.phpclub.net/doc/standard/index.html

Полистать здесь

Примечание: Так как навскидку переконвертировать файлы справочника из KOI8-R в UTF-8 не удалось, пришлось кинуть в папку файл .htaccess со строчкой "AddDefaultCharset KOI8-R" чтоб браузер переключался сам получив от сервера заголовок ответа (Response Header) со строчкой "Content-Type text/html; charset=KOI8-R".

Комментарии:

Вы можете использовать эти теги: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre lang="" line="" escaped="">

*Required Fields