Συνάρτηση require

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

Σύνταξη

phprequire 'path/to/file.php';

Παράδειγμα

Σύνδεση αρχείου με ρυθμίσεις:

php<?php
  require 'config.php';
  echo $db_host; // Μεταβλητή από το config.php
?>

Εάν το αρχείο config.php υπάρχει, τα περιεχόμενά του θα εκτελεστούν και οι μεταβλητές θα γίνουν διαθέσιμες.

Παράδειγμα

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

php<?php
  require 'missing_file.php';
  echo 'This line will not execute';
?>

Εάν το αρχείο missing_file.php δεν υπάρχει, το script θα τερματιστεί με σφάλμα.

Διαφορά μεταξύ require και include

Η κύρια διαφορά είναι ότι η require προκαλεί μοιραίο σφάλμα σε περίπτωση απουσίας αρχείου, ενώ η include μόνο μια προειδοποίηση.

php<?php
  include 'optional_file.php'; // Το script θα συνεχίσει τη λειτουργία του
  require 'required_file.php'; // Το script θα σταματήσει σε περίπτωση σφάλματος
?>

Δείτε επίσης

  • την συνάρτηση include,
    που επίσης συνδέει αρχεία, αλλά δεν σταματά το script σε περίπτωση σφάλματος
  • την συνάρτηση require_once,
    που εγγυάται την εφάπαξ σύνδεση του αρχείου