PHP: Commenting in PHP

:ballot_box_with_check: :ballot_box_with_check: Comments in PHP :ballot_box_with_check: :ballot_box_with_check:

:point_right: যেকোনো প্রোগ্রামিং ভাষায় লিখিত কোডের একটি গুরুত্বপূর্ণ অংশ হচ্ছে কমেন্ট (Comment)। যদিও প্রোগ্রাম নির্বাহের (Execute) ক্ষেত্রে Comment কোনো প্রভাব ফেলে না, কারণ কম্পাইলার বা ইন্টারপ্রেটার যেকোনো প্রোগ্রামিং ভাষায় লিখিত প্রোগ্রামকে মেশিন ভাষায় বিল্ড (Build) করার সময় Comment কে সম্পূর্ণ অগ্রাহ্য (Ignore) করে।

একইভাবে PHP তে কোডিং এর ক্ষেত্রেও Comment একটি vital অংশ। কমেন্ট এর মাধ্যমে কিছু প্রয়োজনীয় তথ্য পাওয়া যায় যা পরবর্তীতে লিখিত কোডের বা কিছু অংশ বা নির্দিষ্ট স্টেটমেন্টের অর্থ বুঝতে সহায়তা করে।

তাই বলা যেতে পারে, PHP তে Comment হচ্ছে এমন কিছু লাইন যা PHP ইন্টারপ্রেটার execute করে না বা ignore করে থাকে।


:heavy_check_mark::heavy_check_mark: Comment কেন ব্যবহার করব?

  • লিখিত কোড বা কোডের কোনো অংশ বা লাইন পরবর্তীতে অন্য কেউ যেন বুঝতে পারে ।

  • নিজের লিখিত কোড পরবর্তীতে কখনো নিজে দেখে বুঝতে পারার জন্য। কারণ একবার লিখিত কোড পরে আবার কিছু পরিবর্তনের প্রয়োজন হতে পারে।

  • কোনো স্টেটমেন্ট কী উদ্দেশ্যে লিখা হয়েছে তা বুঝার জন্য।

  • প্রোগ্রাম কোডে ব্যবহৃত ফাংশন (বিশেষ করে user defined function) কেন ব্যবহার করা হয়েছে তা স্পষ্ট করার জন্য।

  • অনেক সময় ভ্যারিয়েবল (Variable) বা চলকসমূহের নাম সংক্ষিপ্ত আকারে ঘোষণা করা হয়। সেটা যেন পরে আবার সহজেই বুঝতে পারা যায় তাই এক্ষেত্রে Comment এর ব্যবহার সুবিধাজনক।

  • একটি বড় ধরনের প্রোগ্রামে অনেকগুলো উপ অংশ (Sub program section) থাকতে পারে। এক্ষেত্রে কোন অংশ কেন লিখা হয়েছে তা পরে বুঝার জন্য।

  • লিখিত কোডের কিছু অংশ execute হতে বিরত রাখার জন্য Comment ব্যবহার করা যেতে পারে। কারণ কিছু স্টেটমেন্ট কোডে পরে ব্যবহার হতে পারে কিন্তু এখন সেগুলো নির্বাহের প্রয়োজন নাই এমন অংশগুলো Comment এর মাধ্যমে নির্বাহ (execution) থেকে বিরত রাখা যায়।

:heavy_check_mark::heavy_check_mark: PHP Comment এর প্রকারভেদ ?

PHP তে দুই ধরনের Comment রয়েছে । মানে Comment গুলোকে দুইভাবে PHP প্রোগ্রামে লিখা বা ব্যবহার করা যায়।

  1. Single Line Comment (এক লাইনের কমেন্ট)

  2. Multi Line Comment (বহু/একাধিক লাইনের কমেন্ট)

Example of various types of comments:

// This is a single line comment

# This is also a singleline comment

/*
This is a 
Multi Line Comment 
*/


:one: SIngle Line Comment
Single Line Comment বা এক লাইনের কমেন্ট // (দুইটি ফরোয়ার্ড স্ল্যাশ) চিহ্ন দ্বারা অথবা # চিহ্ন দ্বারা শুরু করতে হয়। // অথবা # চিহ্নের পরের টেক্সট PHP Interpreter উপেক্ষা করে। এক লাইনের কমেন্ট PHP স্ক্রিপ্টের বিভিন্ন জায়গায় ব্যবহার করা যায়। যেকোনো স্টেটমেন্ট এর পাশে এক লাইনের কমেন্ট লিখা যায় আবার স্টেটমেন্ট এর শুরুতেও লিখা যায়।
Example of Single Line Comment:

Example 1:

<?php

$my_text = "Hello World";
echo $my_text;  //Outputs the value of $my-text variable

?>    
Example 2:

<?php

//Determining Summation of two numbers
$first_num = 10;
$second_num = 20;
echo $first_num + $second_num;  #This will print Summation

?>

:two: Multi Line Comment
Multi Line Comment /* চিহ্ন দ্বারা শুরু করতে হয় এবং */ চিহ্ন দ্বারা শেষ করতে হয়। Multi Line Comment ব্লক কমেন্ট (Block Comment) নামেও পরিচিত।

Syntax:

/* This is a Multi Line Comment */
<?php

/* 
This program will find out 
Summation of two numbers.
*/
$first_num = 10;
$second_num = 20;
echo $first_num + $second_num;  #This will print Summation

?>

:three: এছাড়াও কমেন্টের মাধ্যমে PHP তে লিখিত কোড বা কিছু স্টেটমেন্টকে নির্বাহ (execution) থেকে বিরত রাখা যায়। কারণ এইসকল স্টেটমেন্টগুলোকে PHP Interpreter নির্বাহের (Execute) সময় Ignore করে থাকে।

Single-line Comment to ignore code:

<?php

//echo "Hello, World!";

echo "I am learning php";

?>
Multi-line comment to ignore code

<?php

/*
echo "I'm learning PHP";
echo "This is my first PHP script";
*/

echo "Hello, World!";

?>
1 Like