Sekä include että require tuovat (ja suorittavat) toisen PHP-tiedoston sisällön nykyiseen tiedostoon. Ainoa ero on, miten ne käsittelevät virheitä: require aiheuttaa fataalisen virheen, jos tiedosto puuttuu, kun taas include vain lähettää varoituksen ja jatkaa.
<?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
Käytä require tiedostoille, joita sovellus ei voi toimia ilman (ydinluokat, kriittiset konfiguraatiot, tietokannan asetukset) — haluat sen pysähtyvän kovasti, jos ne puuttuvat. Käytä include valinnaisten tiedostojen kohdalla (esim. sivupalkin malli), joissa puuttuva tiedosto ei saa kaataa sivua.
_once-variantit (vältetään kaksinkertainen sisällyttäminen)require_once "functions.php"; // include the file ONLY if not already included
include_once "helper.php";
require_once/include_once tuovat tiedoston vain, jos sitä ei ole jo tuotu — olennainen "cannot redeclare function/class" -virheiden välttämiseksi, kun tiedostoa saatetaan sisällyttää useita kertoja (esim. luokan määritelmä, jonka useat tiedostot tuovat).
// 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
Modernissa PHP:ssä sinä harvoin käytät manuaalista require luokkiin — Composerin autoloader lataa ne pyynnöstä. Silti käytät require "vendor/autoload.php" kerran sen käynnistämiseksi.
include vs require -eron ymmärtäminen on perustason, mutta tärkeää PHP-osaamista — ne ovat, miten PHP-tiedostot jakavat koodia, ja ero on merkityksellinen oikeellisuuden kannalta.
Avainpiste on virheenkäsittely: require olennaisille tiedostoille (jotta sovellus pysähtyy nopeasti ja selvästi, jos kriittinen tiedosto puuttuu) ja include valinnaisten tiedostojen kohdalla (jotta puuttuva ei-kriittinen tiedosto ei kaada sivua).
_once-varianttien tunteminen on käytännössä oleellista, jotta vältetään yleinen "cannot redeclare" -virhe, kun luokan tai funktion määritelmä vahingossa sisällytetään kahdesti.
Yhtä tärkeää on ymmärtää moderni konteksti: vaikka nämä konstruktiot ovat perustavanlaatuisia, moderni PHP nojaa Composerin autoloadingiin (luokkien lataaminen pyynnöstä) manuaalisen kunkin tiedoston vaatimisen sijaan, joten nykyisessä koodissa sisällytät enimmäkseen vain require "vendor/autoload.php" kerran ja jätät loput autoloadingille.
Include/require-mekanismien tunteminen (ja kun kunkin virhetilan käyttö on asianmukaista) sekä siitä, miten moderni autoloading korvaa manuaaliset sisällytykset, on päivittäistä osaamista sekä vanhojen että uusien PHP-koodikantojen kanssa työskennellessä.