Funkcija require_once

Funkcija require_once pievieno norādīto failu pašreizējā skriptā. Ja fails jau iepriekš bija pievienots, funkcija to vairs nepievienos. Tas ir īpaši noderīgi failu ar klasēm vai funkcijām pievienošanai, kur atkārtota pievienošana var izraisīt kļūdas.

Sintakse

require_once 'path/to/file.php';

Piemērs

Pievienosim failu config.php:

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

Koda izpildes rezultāts (ja config.php ir definēts masīvs $config):

'My Site'

Piemērs

Mēģinājums atkārtoti pievienot to pašu failu:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Šis izsaukums tiks ignorēts
	echo sum(2, 3);
?>

Koda izpildes rezultāts:

5

Atšķirība no require

Atšķirībā no require, funkcija require_once pārbauda, vai fails jau ir pievienots, un neveic atkārtotu pievienošanu. Tas novērš kļūdas, vairākkārtēji iekļaujot vienu un to pašu failu.

Skatiet arī

funkciju include,
kas arī pievieno failus, bet nepārbauda to atkārtotu iekļaušanu
funkciju include_once,
kas strādā līdzīgi kā require_once, bet neizraisa fatālu kļūdu, ja fails nav atrasts