Συνάρτηση require

Η συνάρτηση require συνδέει και εκτελεί το καθορισμένο αρχείο στο τρέχον script. Σε αντίθεση με την include, σε περίπτωση απουσίας αρχείου προκαλεί μοιραίο σφάλμα και διακόπτει την εκτέλεση του script. Η συνάρτηση χρησιμοποιείται συχνά για τη σύνδεση σημαντικών αρχείων με συναρτήσεις, κλάσεις ή ρυθμίσεις.

Σύνταξη

require 'path/to/file.php';

Παράδειγμα

Σύνδεση αρχείου με ρυθμίσεις:

<?php
	require 'config.php';
	echo $db_host; // Μεταβλητή από το config.php
?>

Εάν το αρχείο config.php υπάρχει, τα περιεχόμενά του θα εκτελεστούν και οι μεταβλητές θα γίνουν διαθέσιμες.

Παράδειγμα

Προσπάθεια σύνδεσης μη υπάρχοντος αρχείου:

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

Εάν το αρχείο missing_file.php δεν υπάρχει, το script θα τερματιστεί με σφάλμα.

Διαφορά μεταξύ require και include

Η κύρια διαφορά είναι ότι η require προκαλεί μοιραίο σφάλμα σε περίπτωση απουσίας αρχείου, ενώ η include μόνο μια προειδοποίηση.

<?php
	include 'optional_file.php'; // Το script θα συνεχίσει τη λειτουργία του
	require 'required_file.php'; // Το script θα σταματήσει σε περίπτωση σφάλματος
?>

Δείτε επίσης

την συνάρτηση include,
που επίσης συνδέει αρχεία, αλλά δεν σταματά το script σε περίπτωση σφάλματος
την συνάρτηση require_once,
που εγγυάται την εφάπαξ σύνδεση του αρχείου