Стиль кода

-= FaiweR =- 2010 M12 25
740
12
0
0

Какой стиль кода лучше? Там где я сейчас стажируюсь применяется первый... <?php // 1 стиль function someFunc( $param, $param2 ){ if( $param == 'some' ) { return true; } elseif( $param2 ==...

Какой стиль кода лучше? Там где я сейчас стажируюсь применяется первый...

  1. <?php
  2.  
  3. // 1 стиль
  4. function someFunc( $param, $param2 )
  5. {
  6. if( $param == 'some' )
  7. {
  8. return true;
  9. }
  10. elseif( $param2 == $param )
  11. {
  12. return 'ok';
  13. }
  14. }
  15.  
  16. // 2 стиль
  17. function someFunc( $param, $param2 ) {
  18. if ($param == 'some' )
  19. return true;
  20. elseif ($param2 == $param)
  21. return 'ok';
  22. }
  23.  
  24. // 3 стиль
  25. function someFunc($param, $param2){
  26. if ($param == 'some') return true;
  27. elseif ($param2 == $param) return 'ok';
  28. }
  29.  
  30.  
  31. ?>

Также интересует ваше мнение касательно комментирования кода. Нужно ли оно? И в каком виде? Меня пытаются отучить от этого дела, аргументируя это тем, что хватает нормального именования функций и переменных.

Оцените пост

-9

Комментарии

0
Для каждого языка есть свое соглашение. Не знаю, как в PHP, но в Java есть Code Convention. Придуман и написан он для того, чтобы код был понятен для всех программистов.
Ну а комментарии просто необходимы. Никакое нормальное название функции не сможет заменить пару строчек комментариев о том, для чего она предназначается. Отучивать от внесения комментариев в код - это вообще очень странно. Разве что ведется специальная документация, и в этой документации прописана каждая функция и переменная (опять же, аналог в java - JavaDoc'и).
-6
Документация не ведётся :)
0
Ну тогда без комментариев в дальнейшем даже самому разработчику будет сложно поддерживать/рефакторить код. А уж если это будет другой программист, то он не раз вас вспомнит "хорошими словами":)
0
Больше нравится 1-й стиль, хотя чаще использую 3-й. Коментарии необходимы даже для самого себя. Работаю 8 лет в одном месте, написанное забывается за год-два.
0
Я стал любить вариант 1, потому что так лучше видно, где находятся парные скобки. Ну то есть { и } на одном горизонтальном уровне.
Показать комментарии