Funktionen require

Funktionen require tilføjer og udfører den angivne fil i det aktuelle script. I modsætning til include, forårsager den en fatal fejl og stopper udførelsen af scriptet, hvis filen mangler. Funktionen bruges ofte til at tilføje vigtige filer med funktioner, klasser eller indstillinger.

Syntaks

phprequire 'path/to/file.php';

Eksempel

Tilføjelse af en fil med indstillinger:

php<?php
  require 'config.php';
  echo $db_host; // Variabel fra config.php
?>

Hvis filen config.php eksisterer, vil dens indhold blive udført, og variablerne bliver tilgængelige.

Eksempel

Forsøg på at tilføje en ikke-eksisterende fil:

php<?php
  require 'missing_file.php';
  echo 'Denne linje vil ikke blive udført';
?>

Hvis filen missing_file.php ikke eksisterer, vil scriptet afsluttes med en fejl.

Forskellen mellem require og include

Hovedforskellen er, at require forårsager en fatal fejl, hvis filen mangler, hvorimod include kun giver en advarsel.

php<?php
  include 'optional_file.php'; // Scriptet fortsætter
  require 'required_file.php'; // Scriptet stopper ved fejl
?>

Se også

  • funktionen include,
    som også tilføjer filer, men ikke stopper scriptet ved en fejl
  • funktionen require_once,
    som garanterer, at filen kun tilføjes een gang