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

require 'path/to/file.php';

Nümunə

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

<?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
	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
	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