Chcete-li připojit další soubor ke skriptu PHP, použijte speciální funkci include. Po připojení externího dokumentu má programátor možnost použít psaný kód nebo jiný obsah v aktuální aplikaci.
Zahrnout funkci
Zahrnout má následující syntaxi:
uveďte „název souboru“;
Název je relativní nebo absolutní cesta s příponou zahrnutého dokumentu. Pokud není zadáno žádné umístění, PHP automaticky zkontroluje obsah konfigurace php.ini, která specifikuje include_path - adresář, do kterého lze umístit další knihovny. Pokud je direktiva prázdná nebo požadovaný soubor není nalezen na cestě v ní určené, bude výraz include ignorován.
Po povolení můžete ve skriptu použít požadovaný obsah, přiřadit proměnné, použít deklarované konstrukce atd. Například existují 2 soubory 1.php a 2.php. Obsah 1.php vypadá takto:
<? php
$ firstly = „proměnná z prvního souboru“;
$ secondly = „importovaná hodnota“;
?>
Chcete-li do 2.php zahrnout výše uvedené proměnné, můžete provést následující operaci:
<? php
Zahrnout „1.php“;
echo $ za prvé;
$ emerge = „$ za druhé“;
echo $ emerge; ?>
V tomto skriptu druhého souboru obsahuje příkaz include obsah prvního dokumentu, poté se proměnné deklarované v 1.php použijí k zobrazení potřebných hodnot na obrazovce.
Zahrnout lze použít jak na samém začátku souboru, tak uvnitř deklarované funkce v kterékoli části dokumentu. Je nežádoucí používat tuto funkci k připojení souborů umístěných na vzdáleném serveru. Pokud chcete tuto funkci implementovat, budete muset povolit volbu allow_url_fopen v souboru php.ini na místním nebo vzdáleném serveru.
Vyžadovat
Funkce require je podobná jako v případě. Příkazy se neliší v syntaxi a technologii provádění. Jediný rozdíl je v tom, že pokud zadaný soubor chybí, require ukončí skript, zatímco include bude pokračovat ve spouštění skriptu a zobrazí odpovídající varování E_WARNING, které lze potlačit pomocí speciálního znaku @. Například:
<? php
požadovat „1q.php“;
echo „Skript přestane fungovat“; ?>
V tomto příkladu je zadána cesta k neexistujícímu dokumentu 1q.php. Pokud soubor chybí, skript neprovede příkaz echo a na obrazovce uživatele se zobrazí buď prázdný list, nebo chybová zpráva (v závislosti na nastavení php.ini). Pokud zadáte podobný kód pomocí include:
<? php
zahrnout „1q.php“;
echo „Skript pokračuje“; ?>
Spustí se příkaz echo a na displeji se zobrazí odpovídající text.