Funkcja require

Funkcja require podłącza i wykonuje określony plik w bieżącym skrypcie. W przeciwieństwie do include, w przypadku braku pliku wywołuje błąd krytyczny i zatrzymuje wykonywanie skryptu. Funkcja jest często używana do podłączania ważnych plików z funkcjami, klasami lub ustawieniami.

Składnia

phprequire 'path/to/file.php';

Przykład

Podłączenie pliku z ustawieniami:

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

Jeśli plik config.php istnieje, jego zawartość zostanie wykonana, a zmienne staną się dostępne.

Przykład

Próba podłączenia nieistniejącego pliku:

php<?php
  require 'missing_file.php';
  echo 'This line will not execute';
?>

Jeśli plik missing_file.php nie istnieje, skrypt zakończy się błędem.

Różnica między require a include

Główna różnica polega na tym, że require wywołuje błąd krytyczny przy braku pliku, podczas gdy include tylko ostrzeżenie.

php<?php
  include 'optional_file.php'; // Skrypt będzie kontynuował działanie
  require 'required_file.php'; // Skrypt zatrzyma się przy błędzie
?>

Zobacz też

  • funkcję include,
    która również podłącza pliki, ale nie zatrzymuje skryptu przy błędzie
  • funkcję require_once,
    która gwarantuje jednokrotne podłączenie pliku