Funkcija require_once

Funkcija require_once prijungia nurodytą failą į esamą scenarijų. Jei failas jau buvo prijungtas anksčiau, funkcija jo vėl neprijungs. Tai ypač naudinga prijungiant failus su klasėmis ar funkcijomis, kur pakartotinis prijungimas gali sukelti klaidas.

Sintaksė

require_once 'path/to/file.php';

Pavyzdys

Prijunkime failą config.php:

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

Kodo vykdymo rezultatas (jei config.php faile apibrėžtas masyvas $config):

'Mano svetainė'

Pavyzdys

To paties failo pakartotinio prijungimo bandymas:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Šis kreipimasis bus ignoruojamas
	echo sum(2, 3);
?>

Kodo vykdymo rezultatas:

5

Skirtumas nuo require

Skirtingai nuo require, funkcija require_once tikrina, ar failas jau buvo prijungtas, ir nevykdo pakartotinio prijungimo. Tai užkerta kelią klaidoms, kai tas pats failas įtraukiamas kelis kartus.

Taip pat žiūrėkite

funkciją include,
kuri taip pat prijungia failus, bet netikrina jų pakartotinio įtraukimo
funkciją include_once,
kuri veikia analogiškai kaip require_once, bet nesukelia fatalios klaidos, jei failo nėra