Funkcia require

Funkcia require pripája a vykonáva zadaný súbor v aktuálnom skripte. Na rozdiel od include, pri neprítomnosti súboru spôsobí fatálnu chybu a zastaví vykonávanie skriptu. Funkcia sa často používa na pripojenie dôležitých súborov s funkciami, triedami alebo nastaveniami.

Syntax

require 'path/to/file.php';

Príklad

Pripojenie súboru s nastaveniami:

<?php
	require 'config.php';
	echo $db_host; // Premenná z config.php
?>

Ak súbor config.php existuje, jeho obsah sa vykoná a premenné budú dostupné.

Príklad

Pokus o pripojenie neexistujúceho súboru:

<?php
	require 'missing_file.php';
	echo 'Tento riadok sa nevykoná';
?>

Ak súbor missing_file.php neexistuje, skript sa ukončí s chybou.

Rozdiel medzi require a include

Základný rozdiel je - require spôsobí fatálnu chybu pri neprítomnosti súboru, zatiaľ čo include iba varovanie.

<?php
	include 'optional_file.php'; // Skript bude pokračovať v práci
	require 'required_file.php'; // Skript sa zastaví pri chybe
?>

Pozrite tiež

funkciu include,
ktorá tiež pripája súbory, ale nezastaví skript pri chybe
funkciu require_once,
ktorá zaručuje jednorazové pripojenie súboru