Funkcija require

Funkcija require priključi in izvede določeno datoteko v trenutni skripti. Za razliko od include, pri odsotnosti datoteke povzroči fatalno napako in ustavi izvajanje skripte. Funkcija se pogosto uporablja za priključevanje pomembnih datotek s funkcijami, razredi ali nastavitvami.

Sintaksa

require 'path/to/file.php';

Primer

Priključevanje datoteke z nastavitvami:

<?php
	require 'config.php';
	echo $db_host; // Spremenljivka iz config.php
?>

Če datoteka config.php obstaja, bo njena vsebina izvedena in spremenljivke postanejo dostopne.

Primer

Poskus priključitve neobstoječe datoteke:

<?php
	require 'missing_file.php';
	echo 'Ta vrstica se ne bo izvedla';
?>

Če datoteka missing_file.php ne obstaja, se bo skripta končala z napako.

Razlika med require in include

Glavna razlika je - require povzroči fatalno napako pri odsotnosti datoteke, medtem ko include le opozorilo.

<?php
	include 'optional_file.php'; // Skripta bo nadaljevala z delom
	require 'required_file.php'; // Skripta se bo ustavila ob napaki
?>

Glejte tudi

funkcijo include,
ki prav tako priključi datoteke, vendar ne ustavi skripte ob napaki
funkcijo require_once,
ki zagotovi enkratno priključitev datoteke