Tiek include, tiek require importuoja (ir vykdo) kito PHP failo turinį į dabartinį. Vienintelis skirtumas yra tai, kaip jie tvarko klaidų situacijas: require sukelia kritinę klaidą, jei failas nerastas, o include tik išspausdina perspėjimą ir tęsia darbą.
<?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
Naudokite require failams, kurių programa negali veikti be jų (pagrindinės klasės, kritinės konfigūracijos, duomenų bazės sąranka) — norite, kad programa sustotų, jei jie trūksta. Naudokite include pasirinktiniams failams (pvz. šoninio meniu šablonas), kur trūkstamas failas neturėtų sugriūti puslapį.
_once variantai (išvengti dvigubo įtraukimo)require_once "functions.php"; // include the file ONLY if not already included
include_once "helper.php";
require_once/include_once importuoja failą tik jei jis dar nebuvo importuotas — būtina norint išvengti "cannot redeclare function/class" klaidų, kai failas gali būti įtrauktas kelis kartus (pvz. klasės apibrėžimas, kurio kreipiasi keli failai).
// 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
Modernoje PHP retai naudojate rankinius require klasėms — Composer's autoloader jas įkelia pagal poreikį. Jūs vis dar naudojate require "vendor/autoload.php" vieną kartą, kad inicijuotumėte jį.
include ir require supratimas yra pagrindinė, bet svarbi PHP žinios — tai yra kaip PHP failai dalina kodą, ir šis skirtumas svarbus teisingumui.
Pagrindinis punktas yra gedimo elgesys: require esmingiems failams (kad programa greitai ir aiškiai žlugtų, jei trūksta kritinio failo) ir include pasirinktiniams failams (kad trūkstamas nekritinis failas nesugriautų puslapio).
_once variantų žinojimas yra praktiškai būtinas, norint išvengti bendros "cannot redeclare" klaidos, kuri atsiranda netyčia įtraukiant klasės ar funkcijos apibrėžimą du kartus.
Čia pat svarbu suprasti ir modernų kontekstą: nors šios konstrukcijos yra pagrindinės, moderni PHP remiasi Composer autoloading'u (klasės įkeliamos pagal poreikį), o ne rankiniu kiekvieno failo reikalavimu, todėl dabartiniame kode jūs dažniausiai tiesiog require "vendor/autoload.php" vieną kartą ir leiskite autoloading'ui tvarkyti likusį darbą.
Žinojimas tiek apie include/require mechaniką (ir kada yra tinkamas kiekvienas gedimo režimas), tiek apie tai, kaip modernus autoloading pakeičia rankinius include's, yra kasdienė žinios, dirbant su senais ir naujais PHP kodų bazėmis.