Стандарт оформления 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».


Добавление комментария:

 css.php