include służy do dołączania i wykonania zawartości innego pliku PHP w aktualnym skrypcie. Jest często używane do dzielenia strony na części, np. nagłówek, menu, stopkę albo plik z funkcjami.
Składnia
include("egzamin.php");
Po wykonaniu tej instrukcji PHP wczytuje plik egzamin.php i traktuje jego zawartość tak, jakby znajdowała się dokładnie w miejscu wywołania include.
Przykład zastosowania
<!DOCTYPE html>
<html>
<body>
<?php include("menu.php"); ?>
<h1>Strona główna</h1>
<?php include("stopka.php"); ?>
</body>
</html>
Dzięki temu ten sam kod menu lub stopki można wykorzystać na wielu podstronach.
Co się stanie, gdy plik nie istnieje?
Jeżeli wskazany plik nie zostanie znaleziony, include wygeneruje ostrzeżenie typu warning, ale skrypt będzie próbował działać dalej.
include("brak_pliku.php");
echo "Dalsza część skryptu";
include a odczyt pliku
include nie służy tylko do zwykłego odczytania tekstu z pliku. Jeśli dołączany plik zawiera kod PHP, zostanie on wykonany.
Dla porównania:
include("plik.php")— dołącza i wykonuje kod PHP,fopen("plik.php")— otwiera plik do operacji na plikach,fgets()— odczytuje jedną linię z otwartego pliku.
W egzaminie
Jeśli pytanie brzmi: „włączyć do skryptu zawartość pliku z kodem PHP”, poprawną odpowiedzią jest zwykle:
include("nazwa_pliku.php");