Pada tutorial 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 memberi penjelasan kepada orang yang membaca kode kita. Komentar sepenuhnya akan diabaikan oleh PHP pada saat eksekusi. Walaupun kode yang dibuat tidak akan dibaca orang lain, baris komentar tetap membantu. Saya sendiri sering bingung ketika memahami beberapa baris kode program setelah beberapa bulan tidak melihatnya.
Selain sebagai tempat membuat penjelasan, sifat komentar yang tidak akan dieksekusi oleh PHP memberi keuntungan lain dalam proses pembuatan program. Saya sering menjadikan beberapa baris kode sebagai komentar saat mencari penyebab error kode program yang sedang dibuat (proses debugging).
PHP menyediakan beberapa cara untuk membuat komentar yang semuanya berasal dari bahasa pemrograman populer lain seperti C, C++, dan Unix Shell.
 1. Metode Komentar Unix Shell
Disebut sebagai metode komentar Unix Shell karena cara memberikan komentar ini berasal dari sistem Unix. Metode ini menggunakan karakter tanda pagar atau hash mark (#). PHP akan mengabaikan seluruh text yang terdapat setelah tanda pagar sampai akhir baris atau tag penutup PHP (mana yang terlebih dahulu didapati).
Karena sifatnya yang hanya mempengaruhi satu baris saja, metode komenter Unix Shell cocok dipakai untuk membuat komentar pendek.
<?php $nilai = $p * exp($r * $t); # menghitung bunga majemuk ?>
Beberapa programmer juga sering menggunakan karakter # untuk memisahkan bagian kode PHP dengan bagian lainnya, seperti berikut:
####################### ## Falidasi Form Register ####################### ... Kode program PHP disini
Ketika anda membuat kode program PHP dan HTML yang saling bergabung, Komenter Unix Shell ini bisa digunakan seperti contoh berikut:
<?php $nama = "duniailkom"; # Set $nama menjadi duniailkom ?> <br> <?php echo $nama; ?> ... kode HTML berikutnya
2. Metode Komenter C++
Metode komentar ini meminjam cara membuat komentar dari bahasa pemrograman C++. Hampir sama dengan metode komentar Unix Shell, metode komentar C++ ini berlaku hanya untuk sebuah baris atau sampai tag penutup PHP, Tetapi kali ini karakter yang digunakan adalah dua kali garis miring (two slashes), yakni “//“.
Karena sifatnya yang sama seperti Unix Shell, semua contoh tanda ‘#‘ dapat diganti dengan ‘//’, berikut contohnya:
$nilai = $p * exp($r * $t); // menghitung bunga majemuk ///////////////////////////// // Falidasi Form Register ///////////////////////////// ... Kode program PHP disini <?php $nama = "duniailkom"; // Set $nama menjadi duniailkom. ?> <br> <?php echo $nama; ?> ... kode HTML berikutnya
3. Metode Komentar C
Jika metode komentar Unix Shell dan C++ efektif untuk membuat komentar pendek, untuk membuat komentar yang panjang PHP meminjamnya dari bahasa C. Metode komentar ini disebut juga tipe komentar blok karena sifatnya yang harus diberi tanda tutup untuk mengakhiri komentar.
Untuk memulai komentar, tulis satu 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 (*/). Metode komentar C ini dapat mencakup beberapa baris.
Berikut adalah contoh penggunaan Metode Komentar C
<?php /* Dalam bagian ini kita akan membuat beberapa variabel dan memberikan nilai awal. Nilai awal ini hanya sebagai contoh saja, jadi jangan dianggap serius */ $nama = "Andi"; $a = 10; $situs = "duniailkom"; $b= 2014; ?>
Metode Komentar C ini juga berguna untuk “mengomentari” beberapa baris program agar tidak dijalankan oleh PHP, Seperti contoh berikut:
<?php $a= 3; /* bagian ini tidak akan dijalankan oleh PHP $b = 7; $c = 8; */ ?>
Namun anda perlu berhati-hati untuk tidak membuat blok komentar yang saling bertumpuk, seperti kode berikut:
<?php $a = 12; /* $j = 10; /* Ini adalah komentar */ $k = 11; Ini adalah komentar */ ?>
Pada contoh diatas, PHP akan gagal menjalankan kode program dan menghasilkan error di sebabkan komentar yang saling berhimpitan (overlapping).
Di dalam tutorial belajar PHP berikutnya, saya akan membahas tentang inti dari bahasa pemrograman PHP, yaitu variabel. Selanjutnya pada Tutorial Belajar PHP: Pengertian Variabel dan Cara Penulisan Variabel PHP.
ijin copy bung…
Silahkan gan, asal dikasih link aktif ke situs duniailkom ini ya… :)
Bagus nih materi-materinya, saya sudah pelajari semuanya,.
o iya, sudah ada terbitan lewat buku belum? kan lumayan gan… hhehe
-just suggestion
Terimakasih atas idenya mas fachrozy, iya saya ada rencana untuk menerbitkan buku, tapi sampai sekarang masih belum kesampaian juga.. :)
mantep2 mas tutorialnya, klo boleh dibwtin 1 link khusus mengenai org / team yg ada dibalik duniailkom.com, jdi bisa lebih kenal lgi,, siapa tau bisa tnya2 via pm nantinya hehe :)
Admin-nya masih malu2 nih gan,..hehe… Untuk menghubungi bisa email ke duniailkom@gmail.com :)
sangat membantu artikel ini untuk pelajaran saya
Kenapa dak menyinggung DW dreamwrr
Saya tidak merekomendasikan Dreamweaver untuk pemula mas. Toolsnya memang praktis dan mudah digunakan, tapi bisa membuat bingung karena DW men-generate kode-kode secara otomatis.
Jika tujuannya adalah belajar web programming, sebaiknya seluruh kode dibuat secara manual, jadi kita paham apa maksud dan tujuan setiap kode ini. Selain itu DW juga berbayar dan berharga mahal untuk versi aslinya.
jadi disarankan untuk pemula menggunakan software apa?
Teks editor seperti Notepad++ atau untuk yang tampilannya lebih bagus bisa coba Komodo Edit. Keduanya aplikasi open source dan bisa di download dengan gratis.
Terima kasih ,mantap mas tutornya !
sangat membantu, kalau bisa sekalian buat channel youtubenya
Mudah2an suatu saat bisa kesampaian gan… untuk saat ini masih ada kegiatan lain nih, belum sempat buat video tutorial di youtube.
Harga ebook javascript nya berapa gan?
eBook JavaScript 50rb gan..
Jika berminat, saya sudah kirim cara pemesanannya via email. Silahkan di cek inbox emailnya…
Buat komen seperti ini di blog, gimana ya?
Blog ini menggunakan WordPress, jadi form komentarnya sudah bawaan.
jika agan ingin membuat sendiri harus menggunakan PHP dan komentar ini disimpan ke dalam database. Kalau pakai blogspot, setahu saya tidak bisa ditambahkan kode PHP.
| dibaca hits;?> kali
Bagaimana untuk mengilangkan " | dibaca <?=$row->hits;?> kali" agar tdk dibaca oleh php
Ini kode di dapat dari template atau dibuat programmer lain y? sebaiknya coba tanya ke si pembuat kode tersebut karena bisa jadi jika kita utak-atik akan berdampak ke kode lainnya. Bisa juga kode tersebut tampil karena diatasnya ada perintah yang salah ketik.. (kurang tanda koma, kurang titik koma, dsb)
Jika tidak ingin terbaca oleh PHP bisa dihapus saja baris tersebut.
Masih bingung nih maklum, baru di blog tapi makasih ilmunya
Makasih banget infonya
Gan mau tanya ane kok pernah lihat di komentar web salah satu yg di up capte nya kan sama urutan huruf tapi ikutin malah salah karakter apa itu error atau bagaimana ?
Saya kurang nangkap maksud pertanyaannya. Tapi yang pengertian komentar dalam artikel ini adalah blok comment di PHP, bukan form komentar yang ada di blog atau website.
jumpa tahap ke-10, langsung saya cari tahap 1. pengen belajar dari awal. makasih kak, saya coba dulu ya. doain biar berhasil tanpa halangan hehe
Untuk penggunaan comment sama dengan comment untuk bahasa pemrograman Arduino. Krn basic languagenya C, C++
Betul, PHP termasuk bahasa turunan C/C++, sehingga codingnya juga mirip2 dengan C, C++ serta bahasa turunan C/C++ lain seperti Java dan JavaScript
sangat membantu