Mind az include, mind a require importálja (és végrehajtja) egy másik PHP fájl tartalmát az aktuális fájlba. Az egyetlen különbség az, hogy hogyan kezelik a hibákat: a require végzetes hibát vált ki, ha a fájl hiányzik, míg az include csak egy figyelmeztetést ad ki és folytatja a futást.
<?php
include "config.php"; // if missing → WARNING, script CONTINUES
require "database.php"; // if missing → FATAL ERROR, script STOPS
include → file missing → emits a Warning, execution continues (file's code skipped)
require → file missing → throws a Fatal Error, execution HALTS
Használja a require olyan fájlokhoz, amelyek nélkülözhetetlenek az alkalmazás futásához (alapvető osztályok, kritikus konfigurációs fájlok, adatbázis beállítás) — azt szeretnéd, hogy határozottan leálljon, ha hiányzanak. Használja az include nem kötelező fájlokhoz (pl. oldalsáv sablon), ahol a hiányzó fájl nem szabad, hogy összeomlassza az oldalt.
_once variánsok (kettős befoglalás megakadályozása)require_once "functions.php"; // include the file ONLY if not already included
include_once "helper.php";
A require_once/include_once csak akkor importálja a fájlt, ha már nem lett importálva — lényeges a "cannot redeclare function/class" hibák elkerüléséhez, amikor egy fájlt többször is bevonhatnak (pl. egy osztálydefiníció, amelyet több fájl húz be).
// included files share the SAME scope and can define functions, classes, variables
// config.php:
$dbHost = "localhost";
// main.php:
require "config.php";
echo $dbHost; // "localhost" — the variable is available
// ❌ old style — manually requiring every class file
require_once "User.php";
require_once "Order.php";
// ✅ modern — Composer AUTOLOADING loads classes on demand automatically
require "vendor/autoload.php"; // one line; classes load when used (PSR-4)
$user = new User(); // User.php loaded automatically
A modern PHP-ban ritkán használsz manuális require-t osztályokhoz — a Composer autoloadere igény szerinti betölti őket. Még mindig szükséged van az require "vendor/autoload.php" egyszeri meghívására az inicializáláshoz.
Az include kontra require megértése alapvető, de fontos PHP tudás — így osztják meg a PHP fájlok a kódot, és a különbség lényeges a helyesség szempontjából.
A kulcspont a hibakezelés viselkedése: require az alapvető fájlokhoz (hogy az alkalmazás gyorsan és egyértelműen meghiúsuljon, ha egy kritikus fájl hiányzik) és include az opcionális fájlokhoz (hogy a hiányzó nem kritikus fájl ne omlassza össze az oldalt).
A _once variánsok ismerete gyakorlatilag alapvető a gyakori "cannot redeclare" hibák megakadályozásához, amelyek abból adódnak, hogy véletlenül egy osztályt vagy függvénydefiníciót kétszer vonunk be.
Egyaránt fontos a modern kontextus megértése: bár ezek az alapvető konstruktok, a modern PHP a Composer autoloading-ra támaszkodik (osztályok igény szerinti betöltése) a manuális fájl-require helyett, így az aktuális kódban általában csak egyszer require "vendor/autoload.php"-t használsz, és az autoloading kezeli a többit.
Az include/require mechanika (és hogy mikor melyik hibamód alkalmas) és a modern autoloading manuális include-ok felváltásának ismerete mindennapi tudás a régi és új PHP kódbázisokkal végzett munkához.