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
:
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(
)
.