IRC ve mIRC Kullanıcılarının Buluşma Noktası
  Mobil Sohbet, Sohbet ve Sohbet Odaları




Yeni Konu aç Cevapla
 
LinkBack Seçenekler Stil
Alt 03 Nisan 2012, 19:43   #1
Çevrimiçi
PEAR Kodlama standartları


-- Sponsor Baglantı --


PEAR Kodlama standartları PEAR’ın resmi web sitesinde açıklanmıştır. Bu açıklamaların bir kısmını Türkçeleştirip bu yazıda size sunmaya çalışacağım.

Satır uzunluğu ve girintiler
Yaklaşık olarak 75-85 karakter aralığında yeni satıra geçilmelidir.

Girintiler ise 4 karakter uzunluğunda ve boşluk karakteri ile oluşturulmalıdır. Girintiler ayarlanırken sekme (tab karakteri) kullanılmamalıdır. Kod yazdığınız düzenleyicinin ayarlarını sekme uzunluğu 4 karakter ve boşluktan oluşacak şekilde ayarlamanız tavsiye edilmektedir.

Kontrol İfadelerinin Yazılımı (IF, Switch)

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
if ((koşul1) || (koşul2)) { işlemler; } elseif ((koşul3) && (koşul4)) { diğer işlemler; } else { varsayılan işlemler; }


Kontrol ifadeleri (if, for, while, switch …) yazılırken anahtar kelime ile parantez arasında bir boşluk olmalı ve mantıksal sınamaların yazımında her bir mantıksal ifade parantez ile ayrılmalı. Bu kodun okunabilirliğini artırdığı gibi mantıksal hataları yakalamanızı da sağlayacaktır.

Diğer bir örnek (Swicth)

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
switch (koşul) { case 1: Eylem1; break; case 2: Eylem2; break; default: varsayılan eylem; break; }

İşlev Çağrılması
İşlev adı ile parantez arasında, ilk parametre ile parantez arasında ve son parametre ile parantez arasında boşluk olmamalı, parametreler birbirlerinden virgül ve boşluk karakteri ile ayrılmalı ve işlev tek bir satırda yazılıp noktalı virgül ile satır bitirilmelidir.

Örnek:

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
$var = foo($bar, $baz, $quux);


Eşittir işareti ile işlev adı arasında bir boşluk olmalıdır, ancak kod okunurluğunun arttırılmasını sağlamak için duruma göre değişken adı ile eşittir işareti arasındaki boşluk miktarı artırılabilir.



Kod:   Kodu kopyalamak için üzerine çift tıklayın!
$kisa = foo($bar); $uzun_degisken = foo($baz);


İşlev Tanımlama

İşlev tanımlamalarında kontrol ifadelerinden farklı olarak süslü parantez alt satırda yer alır.

Örnek:

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
unction ornekIslev($arg1, $arg2 = ”) { if (koşul) { Eylem; } return $val; }

Varsayılan değere sahip parametreler son sıralarda tanımlanmalıdır.

Biraz daha uzun bir örnek;

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
function connect(&$dsn, $persistent = false) { if (is_array($dsn)) { $dsninfo = &$dsn; } else { $dsninfo = DB:arseDSN($dsn); } if (!$dsninfo || !$dsninfo[’phptype’]) { return $this->raiseError(); } return true; }


Yorum Satırları

Yorum satırları phpDoc () standartına uygun yazılmalıdır.

