include_once()

Az include_once() beilleszt és feldolgoz fájlokat a program futása közben. Ez hasonló az include() működéséhez, azzal a fontos különbséggel, hogy ha a már egyszer beillesztésre került kódot a PHP nem próbálja meg ismét betölteni.

Az include_once() használatos azokban az esetekben, amikor ugyanaz a fájl esetleg többször kerülhet beillesztésre a szkript futása során, de biztosítani kell, hogy ez ténylegesen csak egyszer történjen meg, így megelőzve a függvények újradefiniálását, változók értékének átállítását, stb.

További példákhoz az require_once() és include_once() használatához nézd meg a PEAR kódot, ami a legfrissebb PHP disztribúciókban megtalálható.

Megjegyzés: Az include_once() PHP 4.0.1pl2 verzióban került a nyelvbe.

Megjegyzés: Különös figyelemmel kell lenni arra, hogy hogyan viselkedik a a require_once() és a include_once() olyan operációs rendszereken, ahol az állománynevek nem nagybetűérzékenyek (mint pl. Windows)

Példa 12-9. require_once() nagybetűérzékeny

require_once("a.php"); // a.php kerül beillesztésre
require_once("A.php"); // ismét a.php kerül beillesztésre pl. Windows-on!

Figyelem

A PHP Windows rendszeren futó verziója jelenleg nem támogatja a távoli állomány elérést e függvény használatakor, még akkor sem, ha az allow_url_fopen engedélyezett.

Lásd még: include(), require(), require_once(), get_required_files(), get_included_files(), readfile() és virtual()!