Funktsioon require

Funktsioon require ühendab ja käivitab määratud faili praeguses skriptis. Erinevalt include-st, põhjustab faili puudumisel fatal error ja peatab skripti täitmise. Funktsiooni kasutatakse sageli oluliste failide ühendamiseks funktsioonide, klasside või seadetega.

Süntaks

require 'path/to/file.php';

Näide

Seadete faili ühendamine:

<?php
	require 'config.php';
	echo $db_host; // Muutuja config.php-st
?>

Kui fail config.php on olemas, käivitatakse selle sisu ja muutujad muutuvad kättesaadavaks.

Näide

Katse ühendada olematut faili:

<?php
	require 'missing_file.php';
	echo 'See rida ei täiduta';
?>

Kui faili missing_file.php ei eksisteeri, lõpetab skript veaga.

Erinevus require ja include vahel

Põhiline erinevus - require põhjustab fatal error faili puudumisel, samas kui include ainult hoiatus.

<?php
	include 'optional_file.php'; // Skript jätkab tööd
	require 'required_file.php'; // Skript peatub vea korral
?>

Vaata ka

funktsiooni include,
mis samuti ühendab faile, kuid ei peata skripti vea korral
funktsiooni require_once,
mis tagab faili ühekordse ühendamise