Συνάρτηση include_once

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

Σύνταξη

include_once 'path/to/file.php';

Παράδειγμα

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

<?php
	include_once 'config.php';
	include_once 'config.php'; // Αυτή η κλήση θα αγνοηθεί
?>

Παράδειγμα

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

<?php
	include_once 'nonexistent.php'; // Θα προκαλέσει προειδοποίηση, αλλά δεν θα σταματήσει την εκτέλεση του script
	echo 'Το script συνεχίζει...';
?>

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

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Το script συνεχίζει...

Παράδειγμα

Χρήση μεταβλητής για καθορισμό διαδρομής:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Δείτε επίσης

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