Seperti pada bahasa pemrograman pada umum nya, kita juga dapat menulis komentar pada PHP, pada kesempatan kali ini kita akan membahas cara membuat/menulis komentar pada PHP. Show
Table of Contents
Pentingnya KomentarKenapa komentar ini penting? komentar pada PHP dan bahasa pemrograman pada umumnya penting untuk memberi catatan kode yang ditulis. Beberapa hal yang membuat penulisan komentar menjadi penting:
Cara Membuat / Menulis Komentar Pada PHPSetelah mengetahui pentingnnya komentar, mari kita bahas cara membuat komentar di PHP. Pada PHP, komentar dibagi menjadi dua yaitu komentar per baris / single-line / inline comment dan  komentar yang terdiri dari beberapa baris / multi-line comment. Penulisan komentar ini (baik inline maupun multiline) dapat dilakukan dimana saja asal didalam open tag ( 1 Menulis Komentar Pada PHP Per Baris (inline-comment)Untuk menulis komentar yang
hanya terdiri dari satu baris, maka kita bisa menggunakan tanda Model C++ – Tanda Ketika PHP menemukan tanda ini ( Contoh penulisan:
Model Unix Shell – Tanda # Sama
seperti model C++, pada penulisan komentar model unix shell ini, PHP akan mengabaikan (tidak memproses) tanda Contoh penulisan:
2 Menulis Komentar Pada PHP Lebih dari Satu BarisUntuk membuat komentar pada PHP beberapa baris / multi-line comment,
kita menggunakan tanda Model C – Tanda /* Pada komentar model ini, PHP akan mengabaikan (tidak memproses) tanda Sehingga, jenis komentar ini cocok digunakan untuk menulis komentar yang panjang yang terdiri lebih dari satu baris Tidak ada standar untuk penulisan komentar jenis ini, namun yang umum digunakan adalah seperti yang di standarkan oleh Zend Framework dan PHPDoc, yaitu:
Maka ketika kita melihat source code beberapa program yang populer, kita akan sering menemukan komentar jenis ini dibagian header (baris paling atas). Contoh penulisan:
Menonaktifkan baris tertentuPenulisan komentar model ini juga sering digunakan untuk menonaktifkan baris kode tertentu dengan membuat kode pada baris tersebut menjadi komentar, sehingga diabaikan oleh PHP, misal:
Pada kode diatas, baris 12 – 15 kita nonaktifkan (pada notepad++ dengan shortcut Ctrl + Shift + Q). Selanjutnya variabel Hal ini sering kita lakukan untuk bagian tertentu dari aplikasi yang sedang kita kembangkan. 3 Model Komentar Yang Sebaiknya DigunakanJadi, dari ketiga model komentar diatas, maka yang harus digunakan? Dari ketiga model diatas yang umum digunakan adalah model nomor 1 (tanda Demikian pembahasan mengenai cara menulis komentar pada PHP, semoga bermanfaat. Subscibe NowSuka dengan artikel di Jagowebdev.com? jangan sampai ketinggalan, segera join ke milis kami untuk update informasi terbaru dari Jagowebdev.com Untuk memulai komentar, kita menuliskan sebuah garis miring dan diikuti dengan tanda bintang (/*). Semua text setelah tanda tersebut akan dianggap sebagai komentar sampai PHP menemukan tanda tutup, yakni karakter bintang dan diikuti dengan garis miring (*/). Mereka mudah ditulis dan dikenali: blok komentar JavaScript (juga dikenal sebagai komentar multi-baris) dimulai dengan * /, sedangkan komentar baris tunggal dimulai dengan //. Dalam bahasa pemrograman, komentar juga dapat digunakan untuk mencegah beberapa baris kode dieksekusi. Cara Membuat Komentar CSS Komentar CSS diawali dengan garis miring tanda bintang ( /* ) dan diakhiri dengan tanda bintang garis miring terbalik ( */ ). Komentar Multi Line (Beberapa Baris) Komentar multi line diawali dengan /* (garis miring bintang) dan diakhiri dengan */ (bintang garis miring). Kode atau teks apa pun yang berada diantara /* dan */ tidak akan dieksekusi oleh mesin. Anda apa yang dapat digunakan untuk memberikan komentar satu baris pada JavaScript?Untuk komentar satu baris, Anda harus menulis dua garis miring: //. Apa pun yang terjadi setelah // hingga jeda baris diperlakukan sebagai komentar JavaScript dan tidak dieksekusi sebagai kode.
Bagaimana membuat komentar di JavaScript bila lebih dari satu baris kode?Komentar Multi Line (Beberapa Baris)
Komentar multi line diawali dengan /* (garis miring bintang) dan diakhiri dengan */ (bintang garis miring). Kode atau teks apa pun yang berada diantara /* dan */ tidak akan dieksekusi oleh mesin.
Apakah guna dari memberi comment pada kode pemrograman?Komentar hanya digunakan untuk menandai atau memberikan keterangan tertulis pada script. Komentar biasa digunakan untuk membiarkan orang lain memahami apa yang dilakukan script. atau untuk mengingatkan kepada programmer sendiri jika suatu saat kembali mengedit script tersebut.
|