Archive for the 'coding style' Tag

Стайлинг PHP

К вопросу о том, как нужно форматировать php. Есть много стилей, у каждого он свой, не то, чтобы неповторимый, но я решил показать стиль, которым пользуюсь.

Весь код должен состоять внутри полных тегов:

<?php[...]?>

И никак иначе.

Строковые литералы не содержащие интерполируемых значений должны состоять в одинарных ‘[...]‘ кавычках. Это правило напрямую перешло из Perl, где всё, что внутри одинарных кавычках вообще не интерполируется, в php, чтобы не возникало путанницы, это лишь рекомендация.

Переменные внутри литералов должны отделяться. К примеру в строке есть ситуация “Print $varand exit…”, всегда переменные нужно выделять фигурными скобками “Print {$var}and exit…”.

Конкатенация строк производится без пробелов - “string”.”string”.

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

Теперь о классах. Фигурная скобка открывающая внутреннюю часть класса должна находится строго под class, в начале строки. Отступ в классе - 2 таба или 4 пробела, зависит от настроек редактора. Все переменные определяем до того, как будут описаны функции.

If, while - структуры должны заполняться так же, как и классы, строго под if,while в начале новой строки.

Switch-структура должна описываться в следующем порядке:

switch ($var)
{
	case 1:
	{
		break;
	}
	case 2:
	{
		break;
	}
	default:
	{
		break;
	}
}

Если кого интересует документация к стилю php от Zend.