Ak chcete k skriptu PHP pripojiť ďalší súbor, použite špeciálnu funkciu include. Po pripojení externého dokumentu má programátor možnosť použiť napísaný kód alebo iný obsah aktuálnej aplikácie.
Zahrnúť funkciu
Zahrnúť má nasledujúcu syntax:
uveďte „názov súboru“;
Názov je relatívna alebo absolútna cesta s rozšírením zahrnutého dokumentu. Ak nie je zadané žiadne umiestnenie, PHP automaticky skontroluje obsah konfigurácie php.ini, ktorá určuje include_path - adresár, do ktorého je možné umiestniť ďalšie knižnice. Ak je smernica prázdna alebo sa požadovaný súbor nenachádza na ceste v nej uvedenej, výraz zahrnutia bude ignorovaný.
Po povolení môžete v skripte použiť požadovaný obsah, priradiť premenné, použiť deklarované konštrukty atď. Napríklad existujú 2 súbory 1.php a 2.php. Obsah 1.php vyzerá takto:
<? php
$ firstly = „premenná z prvého súboru“;
$ secondly = „importovaná hodnota“;
?>
Ak chcete zahrnúť vyššie uvedené premenné do 2.php, môžete vykonať nasledujúcu operáciu:
<? php
Zahrnúť „1.php“;
echo $ ako prvé;
$ emerge = „$ za druhé“;
echo $ emerge; ?>
V tomto skripte druhého súboru obsahuje príkaz include obsah prvého dokumentu, potom sa premenné deklarované v 1.php použijú na zobrazenie potrebných hodnôt na obrazovke.
Zahrnutie je možné použiť na samom začiatku súboru aj vo vnútri deklarovanej funkcie v ktorejkoľvek časti dokumentu. Je nežiaduce používať túto funkciu na pripojenie súborov umiestnených na vzdialenom serveri. Ak chcete implementovať túto funkciu, budete musieť povoliť voľbu allow_url_fopen v súbore php.ini na vašom lokálnom alebo vzdialenom serveri.
Vyžadovať
Funkcia require je podobná ako zahrnutie. Príkazy sa nelíšia v syntaxi a technológii vykonania. Jediný rozdiel je v tom, že ak uvedený súbor chýba, require ukončí skript, zatiaľ čo include bude pokračovať v vykonávaní skriptu a zobrazí príslušné varovanie E_WARNING, ktoré je možné potlačiť pomocou špeciálneho znaku @. Napríklad:
<? php
požadovať „1q.php“;
echo „Skript prestane fungovať“; ?>
V tomto príklade je určená cesta k neexistujúcemu dokumentu 1q.php. Ak súbor chýba, skript nevykoná príkaz echo a na obrazovke používateľa sa zobrazí buď prázdny hárok, alebo chybové hlásenie (v závislosti od nastavení php.ini). Ak zadáte podobný kód pomocou príkazu include:
<? php
zahrnúť „1q.php“;
echo „Skript pokračuje“; ?>
Vykoná sa príkaz echo a na displeji sa zobrazí zodpovedajúci text.
