Instrukcja
require(
)
służy
do
wczytania
i
wykonania
skryptu
z
określonego
pliku
.
require(
)
wczytuje
i
wykonuje
skrypt
z
podanego
pliku
.
Szczegółowa
informacja
odnośnie
tego
,
jak
działa
wczytywanie
opisana
jest
w
dokumentacji
dla
instrukcji
include(
)
.
Instrukcje
require(
)
i
include(
)
są
identyczne
w
każdym
szczególe
,
z
wyjątkiem
obsługi
błędów
.
W
razie
niepowodzenia
,
include(
)
generuje
ostrzeżenie
(
Warning
)
,
podczas
gdy
require(
)
generuje
błąd
krytyczny
(
Fatal
Error
)
.
Innymi
słowy
,
instrukcji
require(
)
Innymi
słowy
,
instrukcji
require(
)
używa
się
do
wczytywania
plików
,
które
są
niezbędne
do
działania
skryptu
i
w
przypadku
ich
braku
wykonywanie
skryptu
musi
zostać
przerwane
.
Instukcja
include(
)
Instukcja
include(
)
nie
zachowuje
się
w
ten
sposób
.
W
jej
przypadku
,
przy
braku
pliku
wykonywanie
skryptu
będzie
kontynuowane
.
Proszę
również
pamiętać
o
właściwym
ustawieniu
dyrektywy
konfiguracyjnej
include_path
.
Przykład
12-2
.
Podstawowe
przykłady
użycia
require(
)
?php
require
'
nagłówek.php'
;
require
$plik
;
require
('jakiś_plik.txt')
;
?
|
|
Więcej
przykładów
w
dokumentacji
instrukcji
include(
)
.
Notatka
:
Począwszy
od
PHP
4.0.2
,
zachowanie
instrukcji
jest
następujące
:
require(
)
będzie
zawsze
próbować
odczytać
plik
docelowy
,
nawet
jeśli
linia
w
której
ona
się
znajduje
nigdy
nie
zostanie
wykonana
.
Instrukcja
warunkowa
nie
wpływa
na
działanie
require(
)
.
Jednakże
,
jeśli
linia
,
w
której
pojawia
się
require(
)
nie
zostaje
wykonana
,
zawartość
pliku
wczytywanego
też
nie
zostaje
wykonana
.
Podobnie
,
instrukcje
pętli
nie
wpływają
na
działanie
require(
)
.
Chociaż
kod
zawarty
w
pliku
docelowy
wciąż
jest
podmiotem
pętli
,
require(
)
działa
tylko
raz
.
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_once(
)
,
include_once(
)
,
eval(
)
,
file(
)
,
readfile(
)
,
virtual(
)
i
include_path
.