Konstrukt include_once() vloží a ohodnotí specifikovaný
soubor během provádění skriptu. Chová se tedy podobně jako
include() , s tím rozdílem, že pokud už byl kód ze
souboru dříve vložen do skriptu, nebude znovu vkládán. Jak název napovídá,
bude vložen právě jednou.
Příkaz include_once() by se měl používat v případech,
kde by mohl být během provádění skriptu tentýž soubor vložen a ohodnocen
víckrát, a přitom chcete zajistit právě jedno vložení (je třeba se vyhnout
redefinicím funkcí, novému přiřazení hodnot atd.).
Příklady na použití require_once() and
include_once() najdete v kódu
PEAR přiloženém v nejnovějších
distribucích zdrojových kódů PHP.
Viz také include(),
require(), require_once(),
get_required_files(),
get_included_files(), readfile(),
a virtual().