require funksiyası

require funksiyası göstərilən faylı cari skriptdə birləşdirir və icra edir. include-dən fərqli olaraq, faylın olmaması halında fatal xəta verir və skriptin icrasını dayandırır. Funksiya tez-tez funksiyalar, siniflər və ya konfiqurasiyalar kimi vacib faylları birləşdirmək üçün istifadə olunur.

Sintaksis

phprequire 'path/to/file.php';

Nümunə

Konfiqurasiya faylının birləşdirilməsi:

php<?php
  require 'config.php';
  echo $db_host; // config.php-dən dəyişən
?>

Əgər config.php faylı mövcuddursa, onun məzmunu icra olunacaq və dəyişənlər əlçatan olacaq.

Nümunə

Mövcud olmayan faylı birləşdirməyə cəhd:

php<?php
  require 'missing_file.php';
  echo 'This line will not execute';
?>

Əgər missing_file.php faylı mövcud deyilsə, skript xəta ilə başa çatacaq.

require və include arasındakı fərq

Əsas fərq odur ki, require faylın olmaması halında fatal xəta verir, include isə yalnız xəbərdarlıq verir.

php<?php
  include 'optional_file.php'; // Skript işləməyə davam edəcək
  require 'required_file.php'; // Xəta halında skript dayanacaq
?>

Həmçinin bax

  • include funksiyası,
    o da faylları birləşdirir, lakin xəta halında skripti dayandırmır
  • require_once funksiyası,
    o faylın bir dəfə birləşdirilməsini təmin edir