Komen dalam PHP

Perkataan komen itu sendiri menyatakan maksudnya sebagai mengulas sesuatu. Jika kami mengulas apa-apa dalam fail program PHP, ia tidak akan disusun bersama kod. Pengkompil atau penterjemah hanya akan mengabaikan ini. Terdapat pelbagai cara yang boleh kita lakukan dengan mengulas apa sahaja dalam bahasa pengaturcaraan PHP. PHP mempunyai pilihan komen satu baris dan berbilang baris juga. Juga, dalam ulasan satu baris, kami boleh menggunakan / atau # mengikut keselesaan kami. Kita hendaklah sentiasa menulis bahasa yang sesuai dalam ulasan supaya sesiapa yang menyemak kod itu boleh membaca dan memahami ulasan itu.

Mulakan Kursus Pembangunan Perisian Percuma Anda

Pembangunan web, bahasa pengaturcaraan, ujian perisian & lain-lain

Sintaks

Sekali lagi, kita boleh menggunakan ulasan dalam cara yang dinyatakan di bawah dalam PHP.

Komen Baris Tunggal:

// This is a single-line comment
# This is a single-line comment
/*
This is a multiple line comment – line no – 1
This is a multiple line comment – line no – 2
… and so on …
*/
# this is the single-line comment
; this is a PHP.INI style commenting

Bagaimana Komen dalam PHP berfungsi?

Apabila kita menulis ulasan dalam kod, ia akan menjadi lebih ringan dilihat secara perbandingan berbanding dengan kod sebenar. Jika kami mempunyai kod bertulis dan ulasan dalam fail yang sama, dalam kes ini, ulasan tidak akan dilaksanakan semasa menjalankan fail PHP tersebut. Jadi mari kita lihat perkara yang sama dengan contoh.

<?PHP
echo "This is my first PHP Program";
// this is the first program
?>

Ini hanya akan memberikan 'Ini adalah Program PHP pertama saya' sebagai output, bukan bahagian komen.

Mengapa kita perlu menggunakan ulasan?

Kami harus menggunakan ulasan di antara kod program PHP untuk memastikan kami mempunyai ulasan bantuan yang mencukupi supaya seseorang boleh membaca dan memahami kod dengan mudah. Dalam ulasan, kita juga boleh untuk tujuan menulis segmen kod, menukar tarikh, tarikh pengubahsuaian, diubah suai oleh, dan lain-lain. Sangat disyorkan untuk pembangun menggunakan ulasan dalam kod pengaturcaraan supaya perkara dapat difahami mudah dengan sedikit atau tanpa usaha apabila diperlukan.

Contoh

Sekarang, tiba masanya untuk melihat beberapa contoh pantas menyemak tingkah laku ulasan dalam program.

Contoh #1

<?php
echo "This is my first PHP Program";
// this is the first program
?>

Output 

Contoh #2

Ulasan baris tunggal dalam program

Kod:

<?php
echo date_default_timezone_get(); //to get the timezone
echo "<br>"; //line brea;
date_default_timezone_set('Asia/Kolkata'); // setting the timezone to Asia/Kolkata
echo date_default_timezone_get(); //to get the timezone
?>

Output 

Contoh #3

Ulasan berbilang baris dalam program

Kod:

<?php
/*
This is a function that will take time in minutes and will return that in hours and minutes
We use will this function further to test with some examples.
*/
function hoursandmins($minutes, $format = '%01d Hours, %02d Minutes')
{
if ($minutes < 1) {
return;
}else if($minutes<10){
if($minutes==1){
return '0'.$minutes.' Minute';
}
return '0'.$minutes.' Minutes';
}else if($minutes<50){
return $minutes.' Minutes';
}
$hours = floor($minutes / 60);
$minutes = ($minutes % 60);
$format = "";
if($hours>0){
if($hours>1){
$format .= '%01d Hours';
}else{
$format .= '%01d Hour';
}
}
if($hours>0 && $minutes>0){
$format .= ', ';
}
if($minutes>0){
if($minutes>1){
$format .= ' %02d Minutes';
}else{
$format .= ' %01d Minute';
}
}
return sprintf($format, $hours, $minutes);
}
// time to check the time in descriptive form
echo hoursandmins(20);
echo "<br>";
echo hoursandmins(120);
?>

Output 

Sebarang komen yang ditulis sebelum sebarang fungsi tentang fungsi itu biasanya dikenali sebagai dokumentasi fungsi. Jadi, dalam senario yang diberikan kita boleh mengatakan komen ini sebagai dokumen fungsi. Ini sangat bagus untuk menggunakan komen seperti itu. Untuk menjadikan program PHP lebih mantap, kami mempunyai pelbagai piawaian PHP yang mengatakan bahawa kami tidak sepatutnya menggunakan ulasan di dalam fungsi kerana kami boleh melakukan perkara yang sama dalam dokumentasi fungsi.

Contoh #4

Ulasan bercampur

Dalam fail program PHP, kami boleh menggabungkan kedua-dua PHP dan HTML. Memandangkan ini, kami akan menggunakan kaedah mengulas HTML untuk mengulas bahagian HTML apabila diperlukan, dan komen PHP boleh digunakan untuk kod berkaitan PHP mengikut keperluan perniagaan. Kami boleh menggunakan sebarang jenis ulasan PHP dan ulasan HTML dalam fail PHP-HTML.

Kod:

<html>
<body>
<h1>PHP with HTML</h1>
<!-- this is html comment -->
<?php
echo "Hello World!"; // this is PHP comment
?>
</body>
</html>

Output 

Contoh #5

Ulasan baris tunggal menggunakan #

Kita boleh menggunakan satu baris mengulas menggunakan # juga. Mari lihat contoh kod yang sama. Kita boleh lihat barisan komen ini tidak begitu popular. Sangat sedikit pembangun menggunakan ulasan seperti ini. Ini benar-benar disyorkan untuk mengulas sementara untuk dokumentasi fungsi atau dokumentasi peringkat fail.

Kod:

<?php
# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>

Output

Kesimpulan

Ulasan benar-benar panggilan masa dalam kod. Kami boleh menggunakan ulasan dalam fail program PHP kami. Ini akan membantu kami menjadikan kod lebih mudah difahami. Kita harus menggunakan ulasan sebelum memulakan fungsi atau kelas kerana kebanyakan bahasa pengaturcaraan mempunyai standard kod mereka sendiri. Biasanya, ulasan sebelum mana-mana fungsi atau kelas dipanggil dokumentasi fungsi atau kelas itu.

Atas ialah kandungan terperinci Komen dalam PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!