26 Глава 1 Стили кодирования

Многие редакторы поддерживают автоопределение форматирования, основанное на магических" комментариях в исходном коде. Например, приведенный ниже комментарии автоматически настраивает редактор vim на использование мягкой табуляции (параметр expandtab) и устанавливает ее ширину равную четырем пробелам (параметры tabstop и sof ttabstop)

// vim: expandtab softtabstop=2 tabstop=2 shiftwidth=2

В дополнение к этому vim команда : retab преобразовывает всю жесткую табуляцию текущего документа в мягкую, поэтому данную команду следует использовать если необходимо переключить документ с использования символов табуляции на использование пробелов.

В emacs тот же эффект достигается с помощью следующего комментария.

/*

* Local variables:

* tab-width: 2

* c-feasic-offset: 2

* indent-tabs-mode: nil

* End:

V

Во многих крупных проектах (включая сам язык РНР) комментарии таких типов помещаются в начало каждого файла, т.е. сразу видно, что разработчики данного проекта придерживаются описанных правил введения отступов.

Длина строки

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

if($month == 'September' || $month == 'april' I I $month == 'June' || $month == 'november') { return 30;

}

Можно ввести отступ во второй строке, чтобы обозначить ее связь с первой Для особенно длинных строк можно вводить отступы и выравнивать каждое условие.

if($month == 'September' || $month == 'april' || $month == 'june' || $month == 'november')

{

return 30;

}

Данная методика подходит и для параметров функций:

mail("postmaster@example.foo", "My Subject", $message_body,

"From: George Schlossnagle <george@omniti.com>\r\n");