Tämä artikkeli sisältä ärimmäisen yksinkertaisen esimerkin php:n hyödyllisyydestä. Seuraavassa ei käsitellä varsinaista php-ohjelmointia, vain erään php:n ominaisuuden hyväksikäyttöä.
Takaisin "Oppaat ja esimerkit" -osion etusivulle
Php:llä voi kummasti helpottaa sivujen teon tuskaa. Luultavasti yksinkertaisin keino vähentä samojen koodinpätkien kymmenille eri sivuille (tiedostoille) kirjoittamista, on käyttä apuna php:n include (tai include_once / require / require_once) -lausetta.
Oletetaan, että haluamme rakentaa vaikkapa kymmensivuisen saitin. Jokaisella sivulla on sama ulkoasu ja rakenne, mutta sisältö on sivukohtainen. Emme halua käyttä kehyksiä, emme sisäkehyksiä, emmekä myöskään popuppeja.
Jos tällaista sivustoa lähdettäisiin rakentamaan yksistän staattisen html:n avulla, joutuisimme kopioimaan jokaiselle sivulle samat koodit (poislukien sisältö), ja työmärä olisi tuskallisen suuri (puhumattakaan kymmentä sivua laajempien sivustojen työläydestä). Php:n avulla voimme kuitenkin vähentä työtä niin, että meidän ei tarvitse kirjoittaa koodeja kuin yhden kerran. Erityisesti sivuston päivittäminen helpottuu huomattavasti, kun ulkoasun muokkaamiseksi tarvitsee muokata vain yhtä tai kahta tiedostoa kymmenien asemesta.
Otetaanpa esimerkki yksinkertaisesti xhtml-sivusta:
<html> <head> <title>veer is tö manki</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <link rel="stylesheet" href="apina.css" type="text/css" /> </head> <body> <div id="valikko"> <a href="apina.php" target="_top">Apina</a><br /> <a href="arkistot.php" target="_top">Arkisto</a><br /> <a href="tarinat.php" target="_top">Tarinat</a><br /> <a href="kirjat.php" target="_top">Kirjat</a><br /> <a href="musiikki.php" target="_top">Musiikki</a><br /> </div> <div id="sisin"> <div class="otsikkoteksti">Apina</div> <p>Muinaisten viikinkien lyhytkarvakissojen ja ristiretkeläisten mukana Norjaan kulkeutuneiden pitkäkarvakissojen arvellaan olevan alkuna norjalaiselle metsäkissarodulle. Norjalainen metsäkissa on kehittynyt luonnollisen valinnan seurauksena Norjan ankarassa ilmastossa, jossa vain terveimmät ja voimakkaimmat yksilöt ovat selviytyneet jatkamaan sukua.</p> </div> </body> </html>
Huomaamme, että tämä sivu voidaan jakaa kolmeen osaan:
Osa 1, alku:
<html> <head> <title>veer is tö manki</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <link rel="stylesheet" href="apina.css" type="text/css" /> </head> <body> <div id="valikko"> <a href="apina.php" target="_top">Apina</a><br /> <a href="arkistot.php" target="_top">Arkisto</a><br /> <a href="tarinat.php" target="_top">Tarinat</a><br /> <a href="kirjat.php" target="_top">Kirjat</a><br /> <a href="musiikki.php" target="_top">Musiikki</a><br /> </div>
Osa 2, sisältö:
<div id="sisin"> <div class="otsikkoteksti">Apina</div> <p>Muinaisten viikinkien lyhytkarvakissojen ja ristiretkeläisten mukana Norjaan kulkeutuneiden pitkäkarvakissojen arvellaan olevan alkuna norjalaiselle metsäkissarodulle. Norjalainen metsäkissa on kehittynyt luonnollisen valinnan seurauksena Norjan ankarassa ilmastossa, jossa vain terveimmät ja voimakkaimmat yksilöt ovat selviytyneet jatkamaan sukua.</p> </div>
Osa 3, loppu:
</body> </html>
Kun jaamme sivun em. tavalla erillisiin osiin, voimme eristä joka sivulla samanlaisina esiintyvät koodinpätkät omiin tiedostoihinsa (osat 1 ja 3). Tarvitsemme siis vain yhden kappaleen osan 1 sisältäviä tiedostoja ja vain yhden kappaleen osan 3 sisältäviä tiedostoja. Tallentakaamme osa 1 nimellä alku.php ja osa 3 nimellä loppu.php (Huomaa tallennus php-pätteellä!).
Tämän jälkeen voimme sisällyttä sisällön ympärille koko muun sivun parilla rivillä koodia:
<?php require_once("alku.php"); ?>
<div id="sisin">
<div class="otsikkoteksti">Apina</div>
<p>Muinaisten viikinkien lyhytkarvakissojen ja ristiretkeläisten
mukana Norjaan kulkeutuneiden pitkäkarvakissojen arvellaan olevan alkuna
norjalaiselle metsäkissarodulle. Norjalainen metsäkissa on kehittynyt
luonnollisen valinnan seurauksena Norjan ankarassa ilmastossa, jossa vain
terveimmät ja voimakkaimmat yksilöt ovat selviytyneet jatkamaan sukua.</p>
</div>
<?php require_once("loppu.php"); ?>
Tämäkin tiedosto on tallennettava .php-pätteisenä! Esimerkiksi apina.php.
Nyt meidän siis tarvitsee kirjoittaa vain sivun sisältö ja lisätä nuo pari php-riviä tiedoston alkuun ja loppuun. Jokainen sivu näyttä samalta vain sisällön vaihtuessa.
Koska php ajetaan jo palvelimella, saa sur8ailijan selain vain sivun html-koodin. Eli sivu näyttä sur8aajalle samalta kuin tämän esimerkin ensimmäinen koodinpätkä, mutta sivun tekijän on tarvinnut kirjoittaa huomattavasti vähemmän koodia.
Tärkeä! Php-tiedostot on syytä siirtä palvelimelle ASCII-muodossa!
Oppaan on kirjoittanut Havusiipi. Saatavilla myös pdf-versiona.
Katso myös oppaan toinen osa.