PHP include स्टेटमेंट (include Statement) - मॉड्यूलर प्रोग्रामिंग

परिचय

एक फ़ाइल में PHP कोड को include स्टेटमेंट की सहायता से दूसरे PHP स्क्रिप्ट में उपयोग के लिए उपलब्ध कराया जा सकता है। यह सुविधा फ़ंक्शन्स और क्लासेस को एक बार लिखकर और जहां भी आवश्यक हो कॉल करके मॉड्यूलर प्रोग्राम विकास को सक्षम बनाती है।

include स्टेटमेंट डिफ़ॉल्ट रूप से वर्तमान फ़ोल्डर में फ़ाइल की जांच करता है और आगे php.ini की include_path सेटिंग में उल्लिखित डायरेक्टरीज में। यदि मांगी गई फ़ाइल वर्तमान फ़ोल्डर के साथ-साथ include_path फ़ोल्डर्स में भी उपलब्ध नहीं है, तो PHP पार्सर E_WARNING उत्सर्जित करता है और कॉलिंग मॉड्यूल का निष्पादन जारी रहता है।

इन्क्लूडेड फ़ाइल कॉलिंग मॉड्यूल में इन्क्लूजन से पहले परिभाषित वेरिएबल्स तक पहुँच सकती है। ऐसे वेरिएबल्स का ग्लोबल स्कोप होगा।

उदाहरण

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

निम्न उदाहरण में मुख्य PHP स्क्रिप्ट test.php को इन्क्लूड करती है:

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

// test.php
<?php 
$var2 = 200; 
// मुख्य स्क्रिप्ट से $var1 एक्सेस करना
echo $var1 + $var2 . "\n"; 
?>

आउटपुट

inside main script
now calling test.php script
300
returns from test.php

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

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

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

आउटपुट

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

फ़ंक्शन के अंदर से include

अगले उदाहरण में, test.php को एक फ़ंक्शन के अंदर इन्क्लूड किया गया है। इन्क्लूडेड फ़ाइल के अंदर का कोड फ़ंक्शन के हिस्से के रूप में माना जाएगा। इसलिए इन्क्लूड फ़ाइल में वेरिएबल्स फ़ंक्शन के बाहर पहुंच योग्य नहीं होंगे।

उदाहरण 3: फ़ंक्शन के अंदर इन्क्लूड

// मुख्य स्क्रिप्ट
<?php 
function myfunction() { 
    $var1 = 100; 
    include "test.php"; 
    echo $var1 + $var2 . "\n"; 
} 
myfunction(); 
echo "variable from included file outside function: $var2"; 
?> 

// test.php इन्क्लूडेड
<?php 
echo "test.php called from inside function\n"; 
$var2 = 200; 
return; 
?>

आउटपुट

100 
test.php called from inside function 
PHP Notice: Undefined variable: var2 in C:\xampp\php\testscript.php on line 9 
Notice: Undefined variable: var2 in C:\xampp\php\testscript.php on line 9 
variable from included file outside function

इन्क्लूड फ़ाइल से return

include स्टेटमेंट सफलता पर TRUE और विफलता पर FALSE लौटाता है। यदि इन्क्लूड फ़ाइल स्पष्ट रूप से एक एक्सप्रेशन लौटाती है, तो इसका उपयोग कॉलिंग मॉड्यूल द्वारा आगे की प्रोसेसिंग के लिए किया जा सकता है।

उदाहरण 4: इन्क्लूड फ़ाइल से रिटर्न मान

// मुख्य स्क्रिप्ट
<?php 
$result = include "test.php"; 
echo "return value : $result\n"; 
$y = include "test1.php"; 
echo "return value : $y\n"; 
$x = include "test2.php"; 
echo "return value : $x\n"; 
?> 

// test.php
<?php 
$var = 100; 
return $var; 
?> 

// test1.php
<?php 
$var = 100; 
return; 
?> 

// test2.php
<?php 
$var = 100; 
?>

आउटपुट

return value : 100 
return value : 
return value : 1