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