require-funktio

require-funktio liittää ja suorittaa määritetyn tiedoston nykyisessä skriptissä. Toisin kuin include, se aiheuttaa vakavan virheen tiedoston puuttuessa ja keskeyttää skriptin suorituksen. Funktiota käytetään usein tärkeiden funktioita, luokkia tai asetuksia sisältävien tiedostojen liittämiseen.

Syntaksi

require 'path/to/file.php';

Esimerkki

Asetustiedoston liittäminen:

<?php
	require 'config.php';
	echo $db_host; // Muuttuja config.php-tiedostosta
?>

Jos tiedosto config.php on olemassa, sen sisältö suoritetaan ja muuttujat tulevat saataville.

Esimerkki

Yritys liittää olematon tiedosto:

<?php
	require 'missing_file.php';
	echo 'Tätä riviä ei suoriteta';
?>

Jos tiedostoa missing_file.php ei ole olemassa, skripti päättyy virheeseen.

Ero require- ja include-funktioiden välillä

Pääasiallinen ero on, että require aiheuttaa vakavan virheen tiedoston puuttuessa, kun taas include aiheuttaa vain varoituksen.

<?php
	include 'optional_file.php'; // Skripti jatkaa toimintaansa
	require 'required_file.php'; // Skripti pysähtyy virheeseen
?>

Katso myös

funktion include,
joka myös liittää tiedostoja, mutta ei keskeytä skriptiä virhetilanteessa
funktion require_once,
joka takaa tiedoston kertaluontoisen liittämisen