Funktionen require

Funktionen require ansluter och kör den angivna filen i det aktuella skriptet. Till skillnad från include, orsakar den ett fatalt fel och stoppar skriptkörningen om filen saknas. Funktionen används ofta för att ansluta viktiga filer med funktioner, klasser eller inställningar.

Syntax

phprequire 'sökväg/till/fil.php';

Exempel

Anslutning av fil med inställningar:

php<?php
  require 'config.php';
  echo $db_host; // Variabel från config.php
?>

Om filen config.php finns kommer dess innehåll att köras och variablerna blir tillgängliga.

Exempel

Försök att ansluta en fil som inte finns:

php<?php
  require 'saknad_fil.php';
  echo 'Denna rad kommer inte att köras';
?>

Om filen saknad_fil.php inte finns, avslutas skriptet med ett fel.

Skillnad mellan require och include

Den grundläggande skillnaden är att require orsakar ett fatalt fel om filen saknas, medan include bara ger en varning.

php<?php
  include 'valfri_fil.php'; // Skriptet fortsätter att köras
  require 'obligatorisk_fil.php'; // Skriptet stoppas vid fel
?>

Se även

  • funktionen include,
    som också ansluter filer, men inte stoppar skriptet vid fel
  • funktionen require_once,
    som garanterar en engångsanslutning av filen