require_once()

require_once() funkcija vključi in preveri določeno datoteko med izvajanjem skripte. Obnašanje te funkcije je podobno funkciji require(), le da le-ta, če je datoteka že vključena, ne vključi datoteke ponovno. Poglejte si dokumentacijo funkcije require() za več informacij o delovanju te funkcije.

Funkcijo require_once() je najbolje uporabljati v primerih, kjer bi se lahko zgodilo, da bi datoteka lahko bila vključena večkrat. Z uporabo te funkcije zagotovite, da bo datoteka vključena samo enkrat, s čimer se izognete morebitnim redefinicijam funkcij, spreminjanje vrednosti spremenljivk, ipd.

Za primer uporabe funkcij require_once() in include_once(), si oglejte PEAR kodo, ki je vključena v zadnjo PHP distribucijo.

Opomba: require_once() funkcija je bila dodana v PHP 4.0.1pl2

Opomba: Bodite pozorni na obnašanje funkcij require_once() in include_once() v operacijskih sistemih, ki ne ločujejo malih črk od velikih (kot naprimer Windows).

Primer 11-8. require_once() is case sensitive

require_once("a.php"); // to bo vkljucilo datoteko a.php
require_once("A.php"); // to bo na Windowsih ponovno vkljucilo datoteko a.php

Pozor

Različica PHP za okolje Windows trenutno ne podpira odpiranja oddaljenih datotek, tudi če je nastavitev allow_url_fopen vklopljena.

Poglejte si: require(), include(), include_once(), get_required_files(), get_included_files(), readfile(), in virtual().