Funcția require

Funcția require conectează și execută fișierul specificat în scriptul curent. Spre deosebire de include, în absența fișierului, generează o eroare fatală și oprește executarea scriptului. Funcția este adesea folosită pentru a conecta fișiere importante cu funcții, clase sau setări.

Sintaxă

require 'path/to/file.php';

Exemplu

Conectarea unui fișier cu setări:

<?php
	require 'config.php';
	echo $db_host; // Variabilă din config.php
?>

Dacă fișierul config.php există, conținutul său va fi executat, iar variabilele vor deveni disponibile.

Exemplu

Încercarea de a conecta un fișier inexistent:

<?php
	require 'missing_file.php';
	echo 'Această linie nu se va executa';
?>

Dacă fișierul missing_file.php nu există, scriptul se va încheia cu eroare.

Diferența dintre require și include

Diferența principală este că require generează o eroare fatală în absența fișierului, în timp ce include generează doar un avertisment.

<?php
	include 'optional_file.php'; // Scriptul va continua să funcționeze
	require 'required_file.php'; // Scriptul se va opri la eroare
?>

Vezi și

funcția include,
care de asemenea conectează fișiere, dar nu oprește scriptul la eroare
funcția require_once,
care garantează conectarea unică a fișierului