PHP Kodlama Standardlari (Ucuncu Bolum) - Geniş Kapsamlı Doküman ve Makale Sitesi

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
Bu yazi serimiz bir sure daha ayni sekilde devam edecektir.

Oktay Altunergil oktay@turk-php.com http:/www.turk-php.com
Referans: http://utvikler.start.no/code/php_coding_standard.html

Bu makale hakkında ek bilgi eklemek için buraya tıklayınız

Bu makalenin yazar yada kaynağını bildirmek için tıklayınız.

Kullanıcı Yorumları

İlgili Dökümanlar