Funkcija require_once

Funkcija require_once priključi navedeno datoteko v trenutno skripto. Če je bila datoteka že prej priključena, je funkcija ne bo priključila znova. To je še posebej uporabno za priključevanje datotek z razredi ali funkcijami, kjer lahko ponovno priključitev povzroči napake.

Sintaksa

require_once 'path/to/file.php';

Primer

Priključimo datoteko config.php:

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

Rezultat izvajanja kode (če je v config.php definiran array $config):

'My Site'

Primer

Poskus ponovnega priključevanja iste datoteke:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Ta klic bo ignoriran
	echo sum(2, 3);
?>

Rezultat izvajanja kode:

5

Razlika od require

Za razliko od require, funkcija require_once preveri, ali je bila datoteka že priključena, in ne izvede ponovnega priključevanja. To prepreči napake pri večkratnem vključevanju iste datoteke.

Glejte tudi

funkcijo include,
ki prav tako priključuje datoteke, vendar ne preverja njihovega ponovnega vključevanja
funkcijo include_once,
ki deluje podobno kot require_once, vendar ne povzroči fatalne napake, če datoteka ni najdena