Συνάρτηση include_once

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

Σύνταξη

phpinclude_once 'path/to/file.php';

Παράδειγμα

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

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

Παράδειγμα

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

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

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

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

Παράδειγμα

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

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

Δείτε επίσης

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