require w PHP

Słownik kwalifikacji INF.03 - Tworzenie i administrowanie stronami i aplikacjami internetowymi oraz bazami danych

require to instrukcja PHP służąca do dołączania pliku do skryptu, podobnie jak include. Wczytany plik jest wykonywany w miejscu użycia instrukcji.

Składnia

require("konfiguracja.php");

Instrukcja ta jest często używana do dołączania plików niezbędnych do działania aplikacji, np. konfiguracji połączenia z bazą danych, definicji klas lub ważnych funkcji.

Przykład

require("db.php");

$result = mysqli_query($conn, "SELECT * FROM uzytkownicy");

W tym przykładzie plik db.php może zawierać kod tworzący połączenie z bazą danych. Bez niego dalsza część skryptu nie miałaby sensu.

Różnica między include a require

Najważniejsza różnica dotyczy sytuacji, gdy plik nie istnieje lub nie może zostać wczytany:

  • include generuje ostrzeżenie i skrypt może działać dalej,
  • require powoduje błąd krytyczny i zatrzymuje wykonywanie skryptu.

Przykład:

require("brak_pliku.php");
echo "Ten tekst się nie wyświetli";

Jeżeli plik brak_pliku.php nie istnieje, skrypt zostanie przerwany.

Kiedy używać require?

require warto stosować wtedy, gdy dołączany plik jest konieczny do działania programu. Typowe przykłady to:

  • pliki konfiguracyjne,
  • pliki z połączeniem do bazy danych,
  • definicje klas,
  • biblioteki wymagane przez aplikację.

Wniosek egzaminacyjny

Zarówno include, jak i require dołączają pliki PHP, ale w pytaniach o proste „włączenie zawartości pliku” najczęściej poprawną odpowiedzią jest include, jeśli występuje wśród odpowiedzi.