फ़ंक्शन require_once

फ़ंक्शन require_once वर्तमान स्क्रिप्ट में निर्दिष्ट फ़ाइल को शामिल करता है। यदि फ़ाइल पहले से ही शामिल की जा चुकी है, तो फ़ंक्शन इसे दोबारा शामिल नहीं करेगा। यह कक्षाओं या फ़ंक्शन वाली फ़ाइलों को शामिल करने के लिए विशेष रूप से उपयोगी है, जहाँ दोहराव शामिल करने से त्रुटियां उत्पन्न हो सकती हैं।

वाक्य-विन्यास

require_once 'path/to/file.php';

उदाहरण

फ़ाइल config.php शामिल करें:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

कोड निष्पादन का परिणाम (यदि config.php में $config सरणी परिभाषित है):

'My Site'

उदाहरण

एक ही फ़ाइल को दोबारा शामिल करने का प्रयास:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // इस कॉल को नजरअंदाज कर दिया जाएगा
	echo sum(2, 3);
?>

कोड निष्पादन का परिणाम:

5

require से अंतर

require के विपरीत, फ़ंक्शन require_once जाँचता है कि फ़ाइल पहले से शामिल की जा चुकी है या नहीं, और दोहराव शामिल करना निष्पादित नहीं करता है। यह एक ही फ़ाइल को कई बार शामिल करने पर त्रुटियों को रोकता है।

यह भी देखें

फ़ंक्शन include,
जो फ़ाइलों को भी शामिल करता है, लेकिन उनके दोहराव शामिल करने की जाँच नहीं करता है
फ़ंक्शन include_once,
जो require_once के समान काम करता है, लेकिन फ़ाइल की अनुपस्थिति में घातक त्रुटि उत्पन्न नहीं करता है