Funktio include_once

Funktio include_once sisällyttää määritetyn tiedoston nykyiseen PHP-skriptiin, mutta vain jos sitä ei ole sisällytetty aiemmin. Tämä on erityisen hyödyllistä käsiteltäessä tiedostoja, jotka sisältävät funktioiden tai luokkien määritelmiä, välttääkseen toistuvan määrittelyn virheitä. Funktiolle välitetään parametrina polku sisällytettävään tiedostoon.

Syntaksi

include_once 'path/to/file.php';

Esimerkki

Sisällytetään tiedosto config.php vain kerran:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Tämä kutsu jätetään huomiotta
?>

Esimerkki

Yritetään sisällyttää olematon tiedosto:

<?php
	include_once 'nonexistent.php'; // Aiheuttaa varoituksen, mutta ei pysäytä skriptin suoritusta
	echo 'Skripti jatkuu...';
?>

Koodin suorituksen tulos:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Skripti jatkuu...

Esimerkki

Muuttujan käyttö polun määrittämiseen:

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

Katso myös

funktion include,
joka sisällyttää tiedoston ilman tarkistusta toistuvasta sisällytyksestä
funktion require,
joka sisällyttää tiedoston ja pysäyttää skriptin virheen sattuessa
funktion require_once,
joka toimii kuten include_once, mutta pysäyttää skriptin virheen sattuessa