Hvordan sette opp en VirtualHost for Apache på Debian 13 for et lokalt PHP-prosjekt

Når du utvikler flere PHP-applikasjoner på en Debian-maskin, blir det snart uoversiktlig å bruke bare http://localhost.

Apache VirtualHosts lar deg tilordne et lokalt domene til hvert prosjekt. For eksempel:

• http://mon-projet.local
• http://blog.local
• http://app.local

Hver navn kan så peke mot en forskjellig mappe.

I denne artikkelen vil vi se hvordan du konfigurerer en VirtualHost for Apache på Debian 13 (Trixie) for et lokalt PHP-prosjekt.

Eksemplet vil bruke:

• Debian 13;
• Apache 2.4;
• PHP 8.4;
• et prosjekt plassert i /var/www/mon-projet;
• det lokale domenenavnet mon-projet.local.

Merknad: denne konfigurasjonen er ment for lokalt utvikling. Den er ikke en produksjonskonfigurasjon.

1. Installer Apache og PHP

Hvis Apache og PHP ikke er installert, begynn med å oppdatere pakkelisten:

Installer derefter Apache og PHP:

Debian 13 tilbyr nå PHP 8.4 som standardversjon. Pakken php er en avhengighetspakke som peker mot den stabilste versjonen av PHP som leveres av Debian.

Du kan sjekke de installerte versjonene med:

Du bør få noe som ligner på:

og:

De eksakte revisjonsnummer kan selvfølgelig endre seg med sikkerhetsoppdateringer av Debian.

Sjekk også at Apache-tjenesten fungerer:

Hvis nødvendig:

2. Lag prosjektmappe

Vi vil plassere vårt prosjekt her:

Lag mappe:

For å teste konfigurasjonen raskt, lager vi en PHP-fil:

Legg til:

Lagre filen.

2.1. Om rettigheter

Apache fungerer normalt med systembrukeren www-data.

Det er imidlertid ikke nødvendig å gi full eierskap til prosjektet til www-data.

I et utviklingsmiljø er det ofte bedre at din Linux-bruker blir eier av prosjektfilene, mens Apache bare får de rettigheter som applikasjonen virkelig trenger.

For enkelttest kan du for eksempel bruke:

Applikasjoner som krever skrivbar mappe, som Symfony eller Laravel, vil senere trenge tilpassede rettigheter på deres cache-, logg- og fil-opplastningsmapper.

3. Opprett en Apache VirtualHost

Apache-konfigurasjoner for nettsteder lagres i:

Lag fila:

Legg til følgende konfigurasjon:

3.1. Forklaringer

VirtualHost *:80

Apache lytter her på HTTP-porten 80, uansett hvilken IP-adresse maskinen brukes.

Navnbaserte VirtualHosts lar flere nettsteder dele samme IP-adresse og port. Apache velger så den tilsvarende VirtualHost basert på ServerName eller ServerAlias som er sendt med i HTTP-rekviringen.

ServerName

Dette er navnet vi vil bruke i nettleseren:

Det anbefales å angi en eksplisitt ServerName for hvert VirtualHost.

DocumentRoot

Denne direktiven viser Apache hvor filene til nettsiden ligger.

<Directory>

Require all granted lar Apache servere innholdet i dette mappa.

AllowOverride All gjør det blant annet mulig for en .htaccess-fil til å endre noen av Apaches regler.

Hvis din applikasjon ikke bruker .htaccess, kan du bruke:

Dette valget er ofte foretrukket når applikasjonen ikke trenger det, fordi Apache-konfigurasjonen blir da merentralisert.

Loggene

Feilene vil bli registrert i:

og tilgangene i:

4. Legg til domenet i /etc/hosts

Domenet mon-projet.local finnes ikke på Internett.

Derfor må vi si til maskinen at dette navnet skal korresponderes med 127.0.0.1.

Endre filen /etc/hosts:

Legg til:

Du kan også bruke:

dersom du vil bruke begge navnene.

Filen /etc/hosts lar oss dermed simulere en DNS-oppløsning lokalt. Apache oppretter ikke automatisk DNS-oppføringer for de virtuelle hostene.

Hvis du bruker et annet datamaskin til å komme til Debian-serveren, må denne endringen gjøres på klientmaskinen, eller erstattes med en virkelig DNS-konfigurasjon.

