Συνάρτηση require_once

Η συνάρτηση require_once συνδέει το καθορισμένο αρχείο στο τρέχον σενάριο. Αν το αρχείο έχει ήδη συνδεθεί προηγουμένως, η συνάρτηση δεν θα το συνδέσει ξανά. Αυτό είναι ιδιαίτερα χρήσιμο για τη σύνδεση αρχείων με κλάσεις ή συναρτήσεις, όπου η επαναλαμβανόμενη σύνδεση μπορεί να προκαλέσει σφάλματα.

Σύνταξη

require_once 'path/to/file.php';

Παράδειγμα

Ας συνδέσουμε το αρχείο config.php:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Αποτέλεσμα εκτέλεσης κώδικα (αν στο config.php έχει οριστεί ο πίνακας $config):

'My Site'

Παράδειγμα

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

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Αυτή η κλήση θα αγνοηθεί
	echo sum(2, 3);
?>

Αποτέλεσμα εκτέλεσης κώδικα:

5

Διαφορά από τη require

Σε αντίθεση με τη require, η συνάρτηση require_once ελέγχει αν το αρχείο έχει ήδη συνδεθεί, και δεν εκτελεί επαναλαμβανόμενη σύνδεση. Αυτό αποτρέπει σφάλματα κατά τη πολλαπλή συμπερίληψη του ίδιου αρχείου.

Δείτε επίσης

τη συνάρτηση include,
που συνδέει επίσης αρχεία, αλλά δεν ελέγχει την επαναλαμβανόμενη συμπερίληψή τους
τη συνάρτηση include_once,
που λειτουργεί ανάλογα με τη require_once, αλλά δεν προκαλεί μοιραίο σφάλμα σε περίπτωση απουσίας αρχείου