Komentar PHP
Komentar adalah teks yang diabaikan (tidak dievaluasi) oleh interpreter PHP. Biasanya digunakan untuk menulis catatan di dalam kode untuk menjelaskan fungsi dari kode yang telah ditulis.
Ini juga bisa membantu kita dalam belajar, kita bisa menulis poin-poin penting terkait topik tertentu yang sedang dipelajari di dalam kode PHP.
Selain itu, kita juga bisa menggunakannya untuk mencegah interpreter PHP mengevaluasi kode yang kita tulis, misalnya alih-alih menghapus kode, kita bisa memberikan komentar ke bagian tertentu dalam kode PHP sehingga saat kode tersebut dibutuhkan kembali kita tidak perlu menulis ulang, cukup menghapus komentar.
Hampir semua bahasa pemrograman memiliki fitur komentar, tak terkecuali PHP. Agar teks yang kita tulis dianggap komentar PHP, komentar yang kita tulis harus berada diantara tag pembuka dan penutup PHP, jika tidak maka akan diperlakukan lain.
Di PHP ada beberapa cara yang bisa kita gunakan. Berikut beberapa sintaks atau gaya komentar yang bisa kita gunakan.
Komentar Gaya Unix Shell (Perl)
PHP mendukung komentar gaya unix shell atau komentar dalam bahasa pemrograman Perl. Metode ini ditulis menggunakan tanda pagar (#), teks apa pun setelahnya (kecuali tag penutup PHP) yang sebaris maka akan diabaikan dan dianggap sebagai komentar.
Metode ini juga biasa disebut dengan komentar sebaris karena hanya dapat mengomentari satu baris kode, jika kita ingin mengomentari baris berikutnya kita perlu menulis ulang tanda pagar diawal baris.
Contoh:
<?php
# ini komentar
# ini komentar
?>
<?php # ini komentar ?>
Komentar Gaya C atau C++
Selain unix shell, PHP juga mendukung sintaks komentar seperti yang digunakan dalam bahasa pemrograman C atau C++ yaitu menggunakan dua buah garis miring (//) untuk komentar sebaris (perilakunya mirip dengan komentar tanda pagar #) dan komentar beberapa baris.
Untuk komentar beberapa baris (multi-line) kita bisa menggunakan garis miring bintang (/*) diakhiri bintang garis miring (*/), teks apapun yang berada diantaranya akan dianggap sebagai komentar.
Contoh berikut membuat komentar sebaris menggunakan dua buah garis miring, perilakunya sangat mirip dengan komentar gaya unix shell.
<?php
// ini komentar
// ini komentar
?>
<?php // ini komentar ?>
Untuk komentar beberapa baris, kita sebetulnya bisa juga menggunakannya untuk membuat komentar sebaris, yang terpenting komentar selalu diawali garis miring bintang (/*) dan diakhiri dengan (*/) bintang garis miring.
Contoh:
<?php
/*
ini komentar
ini komentar
ini komentar
*/
?>
<?php /* ini komentar */ ?>