Funktsioon require

Funktsioon require ühendab ja käivitab määratud faili praeguses skriptis. Erinevalt include-st, põhjustab faili puudumisel fatal error ja peatab skripti täitmise. Funktsiooni kasutatakse sageli oluliste failide ühendamiseks funktsioonide, klasside või seadetega.

Süntaks

phprequire 'path/to/file.php';

Näide

Seadete faili ühendamine:

php<?php
  require 'config.php';
  echo $db_host; // Muutuja config.php-st
?>

Kui fail config.php on olemas, käivitatakse selle sisu ja muutujad muutuvad kättesaadavaks.

Näide

Katse ühendada olematut faili:

php<?php
  require 'missing_file.php';
  echo 'See rida ei täiduta';
?>

Kui faili missing_file.php ei eksisteeri, lõpetab skript veaga.

Erinevus require ja include vahel

Põhiline erinevus - require põhjustab fatal error faili puudumisel, samas kui include ainult hoiatus.

php<?php
  include 'optional_file.php'; // Skript jätkab tööd
  require 'required_file.php'; // Skript peatub vea korral
?>

Vaata ka