From In-Portal Developers Guide

Current revision

Стандарты в программировании
Статьи в этой категории
Форматирование PHP файлов Назначение имён Стиль программирования Правила хорошего тона Сопутствующая документация

Плохие программисты получаются из тех, которые не хотят следовать традициям в программировании.

Все эти правила хорошего тона (на первый взгляд ненужные) на самом деле очень полезные вещи и складывались на опыте предыдущих "поколений" и на их ошибках. Например, правило хорошего тона: писать все константы заглавными буквами (напр. CONSTANT_SET_VALUES).

• называть константы заглавными буквами;
• использовать именованные константы вместо магических чисел (напр. STATUS_ACTIVE);
• объявлять переменные перед использованием;
• говорящие названия переменных (атрибутов, классов, методов, названий полей в базе и т.п.);
• данные в dropdown полях сортировать в алфавитном порядке;
• никогда не верить данным пользователя (never trust user data), т.е. всегда экранировать данные из форм.

Но это все приходит со временем. Никто не сможет подряд все перечислить, это находится где-то на уровне подсознания. И когда уже начинаешь хорошо разбираться в каком-либо конкретном методе, тогда то и начинаешь проглядывать там некую закономерность в стиле или синтаксисе написания, особенно когда сравниваешь работы разных программистов. Вроде все по-разному, но где-то похоже. :)

Примеры

foreach ($fields as $f) {
	...
}

foreach ($fields as $field) {
	...
}

if ($cond == 'and') {
	return 1;
}
else 
	return '';

if ($cond == 'and') {
	return 1;
}
else {
	return '';
}