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