Funkcija include_once() vključi in preveri določeno datoteko med izvajanjem skripte. Obnašanje je podobno kot pri funkciji include(), le da le-ta, če je datoteka že vključena, ne vključi datoteke ponovno. Kar vam pove že samo ime.
Funkcijo include_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 več primerov uporabe funkcij require_once() in include_once(), si oglejte PEAR kodo, ki je vključena v najnovejši PHP distribuciji.
Opomba: include_once() funkcija je bila dodana v PHP 4.0.1pl2
Opomba: Bodite pozorni na obnašanje funkcij include_once() in require_once() v operacijskih sistemih, ki ne ločujejo malih črk od velikih (kot naprimer Windows).
Primer 11-9. include_once() is case sensitive
include_once("a.php"); // to bo vkljucilo datoteko a.php
include_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 tudi include(), require(), require_once(), get_required_files(), get_included_files(), readfile(), in virtual().