फ़ंक्शन include_once

फ़ंक्शन include_once वर्तमान PHP स्क्रिप्ट में निर्दिष्ट फ़ाइल को शामिल करता है, लेकिन केवल तभी जब इसे पहले शामिल नहीं किया गया हो। यह विशेष रूप से फ़ंक्शंस या क्लासेस की घोषणाओं वाली फ़ाइलों के साथ काम करते समय उपयोगी होता है, ताकि पुनः घोषणा की त्रुटियों से बचा जा सके। फ़ंक्शन के पैरामीटर में शामिल की जाने वाली फ़ाइल का पथ पास किया जाता है।

सिंटैक्स

include_once 'path/to/file.php';

उदाहरण

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

<?php
	include_once 'config.php';
	include_once 'config.php'; // इस कॉल को नजरअंदाज कर दिया जाएगा
?>

उदाहरण

मौजूद नहीं होने वाली फ़ाइल को शामिल करने का प्रयास:

<?php
	include_once 'nonexistent.php'; // चेतावनी उत्पन्न करेगा, लेकिन स्क्रिप्ट निष्पादन नहीं रोकेगा
	echo 'Script continues...';
?>

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

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

उदाहरण

पथ निर्दिष्ट करने के लिए वेरिएबल का उपयोग:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

यह भी देखें

फ़ंक्शन include,
जो बिना पुनः शामिल होने की जांच के फ़ाइल को शामिल करता है
फ़ंक्शन require,
जो त्रुटि होने पर स्क्रिप्ट को रोकते हुए फ़ाइल शामिल करता है
फ़ंक्शन require_once,
जो include_once की तरह काम करता है, लेकिन त्रुटि होने पर स्क्रिप्ट को रोक देता है