PHP Include फ़ंक्शन बहुत उपयोगी होते हैं जब हमें एक ही PHP, HTML, या टेक्स्ट डेटा को एक page से दूसरे विभिन्न pages में शामिल करने की आवश्यकता होती है।
कोड के पूरे ब्लॉक को बार-बार टाइप करने के बजाय, बस एक अलग फ़ाइल में उस कोड ब्लॉक को स्टोर करें और उसे वेबसाइट के किसी भी पेज में शामिल करें जिसमे आप चाहते हैं।
दो PHP फ़ंक्शन हैं जिनका उपयोग PHP फ़ाइल की contents को किसी अन्य PHP फ़ाइलों में शामिल करने के लिए किया जा सकता हैं।
- The include() Function
- The require() Function
PHP include() Function
include()
फ़ंक्शन एक specified फ़ाइल के सभी text लेता है और उसे किसी अन्य फ़ाइल में कॉपी करता है, जो भी उस फाइल के लिए PHP include फ़ंक्शन का उपयोग करता हैं।
एक उदाहरण से समझते हैं। मान लीजिए हम अपनी वेबसाइट के लिए एक मेनू बनाना चाहते हैं, और जैसा की हम जानते है की एक मेनू का data हर पेज पर एक समान ही होता हैं।
अब हम एक PHP फ़ाइल बनाते हैं menu.php
के नाम से, निम्नलिखित डेटा के साथ।
Home | PHP | Java | HTML | Contact Us
अब हमारे पास दो तरीका है मेनू के data को हर पेज में डालने के लिए।
पहला तरीका यह की ऊपर के menu.php
फाइल में लिखे सारे कोड को हर बार हरेक पेज में डाले, पर समस्या तब होगा जब हमें मेनू में कुछ बदलाव करना होगा, तब हमें हर पेज में अलग-अलग जा कर उसे बदलना पड़ेगा। जो की हैं समय की बर्बादी।
दूसरा तरीका यह की हम menu.php
फाइल में लिखे सारे कोड को include()
फ़ंक्शन की मदत से हर पेज में डाले।
उदाहरण के लिए, हम menu.php
फ़ाइल के डेटा को site.php
नामक एक नए पेज में शामिल करना चाहते हैं, उसके लिए हमें निम्नलिखित कोड का उपयोग करना होगा।
Home | PHP | Java | HTML | Contact Us
This is main menu
PHP require() Function
PHP require()
फ़ंक्शन, PHP की include() फ़ंक्शन के समान है, जिसका उपयोग फ़ाइलों को शामिल करने के लिए भी किया जाता है। अंतर केवल इतना है कि यदि किसी फ़ाइल को लोड करने में कोई समस्या है तो PHP require() फ़ंक्शन एक fatal error उत्पन्न करता है और स्क्रिप्ट के execution को रोक देता है। Failure को छोड़कर, दोनों include() और require() एक समान हैं।
include()
फ़ंक्शन केवल एक चेतावनी (E_WARNING) उत्पन्न करेगा पर script जारी रहता है।require()
फ़ंक्शन एक fatal error (E_COMPILE_ERROR) उत्पन्न करता है और script को रोक देता हैं।
उदाहरणों से समझते हैं
Warning: include(xxmenu.php): failed to open stream: No such file or directory in
D:\Wordpress\xampp\htdocs\phptest\site.php on line 3
Warning: include(): Failed opening 'xxmenu.php' for inclusion
include_path='D:\Wordpress\xampp\php\PEAR') in
D:\Wordpress\xampp\htdocs\phptest\site.php on line 3
Example for include wrong PHP file
उपरोक्त उदाहरण में हमने include() फ़ंक्शन का इस्तेमाल किया एक गलत फाइल को include कराने के लिए। और यह एक error दिखाएगा लेकिन फिर भी बाकी के सारे content को डिस्प्ले करेगा।
Warning: require(xxmenu.php): failed to open stream: No such file or directory in
D:\Wordpress\xampp\htdocs\phptest\site.php on line 3
Fatal error: require(): Failed opening required 'xxmenu.php'
(include_path='D:\Wordpress\xampp\php\PEAR') in
D:\Wordpress\xampp\htdocs\phptest\site.php on line 3
उपरोक्त उदाहरण में हमने require() फ़ंक्शन का इस्तेमाल किया एक गलत फाइल को include कराने के लिए। और यह एक error दिखाएगा और script को die कर देता हैं।
require() = जरुरी, जब तक फाइल insert नहीं होगा वह आगे नहीं बढेगा।
- require() function का इस्तेमाल तब करे जब हमें उस फाइल के बिना आगे बढ़ने का कोई मतलब ना रह जाए।
- include() function का इस्तेमाल तब करे जब हमें उस फाइल के रहने या ना रहने से कोई खास फर्क नहीं पड़ता हैं, और उसके बिना भी आगे बढ़ा जा सकता है।