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 сияқты жұмыс істейді, бірақ файл жоқ болғанда фатальді қате түсірмейді