Az include_once függvény

Az include_once függvény a megadott fájlt behúzza az aktuális PHP szkriptbe, de csak akkor, ha azt korábban még nem húzták be. Ez különösen hasznos olyan fájlok esetén, amelyek függvény- vagy osztálydeklarációkat tartalmaznak, hogy elkerüljük az ismétlődő deklarálási hibákat. A függvény paramétereként a behúzandó fájl elérési útját adjuk meg.

Szintaxis

include_once 'path/to/file.php';

Példa

A config.php fájl behúzása csak egyszer:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Ez a hívás figyelmen kívül marad
?>

Példa

Megpróbálunk egy nem létező fájlt behúzni:

<?php
	include_once 'nonexistent.php'; // Figyelmeztetést generál, de nem állítja le a szkript végrehajtását
	echo 'A szkript folytatódik...';
?>

A kód végrehajtásának eredménye:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
A szkript folytatódik...

Példa

Változó használata az elérési út megadásához:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Lásd még

a(z) include függvényt,
amely fájlt húz be az ismétlődő behúzás ellenőrzése nélkül
a(z) require függvényt,
amely fájlt húz be, és hibánál leállítja a szkript végrehajtását
a(z) require_once függvényt,
amely úgy működik, mint az include_once, de hibánál leállítja a szkriptet