PHP kodunuza yorum eklemenin iki yolu vardır. Birincisi; yazdığınız tek satırlık kodun önüne bir çift eğik çizgi (//) koyarsanız tek bir satırı yoruma dönüştürür:
// Bu bir yorum satırıdır.
Yorum özelliğinin bu kullanılış biçimi size hata veren bir programdan bir kod satırını geçici olarak kaldırmanın harika bir yoludur. Örneğin, hata ayıklama kod satırını ihtiyacınız olana kadar gizlemek için böyle bir yorum kullanabilirsiniz, örneğin:
// echo "X eşittir $x";
Bu tür bir yorumu yazdığınız kodun işlevini açıklamak için kod satırından hemen sonra da kullanabilirsiniz, şöyle:
$x += 10; // $x değerini 10 artır.
Birden çok satır kullanmanız gerektiğinde PHP‘ye yorum eklemenin aşağıdaki biçimini kullanabilirsiniz:
<?php /* Bu çok satırlı bir yorum satırıdır ve kodun çalıştırılması sırasında yorumlanmaz. */ ?>
/* ve */ karakter çiftlerini kodunuzun içinde hemen hemen istediğiniz her yerde yorumları satırlarını açıp kapatmak için kullanabilirsiniz. Hepsi olmasa da çoğu programcı bu yapıyı çalışmayan veya bir nedenden ötürü çalıştırılmak istenmeyen tüm kod bölümlerini geçici olarak devre dışı bırakmak için kullanır.
Yaygın bir hata, /* ve */’yi, zaten bu karakterleri kullanan yorumlanmış bir bölüm içeren büyük bir kod bölümünü yorumlamak için kullanmaktır. Yorumları bu şekilde iç içe yerleştiremezsiniz; PHP yorumlayıcısı bu şekilde kullanımda bir yorumun nerede bittiğini bilemez ve bir hata mesajı görüntüler. Ancak sözdizimi vurgulamalı bir düzenleyici veya IDE kullanıyorsanız bu tür bir hatayı tespit etmek daha kolaydır.