Lai pievienotu papildu failu PHP skriptam, izmantojiet īpašo funkciju iekļaut. Pēc ārēja dokumenta pievienošanas programmētājam ir iespēja izmantot rakstīto kodu vai citu saturu pašreizējā lietojumprogrammā.
Iekļaut funkciju
Iekļaut ietver šādu sintaksi:
iekļaut “faila nosaukumu”;
Nosaukums ir relatīvs vai absolūts ceļš ar iekļautā dokumenta paplašinājumu. Ja atrašanās vieta nav norādīta, PHP automātiski pārbaudīs konfigurācijas php.ini saturu, kas norāda include_path - direktoriju, kurā var ievietot papildu bibliotēkas. Ja direktīva ir tukša vai tajā norādītajā ceļā nav atrasts nepieciešamais fails, izteiksme include tiks ignorēta.
Kad tas ir iespējots, skriptā varat izmantot vajadzīgo saturu, piešķirt mainīgos, izmantot deklarētās konstrukcijas utt. Piemēram, ir 2 faili 1.php un 2.php. 1.php saturs izskatās šādi:
<? php
$ pirmkārt = “mainīgais no pirmā faila”;
$ otrkārt = “importētā vērtība”;
?>
Lai 2.php iekļautu iepriekš minētos mainīgos, varat veikt šādu darbību:
<? php
Iekļaujiet “1.php”;
echo $ pirmkārt;
$ emerge = “$ otrkārt”;
atbalss $ parādīties; ?>
Šajā otrā faila skriptā komanda include ietver pirmā dokumenta saturu, pēc kura 1.php deklarētie mainīgie tiek izmantoti, lai ekrānā parādītu nepieciešamās vērtības.
Iekļaut var izmantot gan faila pašā sākumā, gan deklarētās funkcijas iekšpusē jebkurā dokumenta daļā. Nav vēlams izmantot funkciju, lai savienotu failus, kas atrodas attālajā serverī. Ja vēlaties ieviest šo funkciju, vietējā vai attālā servera php.ini failā būs jāiespējo opcija allow_url_fopen.
Pieprasīt
Funkcija pieprasīt ir līdzīga iekļaušanai. Komandas neatšķiras sintaksē un izpildes tehnoloģijā. Vienīgā atšķirība ir tāda, ka, ja trūkst norādītā faila, skripts tiek izbeigts, savukārt include turpinās skripta izpildi un parādīs atbilstošo brīdinājumu E_WARNING, kuru var nomākt, izmantojot īpašo rakstzīmi @. Piemēram:
<? php
pieprasīt “1q.php”;
atbalss “Skripts pārstāj darboties”; ?>
Šajā piemērā ir norādīts ceļš uz neeksistējošu dokumentu 1q.php. Ja faila trūkst, skripts neizpildīs komandu echo, un lietotāja ekrānā tiks parādīta tukša lapa vai kļūdas ziņojums (atkarībā no php.ini iestatījumiem). Ja ievadāt līdzīgu kodu, izmantojot:
<? php
ietver “1q.php”;
atbalss “Skripts turpinās”; ?>
Atbalss komanda tiks izpildīta, un displejā parādīsies atbilstošais teksts.