Belge dışındaki yorum satırları standart C yorum satırları şeklinde olması tavsiye edilir (/* */ ve //) perl yorum satırı (#) benimsenmez.

Kod dahil etme (include, require)

Eğer bir sınıf (class) programa şarta bağlı olmaksızın dahil edilecekse require_once() kullanılmalıdır, ancak programın belli bir yerinde belli bir şarta bağlı olarak dahil edilmesi gerekiyorsa include_once() kullanılmalıdır.

Not: require_once() ve include_once() işlev değil ifadedir. Dolayısıyla eklenecek dosya adı parantez içerisinde yazılmaz.

Örnek;

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
require_once ‘PEAR.php’;


PHP etiketleri
PHP başlangıç ve bitiş etiketleri olarak <?php ?> kullanılmalı. Daha kısa olan <? ?> kullanılmamalıdır.
PEAR Kodlama standartları PEAR’ın resmi web sitesinde açıklanmıştır. Bu açıklamaların bir kısmını Türkçeleştirip bu yazıda size sunmaya çalışacağım.

Satır uzunluğu ve girintiler
Yaklaşık olarak 75-85 karakter aralığında yeni satıra geçilmelidir.

Girintiler ise 4 karakter uzunluğunda ve boşluk karakteri ile oluşturulmalıdır. Girintiler ayarlanırken sekme (tab karakteri) kullanılmamalıdır. Kod yazdığınız düzenleyicinin ayarlarını sekme uzunluğu 4 karakter ve boşluktan oluşacak şekilde ayarlamanız tavsiye edilmektedir.

Kontrol İfadelerinin Yazılımı (IF, Switch)

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
if ((koşul1) || (koşul2)) { işlemler; } elseif ((koşul3) && (koşul4)) { diğer işlemler; } else { varsayılan işlemler; }


Kontrol ifadeleri (if, for, while, switch …) yazılırken anahtar kelime ile parantez arasında bir boşluk olmalı ve mantıksal sınamaların yazımında her bir mantıksal ifade parantez ile ayrılmalı. Bu kodun okunabilirliğini artırdığı gibi mantıksal hataları yakalamanızı da sağlayacaktır.

Diğer bir örnek (Swicth)

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
switch (koşul) { case 1: Eylem1; break; case 2: Eylem2; break; default: varsayılan eylem; break; }

İşlev Çağrılması
İşlev adı ile parantez arasında, ilk parametre ile parantez arasında ve son parametre ile parantez arasında boşluk olmamalı, parametreler birbirlerinden virgül ve boşluk karakteri ile ayrılmalı ve işlev tek bir satırda yazılıp noktalı virgül ile satır bitirilmelidir.

Örnek:

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
$var = foo($bar, $baz, $quux);


Eşittir işareti ile işlev adı arasında bir boşluk olmalıdır, ancak kod okunurluğunun arttırılmasını sağlamak için duruma göre değişken adı ile eşittir işareti arasındaki boşluk miktarı artırılabilir.



Kod:   Kodu kopyalamak için üzerine çift tıklayın!
$kisa = foo($bar); $uzun_degisken = foo($baz);


İşlev Tanımlama

İşlev tanımlamalarında kontrol ifadelerinden farklı olarak süslü parantez alt satırda yer alır.

Örnek:

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
unction ornekIslev($arg1, $arg2 = ”) { if (koşul) { Eylem; } return $val; }

Varsayılan değere sahip parametreler son sıralarda tanımlanmalıdır.

Biraz daha uzun bir örnek;

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
function connect(&$dsn, $persistent = false) { if (is_array($dsn)) { $dsninfo = &$dsn; } else { $dsninfo = DB:arseDSN($dsn); } if (!$dsninfo || !$dsninfo[’phptype’]) { return $this->raiseError(); } return true; }


Yorum Satırları

Yorum satırları phpDoc () standartına uygun yazılmalıdır.

Belge dışındaki yorum satırları standart C yorum satırları şeklinde olması tavsiye edilir (/* */ ve //) perl yorum satırı (#) benimsenmez.

Kod dahil etme (include, require)

Eğer bir sınıf (class) programa şarta bağlı olmaksızın dahil edilecekse require_once() kullanılmalıdır, ancak programın belli bir yerinde belli bir şarta bağlı olarak dahil edilmesi gerekiyorsa include_once() kullanılmalıdır.

Not: require_once() ve include_once() işlev değil ifadedir. Dolayısıyla eklenecek dosya adı parantez içerisinde yazılmaz.

Örnek;

Kod:   Kodu kopyalamak için üzerine çift tıklayın!
require_once ‘PEAR.php’;


PHP etiketleri
PHP başlangıç ve bitiş etiketleri olarak <?php ?> kullanılmalı. Daha kısa olan <? ?> kullanılmamalıdır.
  Alıntı ile Cevapla

IRCForumlari.NET Reklamlar
radyo44.com.tr
Cevapla

Etiketler
kodlama, pear, standartları

Seçenekler
Stil

Yetkileriniz
Konu Acma Yetkiniz Yok
Cevap Yazma Yetkiniz Yok
Eklenti Yükleme Yetkiniz Yok
Mesajınızı Değiştirme Yetkiniz Yok

BB code is Açık
Smileler Açık
[IMG] Kodları Açık
HTML-Kodu Kapalı
Trackbacks are Kapalı
Pingbacks are Açık
Refbacks are Açık


Benzer Konular
Konu Konuyu Başlatan Forum Cevaplar Son Mesaj
Tcl Kodlama Teknikleri ? BaRoN Eggdrop, NeoStats, BNC 16 18 Aralık 2011 20:37
Pear OS 3.0 duyuruldu. Ocean GNU, Linux ve UNIX 0 18 Aralık 2011 14:08
Ağ Standartları ve IEEE Julw Ağ, Network ve Networking 0 17 Şubat 2008 14:35
Dialog kodlama hakkında.. MavipikSeL mIRC Scripting Sorunları 2 27 Mayıs 2007 09:07