require-funktio

require-funktio liittää ja suorittaa määritetyn tiedoston nykyisessä skriptissä. Toisin kuin include, se aiheuttaa vakavan virheen tiedoston puuttuessa ja keskeyttää skriptin suorituksen. Funktiota käytetään usein tärkeiden funktioita, luokkia tai asetuksia sisältävien tiedostojen liittämiseen.

Syntaksi

phprequire 'path/to/file.php';

Esimerkki

Asetustiedoston liittäminen:

php<?php
  require 'config.php';
  echo $db_host; // Muuttuja config.php-tiedostosta
?>

Jos tiedosto config.php on olemassa, sen sisältö suoritetaan ja muuttujat tulevat saataville.

Esimerkki

Yritys liittää olematon tiedosto:

php<?php
  require 'missing_file.php';
  echo 'Tätä riviä ei suoriteta';
?>

Jos tiedostoa missing_file.php ei ole olemassa, skripti päättyy virheeseen.

Ero require- ja include-funktioiden välillä

Pääasiallinen ero on, että require aiheuttaa vakavan virheen tiedoston puuttuessa, kun taas include aiheuttaa vain varoituksen.

php<?php
  include 'optional_file.php'; // Skripti jatkaa toimintaansa
  require 'required_file.php'; // Skripti pysähtyy virheeseen
?>

Katso myös