include-funktio

Funktio include liittää ja suorittaa määritetyn tiedoston. Jos tiedostoa ei löydy, annetaan varoitus, mutta skriptin suoritus jatkuu. Funktio ottaa parametrina tiedoston polun.

Syntaksi

include 'path/to/file.php';

Esimerkki

Liitetään tiedosto header.php ja tulostetaan sen sisältö:

<?php
	include 'header.php';
?>

Esimerkki

Yritetään liittää olematonta tiedostoa:

<?php
	include 'nonexistent.php';
	echo "Script continues...";
?>

Koodin suorituksen tulos:

Warning: include(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Esimerkki

Liitetään tiedosto muuttujien kanssa ja käytetään niitä:

<?php
	// config.php sisältää: $siteName = "My Site";
	include 'config.php';
	echo $siteName;
?>

Koodin suorituksen tulos:

'My Site'

Katso myös

funktion require,
joka on samanlainen kuin include, mutta aiheuttaa vakavan virheen jos tiedostoa ei ole
funktion include_once,
joka liittää tiedoston vain kerran