Lomakkeet ja HTTP - Luento 5

• Luentotaltiointi
• Eclipse-ohjeita
• Miten asennan PHP-kehitysympäristön?
• Lomakkeen toiminta yleisesti
  • Lomakkeen käsittely
• HTTP (HyperText Transfer Protocol)
  • HTTP Status Codes
  • Lisätietoa
• Lomakkeen käsittely PHP:lla
  • HTTP-otsikkotiedot
  • Ympäristömuuttujat
  • Lomaketiedot
• Esimerkki

Luennolla käydään läpi HTTP-protokollan perusteita ja selvitellään miten WWW-lomakkeita voidaan käsitellä PHP:lla. Lisäksi alussa käydään nopeasti läpi viime luennolla käymättä jääneitä Eclipse-ohjeita.

Eclipse-ohjeita

• Syntaksivirheiden etsintä Problems-välilehdellä (dokumentti pitää ensin tallentaa, toimii PHP-, XHTML- ja CSS-koodeissa)
• Koodin täydennös (Ctrl + Välilyönti, toimii PHP-, XHTML- ja CSS-koodeissa)
• Breakpointin asettaminen (oikea hiiren näppäin -> Toggle Breakpoints)
• Debuggaus (oikea hiiren näppäin -> Debug As -> PHP Script):
  • F6-näppäimellä pääsee koodissa eteenpäin rivin kerrallaan.
  • Debug Output -välilehti näyttää, mitä XHTML-koodia syntyy.
  • Browser Output -välilehti näyttää, miltä syntynyt XHTML-sivu näyttää todellisuudessa.
  • Variables-välilehti näyttää muuttujien reaaliaikaiset arvot.
  • Takaisin "päänäyttöön" pääsee oikean yläkulman väkäsen takaa löytyvällä PHP-painikkeella.
• Sivun "ajaminen" (oikea hiiren näppäin -> Run As -> PHP Web Page)

Lisää vinkkejä Eclipsen aloitusohjeessa.

Miten asennan PHP-kehitysympäristön?

• PHP itsessään vaatii
  • PHP-tulkin, joka prosessoi PHP-kielellä kirjoitetut komennot ja
  • WWW-palvelimen, johon on integroitu PHP-tulkki (=Apache).
• Eclipse PDT -kehitysympäristö:
  • Jos sinulla ei ole vielä Eclipseä => ota all-in-one. Uusin all-in-one-versio on tällä hetkellä:

    pdt-1.0.2.R20080103_debugger-5.2.12.v20071210-all-in-one-*.zip

  • Jos sinulla on Eclipse => ota PDT-laajennus ja Zend Debugger.
• Eclipse PDT:n käyttöönottoohjeet
• Sivut on kotikoneelta siirrettävä WWW-palvelimelle users.jyu.fi SSH-ohjelmalla, että niitä voidaan katsoa selaimella, kts. julkaisuohjeet.
• Kotikoneeseen voi asentaa WWW-palvelimen, esim. XAMPP-paketin.
  • Yliopistoverkossa tämä ei ole sallittua.
  • Osaamattomissa käsissä iso tietoturvariski!

Lomakkeen toiminta yleisesti

1. Selainohjelma pyytää palvelimelta lomakesivun HTTP-protokollan mukaisilla otsikkotiedoilla.
2. Palvelin vastaa selaimelle HTTP-protokollan mukaisilla otsikkotiedoilla, jonka jälkeen tarjoaa WWW-sivun datan (=XHTML:ää).
3. Käyttäjä täyttää ja hyväksyy lomakkeen. Selain lähettää lomakkeen tiedot WWW-palvelimella suoritettavalle ohjelmalle.
4. Lomakkeella oleva data käsitellään ohjelman tekijän haluamalla tavalla.
5. Ohjelma palauttaa käyttäjälle virheilmoituksen tai ilmoituksen onnistumisesta, esim. lomakkeen korjauspyynnöillä tai tulossivun.

Lomakkeen käsittely

• Lomaketiedot tulevat GET- tai POST-metodilla.
  • GET = lomaketiedot lisätään osoitteen loppuun.
  • POST = tiedot lähetettään HTTP-pyynnön runko-osassa.
  • Käytä GET-metodia tilaa muuttamattomissa pyynnössä, joista voidaan tehdä kirjanmerkki, kuten esim. haut. Lisäykset, poistot, päivitykset ja paljon dataa lähettävät lomakkeet POST-metodilla.
• Ohjelma käsitellään yleensä jonkinlaisella tulkilla.
• Ohjelma saa tarvittavat lomaketiedot ja palvelintiedot ohjelmointikielen ympäristömuuttujista.
• Tulkki saa nämä tiedot palvelinohjelmalta. Palvelinohjelman ja skriptikielten välinen rajapinta on määritelty CGI-spesifikaatiossa.
• Skriptitulkki on usein integroitu palvelinohjelmistoon.
• Huomaa, että HTTP on oletuksena tilaton. Emme tiedä edellisistä pyynnöistä tai lomakkeiden käsittelyistä mitään.

HTTP (HyperText Transfer Protocol)

HTTP on protokolla, jonka avulla selain ja WWW-palvelin keskustelevat.

Firefox-selaimen ja WWW-palvelimen välistä HTTP-liikennettä on helppo seurata Tamper Data -laajennuksella.

Selain lähettää WWW-palvelimelle pyynnön:

