require_once()

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

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

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

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

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

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

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

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