PHP टिप्पणियाँ, शामिल करें/शामिल_एक_बार, आवश्यकता/आवश्यक_एक_बार

टिप्पणियाँ का उपयोग क्यों करें?

• यदि आप कुछ समय तक सोर्स कोड पर काम नहीं करते हैं, तो यह भूल जाना आसान है कि कोड क्या करता है। सोर्स कोड पर टिप्पणी करने से यह याद रखने में मदद मिलती है कि कोड क्या करता है।
• सोर्स कोड पर टिप्पणी करना तब भी बहुत महत्वपूर्ण होता है जब कई डेवलपर्स को एक ही प्रोजेक्ट पर काम करना होता है। एक डेवलपर द्वारा किए गए बदलावों को दूसरे डेवलपर्स आसानी से टिप्पणियों को पढ़कर समझ सकते हैं।
• सर्वोत्तम अभ्यास के रूप में, आपके पास कोड की प्रत्येक 3 पंक्तियों के लिए टिप्पणियों की 10 पंक्तियाँ होनी चाहिए

PHP टिप्पणियाँ

• टिप्पणियाँ हमें कोड को समझने में मदद करती हैं
• टिप्पणियाँ वे स्पष्टीकरण हैं जिन्हें हम अपने स्रोत कोड में शामिल करते हैं। ये टिप्पणियाँ मानवीय समझ के लिए हैं।
• एकल पंक्ति टिप्पणियाँ डबल फ़ॉरवर्ड स्लैश // से शुरू होती हैं और एक ही पंक्ति में समाप्त होती हैं।
• 
• बहु-पंक्ति टिप्पणियाँ फॉरवर्ड स्लैश के बाद तारांकन चिह्न /* से शुरू होती हैं और तारांकन चिह्न के बाद फॉरवर्ड स्लैश */ से समाप्त होती हैं।
• 

नीचे दिया गया चित्र एक PHP फ़ाइल को दर्शाता है जिसमें एकाधिक पंक्ति और एकल पंक्ति दोनों टिप्पणियाँ हैं

पीएचपी उदाहरण

PHP शामिल करें और PHP शामिल_एक बार

“include” php कथन का उपयोग PHP फ़ाइल में अन्य फ़ाइलों को शामिल करने के लिए किया जाता है।

इसके दो रूप हैं, include और include_once. यदि फ़ाइल को शामिल किया जाना है तो PHP इंटरप्रेटर द्वारा Include_once को अनदेखा कर दिया जाता है।

सम्मिलित कथन का सिंटैक्स निम्नलिखित है

<?php
include 'file_name';
?>

include_once कथन का सिंटैक्स निम्नलिखित है

<?php
include_once 'file_name';
?>

यहाँ,

• “शामिल करें/शामिल_एक बार” वह कथन है जिसमें फ़ाइल शामिल है
• “'file_name'” शामिल की जाने वाली फ़ाइल का नाम है.

उदाहरण : शामिल करें / Include_once

मान लीजिए आप विकास कर रहे हैं...ping एक ऐसी वेबसाइट जिसमें सभी पृष्ठों पर एक ही नेविगेशन मेनू होता है।

आप एक सामान्य हेडर बना सकते हैं और फिर उसे include कथन का उपयोग करके प्रत्येक पृष्ठ में शामिल कर सकते हैं। आइए देखें कि यह कैसे किया जा सकता है।

• हम 2 फ़ाइल नाम बनाएंगे
• हेडर.php, index.php

नीचे निम्नलिखित कोड दिए गए हैं; header.php

<a href="index.php">Home</a>

<a href="aboutus.php">About us</a>

<a href="services.php">Services</a>

<a href="contactus.php">Contact Us</a>

index.php

<?php

include 'header.php';

?>

ऊपर हेडर पेज आउटपुट देगा

PHP आवश्यकता और PHP require_once

require कथन के दो रूप हैं, require और require_once.

require/require_once कथन का उपयोग फ़ाइल को शामिल करने के लिए किया जाता है।

