Vključevanje zunanjih datotek v PHP z ukazom INCLUDE
Ukaza include in include_once
PHP omogoča vključevanje kode iz zunanjih datotek. Tak način je zelo uporaben, kadar želimo isto vsebino ali isto kodo uporabiti na več straneh, na primer pri menijih, glavi strani, nogi strani ali skupnih funkcijah.
Z vključevanjem zunanjih datotek zmanjšamo podvajanje kode, izboljšamo preglednost projekta in poenostavimo vzdrževanje spletne aplikacije.
Osnovna pravila
includevključi in izvede zunanjo datoteko na mestu, kjer je zapisan.include_oncedeluje podobno, vendar isto datoteko v istem izvajanju skripte vključi samo enkrat.- Pri vključevanju moramo uporabljati pravilne poti do datotek.
- Za dele kode, ki se lahko pojavijo večkrat ali niso obvezni za delovanje, pogosto uporabimo
include. - Za datoteke s funkcijami, razredi ali drugo kodo, ki ne sme biti vključena večkrat, uporabimo
include_once.
Ukaz include
Ukaz include vključi in izvede zunanjo datoteko na mestu, kjer je zapisan. Tako lahko isto datoteko uporabimo na več straneh in se izognemo ponavljanju enake kode.
Ta ukaz je primeren predvsem za skupne dele strani, ki niso nujno obvezni za samo izvajanje programa, na primer za meni, glavo strani, nogo strani ali nekatere skupne izpise.
Ukaz include_once
Ukaz include_once deluje podobno kot include, vendar poskrbi, da se ista datoteka v istem izvajanju skripte vključi samo enkrat.
To je posebej uporabno pri datotekah s funkcijami, razredi, konstantami ali drugimi elementi, ki jih ne smemo vključiti večkrat, ker bi to lahko povzročilo napake.
Primerjava include in include_once
| Lastnost | include | include_once |
|---|---|---|
| Osnovni namen | vključevanje zunanje datoteke | vključevanje zunanje datoteke samo enkrat |
| Večkratna vključitev iste datoteke | je mogoča | je preprečena |
| Primerna uporaba | meni, glava, noga, skupni izpisi | funkcije, razredi, konstante, skupna logika |
Pot do vključene datoteke
Datoteke vključujemo glede na podano pot. Zato je priporočljivo uporabljati jasne, pregledne in dosledne poti do zunanjih datotek.
Končnica vključene datoteke ni posebej določena z jezikom. Najpomembneje je, da je pot pravilna in da je projekt pregledno organiziran.
Primer zunanje datoteke z menijem
<a href="php.php">PHP domov</a> |
<a href="zgledi-01-sintaksa.php">PHP zgledi</a> |
<a href="primeri-01-random.php">PHP primeri</a>Koda strani, kjer meni vključimo kot zunanjo datoteko:
<?php include "meni.php"; ?>
<p>To je spletna stran, ki ima meni vstavljen kot zunanjo datoteko z ukazom <code>include</code>.</p>Obseg spremenljivk in vključene datoteke
Ko vključimo datoteko, se ta izvede v dosegu mesta, kjer je vključena. To pomeni, da lahko uporablja spremenljivke, ki so na voljo na tistem mestu v programu.
Funkcije in razredi, ki so definirani v vključeni datoteki, pa so po uspešni vključitvi na voljo tudi v nadaljnji kodi.
Ko datoteka manjka
Če pri ukazu include datoteka ne obstaja ali je ni mogoče vključiti, PHP izpiše opozorilo, preostali del skripte pa se praviloma še naprej izvaja.
To pomeni, da include ni primeren za datoteke, brez katerih program ne more pravilno delovati.
Priporočila
- Za skupne dele strani, ki niso obvezni za delovanje, uporabljamo
include. - Za datoteke, ki jih smemo vključiti samo enkrat, uporabljamo
include_once. - Pri projektu uporabljamo pregledne poti do datotek.
- Skupno kodo smiselno ločimo v zunanje datoteke, da je program preglednejši.
- Pri vključevanju datotek nikoli ne zaupamo neposredno uporabniškemu vnosu.
Pogoste napake
- Pot do vključene datoteke je zapisana napačno.
- Za datoteko, ki se ne sme vključiti večkrat, se uporabi
includenamestoinclude_once. - Pričakuje se, da bo ukaz
includeob napaki ustavil izvajanje skripte. - Vključevanje datotek temelji na nepreverjenem uporabniškem vhodu.
- Struktura projekta ni dovolj pregledna, zato so poti do datotek nepregledne ali nedosledne.
Sklep
Ukaza include in include_once omogočata preglednejšo, krajšo in lažje vzdrževano kodo. Uporabljamo ju za vključevanje skupnih delov programa, pri čemer moramo paziti na pravilne poti, ustrezno izbiro ukaza in varnost pri vključevanju datotek.
Vprašanja in komentarji
Vprašanje je lahko zasebno ali vidno vsem, ki imajo dostop do strani.
Za to stran še ni vprašanj.