Funkce require

Funkce require připojí a provede určený soubor v aktuálním skriptu. Na rozdíl od include, při nepřítomnosti souboru vyvolá fatální chybu a zastaví provádění skriptu. Funkce je často používána pro připojení důležitých souborů s funkcemi, třídami nebo nastaveními.

Syntaxe

require 'path/to/file.php';

Příklad

Připojení souboru s nastaveními:

<?php
	require 'config.php';
	echo $db_host; // Proměnná z config.php
?>

Pokud soubor config.php existuje, jeho obsah bude proveden a proměnné se stanou dostupnými.

Příklad

Pokus o připojení neexistujícího souboru:

<?php
	require 'missing_file.php';
	echo 'Tento řádek se neprovede';
?>

Pokud soubor missing_file.php neexistuje, skript skončí s chybou.

Rozdíl mezi require a include

Základní rozdíl je - require vyvolá fatální chybu při nepřítomnosti souboru, zatímco include pouze varování.

<?php
	include 'optional_file.php'; // Skript bude pokračovat v práci
	require 'required_file.php'; // Skript se zastaví při chybě
?>

Viz také

funkci include,
která také připojuje soubory, ale nezastaví skript při chybě
funkci require_once,
která zaručuje jednorázové připojení souboru