Sayfalar

PHP Kodlama Standartları - 3


Fonksiyonlardan Alinan Hatalari Kontrol Politikasi:

Hatalari kaale almamak istediginizden emin oldugunuz durumlar disinda butun sistem ve fonksiyon cagrilarini hatalar icin kontrol ediniz.

Butun sistem hatalari icin sistem hata mesaji metnini de aliniz.

Baglama Isareti {} Politikasi

Sikca kullanilan 3 cesit baglama isareti kullanim tarzindan ilk ikisi gecerli olmasina ragmen mumkun oldukca ilk tarz kullanilmalidir.

Baglama isaretini ifadenin altina ve ifade ile ayni hizaya getir. (Allman stili de denir)

if($kosul)
{
...
}
while($kosul)
{
...
}


Geleneksel Unix tarzi olan acilis baglama isaretinin ifade ile ayni satirda kullanilmasi. (K&R stili de denir)

if($kosul){
...
}
while($kosul){
...
}

Aciklama

Hangi baglama isareti tarzinin kullanilacagi ancak taviz verilerek cozulebilecek bir sorun. Her iki tarz da kabul edilebilir olsa da cogu kisi ilk kullanis seklini daha uygun bulmaktadir.

Ilk tarz baglama isaretinin nerede acilip nerede kapandigini kolayca gorebilmek icin cok kullanislidir. Ayrica vi gibi bazi editorlerde baglama isareti esleme fonksiyonunu kullanmak icin satirin sonuna kadar gidip esleme tusuna basma zorunlulugundan kurtarip sadece satir satir asagi giderek esleme fonksiyonunu kullanmayi kolaylastirmaktadir.

Ikinci tarzi kullananlar genelde bir ekrana daha fazla kod sigdirma avantajindan yararlanmak isteyenlerdir.

Satir Basi, TAB ve Bosluk Politikasi

Satir basini her seviyede 3,4 bosluk olarak kullanin.
TAB yerine bosluk kullanin. Bir cok editor TAB'i bosluk karakterlerinden olusan bir duruma getirebilmektedir.
Gerektigi kadar satir basi birakin..daha fazla degil. Ust uste tekrarlanan satir baslari konusunda bir ust sinir olmasa da eger 4,5 seviyeden fazla satir basi biraktiysaniz kodunuzu tekrar gozden gecirin.

Aciklama

Herkes TAB icin farkli degerler kullandigi icin TAB kullanilmis bir kodu baska bir ortamda okumak veya yaziciyla basmak cok zorlasmaktadir. Bu yuzden farkli ortamlarda degisiklik gostermeyecek olan bosluk karakteri kullanilmalidir.
Bosluk sayisi hakkinda herkesin kabul ettigi bir standard yoktur. Tutarli ve surekli ayni sayida bosluk kullanilmasi yeterlidir. Bununla birlikte genelde 3,4 bosluk uygun gorulmektedir.
Her ne kadar satir basi seviyesi sayisini sinirlamak isteseniz de pratikte bu icinden cikilamayacak bir sinirlamadir. Bu yuzden ne kadar ic ice yerlestirilmis kod bloklari yazacaklari konusunda programcilarin kendi dusuncelerine guvenmek gerekmektedir.

Ornek

function fonksiyon()
{
if (ilk kosul)
{
if (baska bir kosul)
{
while (daha da fazla kosullar)
{
}
}
}
}

Not: (Makale sistemindeki sinirlamadan dolayi yukaridaki kod istendigi gibi gosterilememektedir. Normalde her kod blogu kendisini kapsayan bloga gore 3,4 bosluk kadar iceriden baslamaktadir)

Parantezlerin () Anahtar Kelime ve Fonksiyonlarla Kullanim Politikasi

Parantezi Anahtar Kelimenin hemen yanina koymayip arada bir bosluk birakiniz.
Parantezi Fonksiyon Isimlerinin hemen yanina koyunuz.
Fonksiyonlarin RETURN ifadelerinde gereksiz yere parantez kullanmayiniz.

Aciklama

Anahtar Kelimeler fonksiyon degildir. Bunlarin hemen yanina parantez koymak fonksiyonlarla karistirilmasina sebep olmaktadir.

Ornek

if (kosul) # bosluk var
{
}
while (kosul)
{
}
strcmp($s, $s1); # bosluk yok
return 1; # parantez yok