GET /sovellukset/testi.html HTTP/1.1
Connection: keep-alive
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,video/x-mng,image/png,image/jpeg,image/gif;q=0.2,*/*;q=0.1
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
Accept-Encoding: gzip,deflate
Accept-Language: en-us,en;q=0.5
Host: appro.mit.jyu.fi
Referer: http://appro.mit.jyu.fi/ 
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.4) Gecko/20030624
Keep-Alive: 300

Palvelin vastaa:

HTTP/1.1 200 OK
Connection: close
Date: Tue, 06 Apr 2004 10:53:18 GMT
Accept-Ranges: bytes
ETag: "2da29-2147-4044819d"
Server: Apache/1.3.27 (Unix)  (Red-Hat/Linux) PHP/4.1.2 mod_perl/1.26
Vary: Accept
Content-Length: 414
Content-Type: application/xhtml+xml; charset=iso-8859-1
Last-Modified: Tue, 02 Mar 2004 12:44:13 GMT

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/2000/REC-xhtml1-20000126/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fi" >
<head>
  <title>Testisivu</title>
  <link href="testi.css" rel="StyleSheet" type="text/css" />
</head>
<body>
  <h1>Testiotsikko</h1>
  <p>Testitekstiä</p>
</body>
</html>

HTTP-otsikoita voi tutkia tarkemmin esim. seuraavilla ohjelmilla:

• Tamper Data -laajennos Firefoxiin
• Web-Sniffer

HTTP Status Codes

Palvelin palauttaa vastauksessa HTTP-statuskoodin, joka kertoo lyhyesti selaimelle miten pyyntö onnistui ja miten tulee jatkossa toimia. Listassa yleisimmät:

• 200 OK
• 300 Multiple Choices
• 301 Moved Permanently
• 302 Found
• 401 Unauthorized Access
• 403 Forbidden
• 404 Not Found
• 406 Not Acceptable
• 408 Request Time-out
• 500 Internal Server Error

Lisätietoa

• HTTP Made Really Easy
• How the web works
• CGI-ympäristö
• HTTP trace
• RFC2616

Lomakkeen käsittely PHP:lla

HTTP-otsikkotiedot

Selaimen lähettämät otsikkotiedot saa esimääritellystä $_SERVER-taulukosta. Avaimet ovat muotoa HTTP_HEADER_NAME. Esim.

$_SERVER['HTTP_ACCEPT_LANGUAGE']

PHP luo automaattisesti otsikkotiedot ennen HTML-dokumenttia. Jos näitä halutaan muuttaa, niin aivan dokumentin alussa on käytettävä header-funktiota. Esim. edelleenohjaus:

<?php 
header('Location: http://appro.mit.jyu.fi/www/');
?>

• RFC2616-spesifikaation luku 14 - HTTP:n otsikkotiedot
• HTTP Headers and the PHP header() function

Ympäristömuuttujat

$_SERVER-taulukosta saa myös palvelimen ja skriptien toimintaan liittyvät CGI-parametrit. Lisäksi mukana on muutama PHP-skriptien toimintaan liittyvä tieto. Esim.

$_SERVER['PHP_SELF']

Lomaketiedot

HTML-lomakkeelta lähetetyt tiedot saa helpoiten $_REQUEST-taulukosta. Se sisältää sekä $_GET- että $_POST-taulukoiden tiedot. Taulukon avaimena on lomake-elementin name-ominaisuus. Esim.

$_REQUEST['etunimi']

Huomioitavaa:

• GET-parametri voi olla myös HTML-linkissä. Tällöin se on saatavissa näistä esimääritellyistä taulukoista.
• Jos checkboxeilla on sama name-ominaisuus, niin vain viimeisen tiedot saadaan taulukkoon. Kaikki vaihtoehdot saadaan taulukkoon antamalla name-ominaisuuden loppuun hakasulkeet:

  <input type="checkbox" name="valinta[]" value="yks" />
  <input type="checkbox" name="valinta[]" value="kaks" />
  

  • Tällöin $_REQUEST['checkboxin_name']-muuttujassa on taulukko valinnoista.
  • Tämä on ikävä piirre PHP:ssa, entä jos emme pystykään vaikuttamaan XHTML-koodiin? :-(
• Myös monivalintaisen select-elementin name-ominaisuuteen on laitettava hakasulkeet.
• var_dump ja print_r helpottavat debuggausta.

Esimerkki

Aletaan tehdä luennolla esimerkkiä lomakkeen käsittelystä. Esimerkissä käydään läpi mm. alla listattuja asioita. Esimerkkiä jatketaan seuraavalla luennolla.

Esimerkkilomakkeen koodi (jatketaan seuraavalla luennolla)

1. Lomakemuuttujien tulostaminen
   • Merkkijonot '' ja ""
   • $_SERVER, $_REQUEST, $_GET, $_POST
   • htmlentities, print_r
   • Katenointi .
2. Taulukot
   • Taulukkoon lisääminen
   • Moniulotteinen taulukko
3. Lomakemuuttujilla operoiminen
   • Vertailuoperaattorit
   • Laskutoimitukset
   • foreach
   • Checkbox ja taulukot
4. Validointi
   • Totuusarvot (if)
   • isset, is_numeric, empty
   • Oletusarvot virhetilanteessa
   • Virhetaulukko - useita virheitä yhdessä kohtaa
   • Merkin vertailu merkkijonosta - $jono{$i} - strlen - strstr - stristr
   • in_array
5. Oletusarvon täyttö
6. Keskiarvoja
   • printf
   • foreach, count
7. Dynaamiset lomakkeet