require_once( )

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: require_once() dodano w PHP 4.0.1pl2

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