include_once()

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