Include - je to funkce v programovacím jazyce PHP, která umožňuje zahrnout obsah jiného souboru do aktuálního souboru. Je jednou ze základních funkcí PHP a používá se k efektivnější organizaci a strukturování kódu. Aplikace include umožňuje rozdělit velký Projekt na jednotlivé, snadno podporované komponenty.
Použití include v PHP je velmi jednoduché. K povolení obsahu souboru se používá následující syntaxe:
Funkce include se pokusí najít soubor se zadaným názvem v adresáři, kde se nachází aktuální spustitelný soubor. Pokud je soubor nalezen, jeho obsah bude zahrnut do aktuálního souboru. V případě neúspěchu funkce vrátí varování, ale spuštění kódu bude pokračovat.
Include také umožňuje zahrnout obsah souborů ze vzdálených zdrojů prostřednictvím zadání úplné adresy URL souboru. To může být užitečné například pro zahrnutí obsahu souborů z jiných domén.
Princip práce include v PHP
Include může být velmi užitečným nástrojem pro organizaci kódu. Umožňuje rozdělit kód na jednotlivé soubory, což usnadňuje jeho podporu a opětovné použití. Můžete například vytvořit samostatný soubor s funkcemi nebo třídami a poté pomocí funkce include přidat jeho obsah do požadovaného umístění projektu.
Funkce include může přijímat absolutní i relativní cesty k souborům. Absolutní cesta je úplná cesta k souboru na serveru, který začíná kořenovým adresářem. Relativní cesta je cesta k souboru vzhledem k aktuálnímu adresáři nebo souboru. Pokud je například soubor, který chcete povolit, ve stejném adresáři jako aktuální soubor, můžete jednoduše zadat jeho název do funkce include, aniž byste zadali cestu.
Pokud soubor, který chcete povolit, neexistuje nebo jej nelze přečíst, PHP vydá varování, ale skript bude pokračovat. To může být užitečné při ladění, ale je třeba dávat pozor, abyste nezahrnovali soubory, které by neměly být veřejně přístupné.
Povolení externích souborů
Chcete-li použít include, musíte zadat název souboru, který chcete povolit. Cestu k souboru lze zadat s ohledem na aktuální skript nebo pomocí celé cesty k souboru. Pokud soubor není nalezen, skript bude pokračovat v práci a vydá varování.
Příklad použití include:
Include lze také použít k povolení externích souborů pomocí adresy URL. V takovém případě je nutné před adresou URL souboru zadat příslušný protokol (např. http://).
Povolení souborů Vám umožňuje vytvářet knihovny funkcí nebo šablony pro opětovné použití kódu. Při zapínání externích souborů je však třeba být opatrní, zvláště pokud se jedná o vlastní vstup, aby se předešlo možným bezpečnostním problémům.
Vícenásobné inkluze
Include v PHP umožňuje zahrnout obsah externího souboru do aktuálního souboru. Pokud povolený soubor obsahuje chyby, zobrazí se také v aktuálním souboru. Ale co když chceme povolit více souborů?
V PHP je také funkce require, která funguje podobně jako include, ale pokud dojde k chybám, zastaví skript před opravou těchto chyb. V případě vnořených inkluze může být použití require bezpečnější.
Řekněme, že máme hlavní soubor index.php a také několik dalších souborů header.php, content.php a footer.php. Můžeme je zahrnout do hlavního souboru následovně:
Je důležité si uvědomit, že zahrnuté soubory musí být ve stejném adresáři jako aktuální soubor nebo musí být přístupné absolutní cestou.
Tímto způsobem můžeme rozdělit strukturu stránky na jednotlivé komponenty (čepice, obsah, sklep) a podle potřeby je připojit, díky čemuž je Kód organizovanější a zabrání opakování stejného kódu.
Funkce include má také schopnost přenášet data mezi soubory pomocí globálních proměnných. Je však třeba být opatrní s používáním globálních proměnných, protože mohou vést ke konfliktům a nečitelnému kódu.
Výsledkem je, že použití více inkluze v PHP pomáhá učinit kód modulárnějším a znovu použitelným. To umožňuje vytvářet projekty s lehčím a srozumitelnějším kódem.
Možnosti změny chování
Klíčové slovo include v PHP poskytuje několik možností, které vám umožní změnit jeho chování. Níže jsou uvedeny některé z těchto možností:
include_once: Tato možnost umožňuje povolit soubor pouze jednou. Pokud již byl soubor povolen, bude opětovné zapnutí ignorováno.
require: Na rozdíl od include tato možnost způsobí fatální chybu (E_COMPILE_ERROR) v případě, že soubor nelze povolit. To je užitečné, pokud chcete, aby bylo zahrnutí souboru povinné pro provoz programu.
require_once: Tato možnost funguje podobně jako require, ale soubor bude povolen pouze jednou.
Každá z těchto možností poskytuje větší flexibilitu a kontrolu při používání klíčového slova include v PHP. Chcete-li zvládnout všechny možnosti zapnutí souborů, doporučujeme prostudovat dokumentaci PHP.
Povolení souboru podle podmínky
Chcete-li povolit podmíněný soubor, můžete použít obvyklé příkazy pro správu spouštění kódu, jako je if, elseif a else.
Níže je uveden příklad použití include s podmíněným operátorem:
if ($условие) elseif ($другое_условие) else
V tomto příkladu, pokud je proměnná podmínka pravdivá, bude povolen soubor1.php. Pokud proměnná podmínka není pravdivá, ale druhá podmínka je pravdivá, bude povolen soubor2.php. Pokud není splněna žádná z podmínek, bude povolen soubor3.php.
Include lze také použít uvnitř cyklů nebo funkcí k dynamickému zapnutí souborů v závislosti na logice, kterou provádíte.
Zahrnutí souboru na podmínku je výkonný nástroj, který vám umožní vytvořit flexibilní a spravovaný kód, který vám umožní dosáhnout požadovaných výsledků v různých situacích.
Pokud používáte povolený soubor s podmínkou, je důležité sledovat zabezpečení a kontrolovat vstup, abyste zabránili neoprávněnému přístupu k souborům nebo spuštění škodlivého kódu útočníkem.
Návrat hodnoty z povoleného souboru
V PHP, při použití návrhu include k povolení souboru, vrácená hodnota tohoto souboru není uložena.
Existuje však způsob, jak vrátit hodnotu z povoleného souboru - použít konstrukci return . Pokud chceme získat výsledek provádění kódu z povoleného souboru, můžeme místo echo použít funkci include . Povolený soubor může obsahovat více hodnot, z nichž každá může být vrácena pomocí returnu .
Zde je příklad zahrnutého souboru example.php :
Chcete-li získat návratovou hodnotu ze souboru example.php v hlavním souboru, můžeme použít následující kód:
Výsledkem provedení zadaného kódu je hodnota proměnné $name ze souboru example.php bude přiřazeno proměnné $ result v hlavním souboru a bude staženo pomocí funkce echo .
Použití návrhu return tak umožňuje vrátit hodnotu ze zapnutého souboru a použít ji v hlavním souboru k následnému zpracování.