PHP Yorumlar (Comments)
Yorumlar, bir programlama dilinde kodun anlaşılmasını ve belgelenmesini kolaylaştıran metinlerdir. PHP’de yorumlar kullanılarak kodun anlaşılabilirliği artırılır, kodun ne yaptığı ve neden yapıldığı açıklanır. Bu ders içeriğinde, PHP’de yorumların nasıl kullanılacağına, farklı yorum türlerine ayrıntılı olarak bakalım.
Tek Satırlık Yorumlar:
// (çift slash) işareti ile tek satırlık yorum ekleyebiliriz.
# (hekta, diyez, hash) işareti ile de tek satırlık yorum yapılabilir.
$name = "Mehmet";
Henüz değişken tanımlamayı görmedik. Kısaca söz etmek gerekirse burada ‘$name’ değişkenine ‘Mehmet’ değerini atadık.
// $name değişkenine Mehmet değerini atadık. $name = 'Mehmet'; $number = 7; // yorumu burayada yazabilirim. # Mavi renk hex codu #0000FF $color = '#0000FF';
Bakın burada bir rengin hex codunu ekledik. Eklediğim anda bunu biliyorum. İnternetten mavinin hex coduna baktım ekledim. Ama bir süre sonra bunu unutmam çok doğal. Bende sonra başka bir arkadaşım da programı düzenleyebilir. Hem kendimiz için hemde bizden sonra programı geliştirecek kişilere yardımcı olmak için açıklayıcı yorumlar ekleriz.
Çok Satırlı Yorumlar:
Çok satırlı yorumlar, birden fazla satırı yorumlamak için kullanılır.
Başlangıç ve bitiş işaretleri olan C tarzı yorum işaretleri (/* */) kullanılır.
Daha açıklayıcı ve uzun yorumlar yazmamız gereken durumlarda çok satırlı yorumları kullanabiliriz.
Örnek yapalım.
Burada çalışan bir fonksiyon olduğunu farz edelim. Evet şu an fonksiyonun ne olduğunu bilmiyoruz ama ona takılmayalım. ilerde çok basit ve kolay bir şekilde öğreneceğiz zaten.
/*
Bu fonksiyon öğrencinin not ortalamasını hesaplar.
Fonksiyon hakkında bilgiler ekleyebilirim.
*/
function calculate(){
/*
Bu alanda fonsiyonun kodları olacak.
*/
}
/************************************************* * Daha çok dikkat çekmesini istediğim notlarımı * bu şekilde de yazabilirim. * * Bence gayet güzel * *************************************************/
Devre Dışı Bırakma:
Yorumlar, belirli kod bloklarını veya satırları geçici olarak devre dışı bırakmak için kullanılabilir.
Kodun çalıştırılmasını engellemek veya belirli bir bölümü geçici olarak atlamak için yorumlar kullanılabilir.
Örnek yapalım.
$name = 'Mehmet'; //$color = 'Mavi';
$name değişkenine ‘Mehmet’ değerini atadım. Daha sonra $color değişkenine ‘Mavi’ değerini atadım ama sonra onun başına // (çift slash) işreti koydum artık o kod yorumlanmayacak. $name değişkenimiz var tanımlı ama $color değişkenimiz yoruma aldığımız için PHP sunucusu tarafından devre dışı bırakıldı. Tekrar kullanmak istersem başındaki // işaretini kaldırmam yeterli.
uzun kod bloklarımızı, fonksiyonlarımızı da bazen yoruma alabiliriz. Örneğin yukarıda yazdığımız ‘calculate’ fonksiyonunu geçiçi olarak devre dışı bırakmak istiyoruz.
/*
function calculate(){
}
*/
Artık fonksiyon devre dışı kaldı.
Yorumların Faydaları:
Kodun anlaşılabilirliğini artırır: Yorumlar, kodun ne yaptığını ve neden yapıldığını açıklar, böylece başkaları tarafından daha kolay okunabilir hale gelir.
Hataları tespit etmeyi kolaylaştırır: Yorumlar, kodun farklı bölümlerini işaret ederek hataları bulmayı ve düzeltmeyi kolaylaştırır.
Belgeleri tamamlar: Yorumlar, kodun kullanımı, işlev
teşekkür ederiz.