5. Aktiver VirtualHost-en

Filen vi nettopp opprettet ligger i:

Dette betyr at den er tilgjengelig, men ikke aktivert ennå.

Aktiver det med:

Du kan muligens deaktivere standard VirtualHost-en for Apache:

Dette er imidlertid ikke nødvendig for å få vår nye VirtualHost til å fungere.

6. Sjekk Apache-konfigurasjonen

Før du laster om Apache, sjekker du alltid konfigurasjonen:

Hvis alt er riktig, bør du få:

Dette er en viktig steg: den hindrer deg fra å laste om en konfigurasjon som inneholder syntaksfeil.

Du kan så laste om Apache:

Et reload er tilstrekkelig her: det lar Apache ta i betraktning av den nye konfigurasjonen uten å fullstendig stoppe tjenesten.

7. Sjekk de aktive VirtualHostene

Apache gir deg en veldig nyttig kommando for å undersøke de konfigurerte VirtualHostene:

Du bør se en linje som svarer til:

Denne kommandoen er spesielt nyttig når en maskin hoster flere prosjekter og man ønsker å forstå hvilken VirtualHost Apache bruker. Dokumentasjonen for Apache anbefaler faktisk apachectl -S for å diagnostisere konfigurasjonen av VirtualHostene.

8. Test nettsiden

Du kan nå åpne nettleseren og skrive inn:

Du bør se:

Hvis du foretrekker å utføre testen fra terminalen:

Du bør få den HTML-innhald som er generert av PHP.

Du kan også sjekke direkte at PHP kjøres av Apache ved å opprette et tempoarært fil:

med:

Så åpner du:

Du bør se PHP-informasjonssiden.

Fjern så denne fila, fordi phpinfo() gir ut mange informasjon om PHP-miljøet:

9. Aktiver mod_rewrite hvis nødvendig

Mange moderne PHP-applikasjoner bruker modulen rewrite for Apache.

Du kan aktivere det med:

Deretter sjekk konfigurasjonen:

og last opp igjen Apache:

Med:

til å legge til i VirtualHost, vil en applikasjon som bruker en .htaccess-fil kunne definere sine egne skriveomstillingsregler.

10. Legg til flere prosjekter

Virkeligheten med VirtualHosts viser seg spesielt når flere prosjekter er installert på samme maskin.

For eksempel:

Du kan lage:

site1.conf

site2.conf

Deretter legg til navnene i /etc/hosts:

Aktiver de to prosjektene:

Sjekk konfigurasjonen:

Deretter last opp igjen Apache:

Du kan nå tilgå de to applikasjonene med:

11. Bruk ServerAlias

Hvis en applikasjon skal være tilgjengelig med flere navn, bruker du ServerAlias.

For eksempel:

Du kan dermed bruke:

eller:

Legg også til de to navnene i /etc/hosts:

Apache bruker ServerName og ServerAlias for å bestemme hvilken VirtualHost skal svare på en gitt forespørsel.

12. Skal du bruke NameVirtualHost?

Med eldre versjoner av Apache kunne man møte en rettferdighet som dette:

Den er ikke nødvendig med Apache 2.4.

En moderne konfigurasjon under Debian 13 behøver bare:

Apache 2.4 håndterer naturligvis VirtualHosts basert på navn.

Det er derfor ubehagelig å legge til NameVirtualHost *:80 i en ny konfigurasjon.

13.Struktur slutten

På dette stadiet ser vår installasjon slik ut:

Og /etc/hosts inneholder:

VirtualHost-innholdet er:

Avslutning

Å sette opp en VirtualHost for Apache for et PHP-prosjekt på Debian 13 er relativt enkelt.

De viktigste kommandoene er:

Deretter:

Legg til domenet i:

Deretter aktiver og sjekk om nettsiden fungerer:

Sist:

denne kommandoen lar deg verifisere hvilke VirtualHosts som faktisk blir brukt av Apache.

Du kan deretter tilgang til prosjektet ditt med:

Denne metoden lar deg lokalt gjøre en organisasjon nær den virkelige webserveren, mens du samtidig kan hoste flere uavhengige PHP-prosjekter på én Debian 13-maskin.