PHP include_once स्टेटमेंट (include_once Statement) - एकाधिक इन्क्लूड रोकथाम

परिचय

include स्टेटमेंट की तरह, include_once भी एक फ़ाइल में लिखी स्क्रिप्ट को दूसरी में स्थानांतरित और मूल्यांकन करता है, दोनों में अंतर इस तथ्य में निहित है कि include_once उसी फ़ाइल को फिर से लोड होने से रोकता है यदि पहले से ही किया जा चुका है। जैसा कि नाम से संकेत मिलता है, एक फ़ाइल केवल एक बार इन्क्लूड होगी भले ही कोई फिर से इन्क्लूड निर्देश जारी करने का प्रयास करे।

include_once स्टेटमेंट का उपयोग आमतौर पर ग्लोबल वेरिएबल्स सेट करने, लाइब्रेरी सक्षम करने या ऐसी किसी गतिविधि के लिए किया जाता है जो एप्लिकेशन के निष्पादन की शुरुआत में किए जाने की उम्मीद है।

इसके अलावा, include_once स्टेटमेंट का व्यवहार include स्टेटमेंट के समान है।

उदाहरण

उदाहरण 1: include_once के साथ इन्क्लूड

निम्न उदाहरण में testscript.php Apache सर्वर के डॉक्यूमेंट रूट फ़ोल्डर में मौजूद है। यह include_once स्टेटमेंट का उपयोग करके test.php को इन्सर्ट करता है:

<?php 
echo "calling include_once statement\n"; 
$result = include_once "test.php"; 
?> 

// test.php
<?php 
echo "This file is included once\n"; 
?>

आउटपुट

calling include_once statement 
This file is included once

असफल इन्क्लूड के लिए चेतावनी

यदि include_once स्टेटमेंट का फ़ाइल आर्गुमेंट नहीं मिलता है तो पार्सर द्वारा चेतावनी उत्सर्जित की जाती है।

उदाहरण 2: मौजूद न होने वाली फ़ाइल के लिए चेतावनी

<?php 
echo "inside main script\n"; 
$var1 = 100; 
echo "now calling nosuchfile.php script"; 
include_once "nosuchfile.php"; 
echo "returns from nosuchfile.php"; 
?>

आउटपुट

inside main script 
now calling nosuchfile.php script 
PHP Warning: include_once(nosuchfile.php): failed to open stream: No such file or directory in line 5 
PHP Warning: include_once(): Failed opening 'nosuchfile.php' for inclusion (include_path='C:\xampp\php\PEAR') in line 5 
returns from nosuchfile.php

दूसरी बार include_once कॉल

अगला उदाहरण include_once स्टेटमेंट के साथ test.php को इन्क्लूड करता है। ध्यान दें कि वही फ़ाइल फिर से इन्क्लूड नहीं होती।

उदाहरण 3: दोहराव रोकथाम

// मुख्य स्क्रिप्ट
<?php 
echo "inside main script\n"; 
echo "now including test.php script\n"; 
include_once "test.php"; 
echo "now including again test.php script\n"; 
?> 

// test.php इन्क्लूडेड
<?php 
echo "This file is included once"; 
?>

आउटपुट

inside main script 
now including test.php script 
This file is included once 
now including again test.php script