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
12-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
|
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
:
require(
)
,
include(
)
,
include_once(
)
,
get_required_files(
)
,
get_included_files(
)
,
readfile(
)
,
i
virtual(
)
.