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

phprequire 'path/to/file.php';

Példa

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

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