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

phpinclude 'path/to/file.php';

Esimerkki

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

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

Esimerkki

Yritetään liittää olematonta tiedostoa:

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

Koodin suorituksen tulos:

phpWarning: 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<?php
  // config.php sisältää: $siteName = "My Site";
  include 'config.php';
  echo $siteName;
?>

Koodin suorituksen tulos:

php'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