Include

Når en utvikler en side ved hjelp av PHP ender en stadig opp i situasjonen at koden en bruker blir brukt flere steder, eller kanskje til og med utviklet av andre. Og selv på en liten side kan det bli nok kode til at en mister oversikten. Hvis du da forventer at koden skal trenge vedlikehold bør du øyeblikkelig dele den opp i flere filer og heller inkludere felles enheter. Det er alltid lettere å rette en feil et sted enn å rette den ti steder. Korrekturen er ikke alltid like rett alle steder.

Include/Include_once

Include og include_once er funksjonene som gir deg muligheten til å hente inn andre skript filer. Om filen som skal inkluderes ikke eksisterer returneres en feilkode. Her følger et enkelt eksempel på bruk av include:
test.inc

Dette er en test.<br />

includetest.php

<?php
for ($i = 0; $i < 10; $i++)
{
     include ("test.inc");
}
?>

Dette skal ende opp i følgende utskrift:

Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.
Dette er en test.

Om en istede vil forsikre seg om at en fil kun inkluderes en gang i et skript benytter en seg av include_once, som det følgende er et eksempel på:
includeoncetest.php

<?php
for ($i = 0; $i < 10; $i++)
{
     include_once ("test.inc");
}
?>

Dette skal ende opp i følgende utskrift:

Dette er en test.

Fordelen med 'include_once' fremfor 'include' er når du skal inkludere PHP skript. Et PHP skript godtar ikke at du har flere funksjoner med samme navn, så du vil få en feilmelding om du ved et uhell skulle inkludere samme skriptet flere ganger.

Require/Require_once

Dette er egentlig helt samme funksjonene som include og include_once. Så lenge filen du ønsker er der er det ingen forskjell. Forskjellen oppstår når filen ikke er der. Mens 'include' kun indikerer at den mislyktes kaller 'require' det for en katastrofal feil og avslutter. Dette er veldig praktisk hvis en har funksjonalitet en absolutt må ha inn, som f.eks. brukervalidering. Litt kjedelig om en bruker skulle komme seg inn kun grunnet at validerings skriptet ditt har fått feil navn. Dette er også en feil som kan være vanskelig å lete fram.

File_exists

Hvis du vil slippe feilmeldingene til require, men ha like god sikkerhet, bør du sjekke om filen eksisterer først. Dette kan du gjøre ved å bruke file_exists sammen med en if test. F.eks. slik:

<?php
$inkfil = "test.php";

if (file_exists ($inkfil))
{
    require_once ($inkfil);
}
else
{
    require ("error.php");
}
?>

Her vil filen bli inkludert hvis den eksisterer, hvis ikke vil en feilmelding inkluderes istede. Legg merke til bruken av require_once for virkelig å sikre seg at filen blir inkludert.

Viktig

Enhver fil som inkluderes blir inkludert som om den er i HTML modus, så du må passe på å gå i PHP modus i enhver fil som skal tolkes som PHP for at den faktisk skal tolkes som dette.