Funkce require

Funkce require připojí a provede určený soubor v aktuálním skriptu. Na rozdíl od include, při nepřítomnosti souboru vyvolá fatální chybu a zastaví provádění skriptu. Funkce je často používána pro připojení důležitých souborů s funkcemi, třídami nebo nastaveními.

Syntaxe

phprequire 'path/to/file.php';

Příklad

Připojení souboru s nastaveními:

php<?php
  require 'config.php';
  echo $db_host; // Proměnná z config.php
?>

Pokud soubor config.php existuje, jeho obsah bude proveden a proměnné se stanou dostupnými.

Příklad

Pokus o připojení neexistujícího souboru:

php<?php
  require 'missing_file.php';
  echo 'Tento řádek se neprovede';
?>

Pokud soubor missing_file.php neexistuje, skript skončí s chybou.

Rozdíl mezi require a include

Základní rozdíl je - require vyvolá fatální chybu při nepřítomnosti souboru, zatímco include pouze varování.

php<?php
  include 'optional_file.php'; // Skript bude pokračovat v práci
  require 'required_file.php'; // Skript se zastaví při chybě
?>

Viz také