Instrukcja require_once() służy do wczytania i wykonania
kodu z określonego pliku w trakcie wykonywania skryptu. Zachowanie jej
jest identyczne z instrukcją require() z jednym
wyjątkiem, tzn. jeśli dany plik został już raz wczytany do tego skryptu,
nie będzie wczytany ponownie. Więcej informacji na temat działania tej
instrukcji w dokumentacji odnośnie require().
require_once() powinno być używane w przypadku, gdy ten
sam plik mógłby zostać wczytany i wykonany wielokrotnie, ale ty chcesz mieć
pewność, że zostanie wczytany dokładnie raz, aby uniknąć problemów z
redefiniowaniem funkcji, nadpisywaniem zmiennych itp.
Przykłady użycia require_once() i
include_once() znajdują się w kodzie
PEAR dołączonym do najnowszych
dystrubucji kodu źródłowego PHP.
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 16-8. require_once() zwraca uwagę na wielkość
liter
require_once("a.php"); // to wczyta plik a.php
require_once("A.php"); // na Windows to ponownie wczyta a.php !
|
|
| Ostrzeżenie |
PHP w
wersji starszej niż 4.3.0, pracujące pod kontrolą systemów Windows, nie
obsługują dostępu do zdalnych plików w tej funkcji, nawet jeśli opcja allow_url_fopen jest
włączona. |
Patrz także: require(),
include(), include_once(),
get_required_files(),
get_included_files(), readfile(),
i virtual().
Ładowanie w toku ...