Comments in PHP in Hindi | PHP में Comments हिंदी में

PHP में मुख्य रूप से तीन प्रकार के Comments होते हैं:

1. सिंगल-लाइन कमेंट (Single-line Comment) : सिंगल-लाइन कमेंट एक ही लाइन में लिखा जाता है। इसे दो तरीकों से लिखा जा सकता है:

// (डबल स्लैश)

# (हैश)

उदाहरण:

<?php

// यह एक सिंगल-लाइन कमेंट है

echo "Hello World!"; // यह भी एक कमेंट है

# यह भी सिंगल-लाइन कमेंट का दूसरा तरीका है

echo "PHP सीखना आसान है!";

?>

2. मल्टी-लाइन कमेंट (Multi-line Comment) : मल्टी-लाइन कमेंट का उपयोग तब किया जाता है जब हमें कई लाइनों में टिप्पणी लिखनी हो। इसे /* और */ के बीच लिखा जाता है।

उदाहरण:

<?php

/* 

यह एक मल्टी-लाइन कमेंट है।

इसका उपयोग तब किया जाता है जब

कमेंट कई लाइनों में हो।

*/

echo "PHP में कमेंटिंग आसान है!";

?>

3. PHPDoc कमेंट (Documentation Comment) : PHPDoc कमेंट का उपयोग फ़ंक्शन, क्लास, या किसी बड़े कोड ब्लॉक की विस्तृत जानकारी देने के लिए किया जाता है। इसे /** और */ के बीच लिखा जाता है।

यह खासतौर पर डॉक्यूमेंटेशन टूल्स (जैसे PHPDocumentor) के लिए उपयोगी है।

उदाहरण:

<?php

/**

 * यह फ़ंक्शन दो नंबरों का जोड़ करता है।

 *

 * @param int $a पहला नंबर

 * @param int $b दूसरा नंबर

 * @return int दोनों नंबरों का योग

 */

function addNumbers($a, $b) {

    return $a + $b;

}

echo addNumbers(5, 10); // 15 प्रिंट करेगा

?>

$x = 10; // x को 10 सेट कर रहा हूं (अनावश्यक)

पुराने कमेंट्स हटाना: यदि कोड बदल गया है, तो पुराने कमेंट्स को अपडेट या हटाना जरूरी है।

लंबे कमेंट्स: छोटे और सटीक कमेंट्स लिखें।

<?php

// डेटाबेस से कनेक्ट करने का कोड

$servername = "localhost";

$username = "root";

$password = "";

$database = "my_database";

# कनेक्शन बनाना

$conn = mysqli_connect($servername, $username, $password, $database);

/*

नीचे की लाइन कनेक्शन को चेक कर रही है।

यदि कनेक्शन फेल होता है, तो एरर दिखेगी।

*/

if (!$conn) {

    die("कनेक्शन असफल: " . mysqli_connect_error());

}

echo "कनेक्शन सफल!";

/**

 * यह फ़ंक्शन यूज़र की जानकारी को प्रिंट करता है।

 *

 * @param string $name यूज़र का नाम

 * @param int $age यूज़र की उम्र

 */

function printUserInfo($name, $age) {

    echo "यूज़र का नाम: $name, उम्र: $age";

}

printUserInfo("राहुल", 25); // यूज़र की जानकारी प्रिंट करेगा

?>