Instrukcja include_once() s│u┐y do wczytania i wykonania kodu z okre╢lonego pliku w trakcie wykonywania skryptu. Dzia│anie instrukcji podobne jest do include(), z jednym wyj▒tkiem, tzn. je╢li dany plik zosta│ ju┐ raz do danego skryptu wczytany, nie bΩdzie ju┐ wczytany ponownie. Wskazuje na to nazwa instrukcji: include_once znaczy wczytaj_raz.
include_once() powinno byµ stosowane w przypadkach, gdzie ten sam plik mo┐e byµ wczytany wiΩcej ni┐ raz w czasie wykonywania skryptu, ale ty chcesz mieµ pewno╢µ ┐e bΩdzie wczytany tylko jeden raz, aby unikn▒µ problem≤w z redefiniowaniem funkcji, nadpisaniem warto╢ci zmiennych, itp.
WiΩcej przyk│ad≤w wykorzystania require_once() i include_once() znajdziesz w kodzie PEAR do│▒czonym do najnowszych dystrybucji kodu ╝r≤d│owego PHP.
Notatka: include_once() dodano w PHP 4.0.1pl2
Notatka: ProszΩ pamiΩtaµ, ┐e require_once() oraz include_once() mog▒ zachowywaµ siΩ w spos≤b nieoczekiwany na systemach operacyjnych nierozr≤┐niaj▒cych wielko╢ci liter (non case-sensitive) - takich jak Windows.
Przyk│ad 12-9. include_once() zwraca uwagΩ na wielko╢µ liter
include_once("a.php"); // to wczyta plik a.php include_once("A.php"); // na Windows to ponownie wczyta a.php !
| Ostrze┐enie |
Wersja PHP pracuj▒ca pod systemami Windows nie obs│uguje dostΩpu do zdalnych plik≤w w tej funkcji, nawet je╢li opcja allow_url_fopen jest w│▒czona. |
Patrz tak┐e include(), require(), require_once(), get_required_files(), get_included_files(), readfile(), i virtual().