Funktio require_once

Funktio require_once liittää määritetyn tiedoston nykyiseen skriptiin. Jos tiedosto on jo aiemmin liitetty, funktio ei liitä sitä uudelleen. Tämä on erityisen hyödyllistä luokkia tai funktioita sisältävien tiedostojen liittämisessä, missä uudelleen liittäminen voi aiheuttaa virheitä.

Syntaksi

require_once 'path/to/file.php';

Esimerkki

Liitetään tiedosto config.php:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Koodin suorituksen tulos (jos config.php-tiedostossa on määritelty $config-taulukko):

'My Site'

Esimerkki

Yritetään liittää sama tiedosto uudelleen:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Tätä kutsumusta ei huomioida
	echo sum(2, 3);
?>

Koodin suorituksen tulos:

5

Ero requireen

Toisin kuin require, funktio require_once tarkistaa, onko tiedosto jo liitetty, eikä suorita uudelleen liittämistä. Tämä estää virheet, kun sama tiedosto sisällytetään useita kertoja.

Katso myös

funktion include,
joka myös liittää tiedostoja, mutta ei tarkista niiden uudelleen sisällyttämistä
funktion include_once,
joka toimii samoin kuin require_once, mutta ei aiheuta vakavaa virhettä, jos tiedostoa ei ole