Di panduan Belajar PHP kali ini kita akan membahas cara penulisan komentar di dalam kode PHP. PHP menyediakan beberapa cara untuk menambahkan baris komentar yang mirip dengan cara memberikan komentar di bahasa pemrograman lain seperti C, C++ dan Unix Shell.
Komentar di perlukan untuk memberikan penjelasan kepada orang lain yang membaca kode kita. Komentar sepenuhnya akan diabaikan oleh PHP di ketika eksekusi. Walaupun kamu berpikir bahwa mungkin hanya kamu yang akan membaca kode program tersebut, namun itu yaitu ide yang bagus. Saya sendiri sering bingung ketika memahami beberapa baris kode program setelah beberapa bulan tak melihatnya.
Komentar yang bagus yaitu komentar singkat dan tak terlalu panjang, namun memberikan penjelasan mengenai kegunaan kode atau variabel tersebut dibangun.
Selain selaku tempat membangun penjelasan, sifat komentar yang tak akan dieksekusi oleh PHP, memberikan keuntungan lain di proses penyusunan program. Saya sering menjadikan beberapa baris kode program selaku komentar ketika mencari tau penyebab error kode program yang sedang dibangun (proses debugging).
PHP menyediakan beberapa cara untuk membangun komentar, dan semuanya berasal dari bahasa pemrograman populer lain seperti C, C++, dan Unix Shell.
1. Cara Komentar Unix Shell
Disebut selaku cara komentar Unix Shell, karena cara memberikan komentar ini berasal dari program Unix. Cara ini menggunakan karakter tanda pagar atau hash mark (#). PHP akan mengesampingkan seluruh text yang terdapat setelah tanda pagar hingga ahir baris atau tag penutup PHP (mana yang terlebih dahulu didapati).
Karena sifatnya yang hanya mempengaruhi satu baris saja, cara komenter Unix Shell tepat sasaran digunakan untuk membangun komentar pendek.
|
1 |
<?php<br/>$nilai = $p * exp($r * $t); # menghitung bunga majemuk<br/>?> |
Beberapa programmer pun sering menggunakan karakter # untuk memisahkan bagian kode PHP dengan bagian lainnya, seperti berikut:
|
1 |
#######################<br/>## Falidasi Form Register<br/>#######################<br/>... Kode program PHP disini |
Ketika kamu membangun kode program PHP dan HTML yang saling berkaitan, Komenter Unix Shell ini dapat digunakan seperti contoh berikut:
|
1 |
<?php $nama = duniailkom; # Set $nama menjadi Source Code Program ?><br/><br> <?php echo $nama; ?><br/>... kode HTML berikutnya |
2. Cara Komenter C++
Cara komentar ini meminjam cara membangun komentar dari bahasa pemrograman C++. Hampir sama dengan cara komentar Unix Shell, cara komentar C++ ini berlaku hanya untuk sebuah baris atau hingga tag penutup PHP, Tetapi kali ini karakter yang digunakan yaitu dua kali garis miring (two slashes), yakni “//”.
Karena sifatnya yang sama seperti Unix Shell, seluruh contoh tanda ‘#’ dapat diganti dengan ‘//’, berikut contohnya:
|
1 |
$nilai = $p * exp($r * $t); // menghitung bunga majemuk<br/><br/>/////////////////////////////<br/>// Falidasi Form Register<br/>/////////////////////////////<br/>... Kode program PHP disini<br/><br/><?php $nama = duniailkom; // Set $nama menjadi Source Code Program. ?> <br/><br> <?php echo $nama; ?><br/>... kode HTML berikutnya |
3. Cara Komentar C
Bila cara komentar Unix Shell dan C++ tepat sasaran untuk membangun komentar pendek, untuk membangun komentar yang panjang, PHP meminjamnya dari bahasa C. Cara komentar ini disebut pun tipe komentar blok karena sifatnya yang mesti diberikan tanda tutup untuk mengakhiri komentar.
Untuk memulai komentar, kita menuliskan sebuah garis miring dan diikuti dengan tanda bintang (/*). Seluruh text setelah tanda tersebut akan dianggap selaku komentar hingga PHP menemukan tanda tutup, yakni karakter bintang dan diikuti dengan garis miring (*/). Cara komentar C ini dapat meliputi beberapa baris.
Berikut yaitu contoh pemakaian Cara Komentar C
|
1 |
<?php<br/>/* Di bagian ini kita akan membangun<br/>beberapa variabel dan memberikan nilai awal.<br/>Nilai awal ini hanya selaku contoh saja, jadi jangan dianggap serius<br/>*/<br/>$nama = “Andi”;<br/>$a = 10;<br/>$situs = “duniailkom”;<br/>$b= 2014;<br/>?> |
Cara Komentar C ini pun bermanfaat untuk “mengomentari” beberapa baris program agar tak dijalankan oleh PHP, Seperti contoh berikut:
|
1 |
<?php<br/>$a= 3;<br/>/*<br/>bagian ini tak akan dijalankan oleh PHP<br/>$b = 7;<br/>$c = 8;<br/>*/<br/>?> |
Namun kamu perlu berhati-hati untuk tak membangun blok komentar yang saling bertumpuk, seperti kode berikut:
|
1 |
<?php<br/>$a = 12;<br/>/*<br/>$j = 10; /* Ini yaitu komentar */<br/>$k = 11;<br/>Ini yaitu komentar<br/>*/<br/>?> |
Di contoh diatas, PHP akan gagal menjalankan kode program dan menghasilkan error di sebabkan komentar yang saling berhimpitan (overlapping).
Di di panduan belajar PHP berikutnya, saya akan membahas mengenai inti dari bahasa pemrograman PHP, yaitu variabel. Berikutnya di Tutorial Belajar PHP: Pengertian Variabel dan Cara Penulisan Variabel PHP.
Sumber https://www.duniailkom.com/
