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

require 'path/to/file.php';

Przykład

Podłączenie pliku z ustawieniami:

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