यदि आवश्यक फ़ाइल को पहले से ही चार सम्मिलित कथनों में से किसी एक द्वारा जोड़ दिया गया है, तो Require_once को अनदेखा कर दिया जाता है।

इसका वाक्यविन्यास इस प्रकार है

<?php
require 'file_name';
?>

<?php
require_once 'file_name';
?>

यहाँ,

• “require/require_once” वह कथन है जिसमें फ़ाइल शामिल है
• “'file_name'” शामिल की जाने वाली फ़ाइल का नाम है.

उदाहरण : आवश्यकता

मान लीजिए हम विकास कर रहे हैंping एक डेटाबेस आधारित एप्लिकेशन।

हम एक कॉन्फ़िगरेशन फ़ाइल बना सकते हैं जिसे हम require कथन का उपयोग करके डेटाबेस से कनेक्ट होने वाले सभी पृष्ठों में शामिल कर सकते हैं। config.php

<?php

$config['host'] = 'localhost';

$config['db'] = 'my_database';

$config['uid'] = 'root';

$config['password'] = '';

?>

आइए अब उस नमूना कोड को देखें जिसके लिए कॉन्फ़िगरेशन फ़ाइल की आवश्यकता होती है। पेज_मॉडल.php

<?php

require 'config.php'; //require the config file

//other code for connecting to the database

?>

PHP शामिल बनाम आवश्यकता

शामिल / आवश्यक के बीच अंतर

सामान्यतः, सम्मिलित कथन का उपयोग करने की अनुशंसा की जाती है, ताकि जब कोई त्रुटि हो, तो स्क्रिप्ट का निष्पादन वेबमास्टर ईमेल पता या हमसे संपर्क करें पृष्ठ प्रदर्शित करना जारी रखे।

यदि सम्पूर्ण स्क्रिप्ट अनुरोधित फ़ाइल के बिना नहीं चल सकती तो require कथन का उपयोग किया जाना चाहिए।

“शामिल करें” और “आवश्यकता” कथनों का उपयोग स्रोत कोड में किसी भी पंक्ति में किया जा सकता है जहां आप कोड को प्रदर्शित करना चाहते हैं।

सारांश

• सिंगल HTML कोड जैसे हेडर, फुटर, साइड बार आदि को कई पेजों पर शेयर किया जा सकता है। इससे सिर्फ़ एक फ़ाइल को अपडेट करके वेबसाइट को अपडेट करना आसान हो जाता है।
• पीएचपी कोड जैसे कि डेटाबेस कॉन्फ़िगरेशन सेटिंग्स, कस्टम फ़ंक्शन आदि को कई पृष्ठों पर साझा किया जा सकता है, जिससे यह सुनिश्चित हो सके कि वेबसाइट/एप्लिकेशन समान सेटिंग्स का उपयोग करता है।
• टिप्पणियाँ स्रोत कोड को समझने में मदद करने के लिए उपयोग की जाती हैं। वे मानवीय समझ के लिए हैं
• एकल पंक्ति टिप्पणी कथन डबल फॉरवर्ड स्लैश // से शुरू होते हैं।
• बहु-पंक्ति टिप्पणी कथन /* कथनों */ के बीच संलग्न होते हैं।
• “include, include_once, require और require_once” कथनों का उपयोग फ़ाइलों को शामिल करने के लिए किया जाता है।
• यदि अनुरोधित फ़ाइल को पहले से ही चार कथनों में से किसी का उपयोग करके शामिल किया गया है, तो Include_once/require_once को अनदेखा कर दिया जाता है।
• यदि अनुरोधित फ़ाइल नहीं मिली है तो “include” कथन एक चेतावनी जारी करता है और निष्पादन जारी रखता है।
• आवश्यकता कथन एक घातक त्रुटि उत्पन्न करता है और स्क्रिप्ट निष्पादन को रोक देता है।
• "शामिल करें" कथन अधिकांश मामलों में होना चाहिए, सिवाय उन स्थितियों के जहां अनुरोधित फ़ाइल को शामिल किए बिना, पूरी स्क्रिप्ट नहीं चल सकती।