Podręcznik PHP
Poprzedni
Rozdział 12.
Struktury kontrolne
Następny
require()
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.
Poprzedni
Spis treści
Następny
Początek rozdziału