ფუნქცია 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-ის მსგავსად, მაგრამ ჩერდება შეცდომის შემთხვევაში