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ă

phprequire 'path/to/file.php';

Exemplu

Conectarea unui fișier cu setări:

php<?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<?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<?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