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

phpinclude_once 'path/to/file.php';

Esimerkki

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

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

Esimerkki

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

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

Koodin suorituksen tulos:

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

Esimerkki

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

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

Katso myös