A require függvény

A require függvény csatolja és végrehajtja a megadott fájlt az aktuális szkriptben. A include-tól eltérően, ha a fájl nem található, halálos hibát okoz és leállítja a szkript végrehajtását. A függvényt gyakran használják fontos fájlok, például függvényekkel, osztályokkal vagy beállításokkal való csatolására.

Szintaxis

require 'path/to/file.php';

Példa

Beállításokat tartalmazó fájl csatolása:

<?php
	require 'config.php';
	echo $db_host; // Változó a config.php-ből
?>

Ha a config.php fájl létezik, annak tartalma végrehajtódik, és a változók elérhetővé válnak.

Példa

Megpróbál egy nem létező fájlt csatolni:

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

Ha a missing_file.php fájl nem létezik, a szkript hibával fog megállni.

Különbség a require és include között

Az alapvető különbség az, hogy a require halálos hibát okoz a fájl hiányában, míg a include csak figyelmeztetést.

<?php
	include 'optional_file.php'; // A szkript folytatja a működést
	require 'required_file.php'; // A szkript leáll hibánál
?>

Lásd még

a include függvényt,
ami szintén csatol fájlokat, de nem állítja le a szkriptet hibánál
a require_once függvényt,
ami garantálja a fájl egyszeri csatolását