include_once()

Η δήλωση include_once() περιλαμβάνει και υπολογίζει το συγκεκριμένο αρχείο κατά τη διάρκεια της εκτέλεσης του script. Αυτή η συμπεριφορά είναι όμοια με τη δήλωση include() , με τη μόνη διαφορά ότι αν ο κώδικας από ένα αρχείο έχει ήδη συμπεριληφθεί, δε θα ξανασυμπεριληφθεί. Όπως λέει και το όνομα του, θα συμπεριληφθεί μόνο μια φορά.

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

Για περισσότερα παραδείγματα σχετικά με τη χρήση της require_once() και της include_once(), δείτε στο » PEAR κομμάτι κώδικα που συμπεριλαμβάνεται στην τελευταία έκδοση του source code της PHP.

Note: Η include_once() προστέθηκε στην PHP 4.0.1pl2

Note: Προσέξτε ότι η συμπεριφορά της require_once() και της include_once() μπορεί να μην είναι αυτή που περιμένετε σε ένα λειτουργικό σύστημα που δεν είναι case sensitive (όπως τα Windows).

Example#1 Η include_once() είναι case sensitive

<?php
include_once("a.php"); // this will include a.php
include_once("A.php"); // this will include a.php again on Windows!
?>

Δείτε επίσης τιςinclude(), require(), require_once(), get_required_files(), get_included_files(), readfile(), και virtual().