Стандарт за писане на код в PHP

PHP » PHP

thelordofweb   трудност:    видян: 38823

Изравняване на блокове при декларация

• Блока с декларациите трябва да бъде подравнен.
• Така ще ни бъде по-ясен.
• Подобните блокове на инициализацията на променливите трябваше да бъдат табулирани.
• ‘&” знака трябва да бъде в близост до типа, а не до името на променливата.

Пример :

	   var       $mDate

	   var&      $mrDate

	   var&      $mrName

	   var       $mName

	   $mDate    = 0;

	   $mrDate   = NULL;

	   $mrName   = 0;

	   $mName    = NULL;

По един израз на ред

Трябва да има само по един израз на ред освен ако изразите са много внимателно свързани.

Документирайте празните изрази

Винаги документирайте празното тяло при for или while изразите така, че да ни е ясно кое и защо е празно, и че сме допуснали умишлено липсата на кода , а не е отсъстващ.

Пример:

	while ($dest++ = $src++)

	      ;         // празен

Не използвайте подразбиращата се проверка при if за нула

	   if (FAIL != f())

е по-добро от

	   if (f())

Тестът дали е нула или не, е често се използва по подразбиране от функции или изрази, които удовлетворяват следващите ограничения :

• Връща нула, което е подобно на неистина
• Изразителното наименуване подсказва какво да очакваме(истина/неистина). Затова ще използваме IsValid(), а не CheckValid().

Булеви типове

Не проверявайте булевите стойност за равенство с 1 (истина, ДА, и т.н.); вместо това тествайте за неравенство с 0 (неистина, НЕ, и т.н.). По-вероятно е повечето функции да връщат 0, ако не е изпълнено условието.

	   if (TRUE == func()) { ...

трябва да бъдете в този вид

   if (FALSE != func()) { ...

Избягвайте вградени присвоявания

Има време и място за вградени присвоявания. В някои концепции има по-добър начин да се постигат резултати без да правим кодът обемист и по-малко четим.

	   while ($a != ($c = getchar()))

	   {

	      преработваме знаците

	   }

Операторите ++ и -- ще повлияят върху броя на изразите. Което довежда до по-добри резултати във времето за изпълнение на скрипта, но ще намалим възможността за лесна поддръжка.

Пример:

	   $a = $b + $c;

	   $d = $a + $r;

	Няма нужда да се замени с 

	   $d = ($a = $b + $c) + $r;

Въпреки това последния израз може да спести един цикъл. В крайна сметка разликата във времето за изпълнение ще се намали, докато разликата в лесната поддръжката ще нарасне в случаите, когато човешкият спомен, какво се е случило в последното парче код започва да избледнява.