SELVITYSRAPORTTI LABRA-VERKON MYSQL:n JA PHP:n KÄYTTÖÖNOTOSTA Sisällysluettelo Luku 1 - Oman LABRA-sivutilan asennus ja käyttöönotto... 2 1.1 - LABRA-osoitteesi... 2 1.2 LABRA-tilan käyttö (verkko-asemana ja SSH-yhteytenä)... 2 1.2.1 - Verkkoasemana... 2 1.2.2 Käyttäen SSH-yhteyttä... 2 1.3 Web-sivutilan käyttöönotto... 3 Luku 2 MySQL - asennus ja käyttöönotto LABRA-verkossa... 4 2.1 Tietokannan luonti ja käyttöönotto... 4 2.1.1 MySQL-tunnukset... 4 2.1.2.mysql_ohjeet.txt... 4 2.1.3 mysql-ohjelma oman tietokannan käyttö... 4 2.2 - Muutama hyödyllinen SQL-lause... 4 2.2.1 - use -komento... 4 2.2.2 create table -lause... 5 2.2.3 - show tables -lause... 5 Luku 3 PHP:n ja MySQL:n käyttö LABRA-ympäristössä... 6 3.1 PHP-tiedostojen käyttö... 6 3.1.1 Esimerkki-PHP... 6 3.2. MySQL-kantaan yhdistäminen PHP:ssa... 7 3.2.1 Serverin nimi ja portti... 7 3.2.2 Käyttäjänimi ja salasana... 7 3.2.3 Tietokannan nimi... 7 3.2.4 Tietokantaan yhdistämis-esimerkki PHP:lla... 7 Tarkistanut: Jouni Huotari - 1 Versio 2.0
Luku 1 - Oman LABRA-sivutilan asennus ja käyttöönotto 1.1 - LABRA-osoitteesi Labra-websivutilasi toimivat osoitteessa http://student.labra.jypoly.fi/~käyttäjätunnus/, käyttäjätunnus on siis oma opiskelija-tunnuksesi. 1.2 LABRA-tilan käyttö (verkko-asemana ja SSH-yhteytenä) 1.2.1 - Verkkoasemana Löydät LABRA-sivutilasi omasta koti-hakemistostasi joka on verkkoasemalla homes on SAMBA-LDAP-PDC (yleensä Z: ). Kotikansiosi juuresta löytyy www -kansio missä olevat tiedostot näkyvät omassa labra-web-osoitteessasi. Lisäämällä, muokkaamalla tai poistamalla kansion sisältöä teet muutoksia suoraan web-sivustoosi. Lue lisää aiheesta osoitteessa http://student.labra.jypoly.fi/ohjeet/kotihakemisto.txt. 1.2.2 Käyttäen SSH-yhteyttä Saat SSH-suojatun TELNET- ja FTP-yhteyden LABRA koti-kansioosi, SSH Secure Shell Client:illä ja SSH Secure Shell File Transfer Client:illä. Löydät ko. ohjelmat käynnistä-valikosta. 1. Käynnistä SSH-ohjelma 2. SSH Secure Shell Client: paina Quick Connect yhdistääksesi, kirjoita Host name, joka on student.labra.jypoly.fi, sekä käyttäjätunnus, joka on oma opiskelijanumerosi. Paina Connect. Tarkistanut: Jouni Huotari - 2 Versio 2.0
Huom.: 1. kerralla tulee kysymys: vastaa Yes, jonka jälkeen pääset kirjoittamaan (käyttöoikeushakemukseesi määrittämän) salasanasi joka on siis sama millä kirjaudut LABRA-verkkoon: Nyt olet komentorivillä koti-kansiossasi (polku on /home/käyttäjätunnus/). 1.3 Web-sivutilan käyttöönotto Web-sivutilasi osoite on siis http://student.labra.jypoly.fi/~käyttäjätunnus/, jonka saat käyttöön kirjoittamalla seuraavat komennot: chmod 701 /home/käyttäjätunnus/ chmod 705 /home/käyttäjätunnus/www Nyt tee /home/käyttäjätunnus/www -kansioon tiedoston index.html jonka jälkeen sivusi ovat käytössä yllä kerrotussa osoitteessa. Lisää tietoa osoitteessa http://batman.jypoly.fi/www.html Tarkistanut: Jouni Huotari - 3 Versio 2.0
Luku 2 MySQL - asennus ja käyttöönotto LABRAverkossa 2.1 Tietokannan luonti ja käyttöönotto 2.1.1 MySQL-tunnukset MySQL-tietokannan tunnukset luodaan opintojakson alussa valmiiksi ja tunnukset löytyvät kotikansiostasi. Tunnukset ovat käytössä heti ja ne tiedot niistä löytyvät siis koti-kansiosi juuresta tiedostosta nimeltä.mysql_ohjeet.txt. Voit lukea ko. tiedostoa joko verkkoaseman kautta tai suoraan komentorivillä SSH:ssa kirjoittamalla seuraavan komennon: more.mysql_ohjeet.txt 2.1.2.mysql_ohjeet.txt Tämä tiedosto on piilotiedosto ja sen takia siinä on piste edessä. Eli et näe sitä suoraan tiedostolistauksessa mutta kirjoittamalla "DIR -a" tai ls la komentoriville, saat KAIKKI tiedostot näkyviin ko. hakemistossa. Tässä tiedostossa kerrotaan siis missä portissa MySQL-serveri toimii, mikä on MySQLtunnuksesi, MySQL-salasanasi sekä tietokantasi nimi. 2.1.3 mysql-ohjelma oman tietokannan käyttö Nyt ota siis talteen tuo tiedosto ja pääsemme käsiksi MySQL-kantaasi "mysql"- nimisellä ohjelmalla. Kirjoita komentorivillä seuraavasti (kirjoita siis oma MySQL-tunnuksesi): mysql u tunnuksesi p Tämän jälkeen ohjelma kysyy salasanaa, joka sekin oli siinä ".mysql_ohjeet.txt"-tiedostossa. Seuraavaksi lähdemme tekemään muutaman SQL-lauseen... 2.2 - Muutama hyödyllinen SQL-lause 2.2.1 - use -komento "use"-komennolla valitset haluamasi tietokannan käyttöön. Komennon syntaksi on: "use database-name" eli kirjoita siis "use" ja tietokantasi nimi perään. Tietokannan nimi on em. ".mysql_ohjeet.txt"-tiedostossa" joka on Labraverkossa sama kuin tunnuksesi. Eli: use 89529; Tarkistanut: Jouni Huotari - 4 Versio 2.0
2.2.2 create table -lause "create table"-lause on yksi tärkeimmistä käskyistä: sillä luodaan taulut. En lähde sen enempää selvittelemään ko. lausetta mutta testataksesi omaa tietokantaa voit yksinkertaisimmillaan luoda taulun näin: CREATE TABLE testi ( id int auto_increment primary key, etunimi text); 2.2.3 - show tables ja desc Tällä komennolla saat listauksen tietokannan tauluista: show tables; Laitetaan tähän vielä yksi komento eli desc-komento jolla saat kuvauksen tekemästäsi taulusta: desc testi; 2.2.4 insert into -lause Tällä komennolla saat lisättyä rivin tietokannan tauluun: INSERT INTO testi VALUES (1, 'Jees'); Huom. voit selata aikaisemmin antamiasi komentoja käyttäen nuolinäppäimiä (ylös: edellinen komento; alas: seuraava komento). 2.2.5 select-lause Tällä komennolla saat haettua rivejä tietokannan taulusta: SELECT * FROM testi; Tarkistanut: Jouni Huotari - 5 Versio 2.0
Luku 3 PHP:n ja MySQL:n käyttö LABRA-ympäristössä 3.1 PHP-tiedostojen käyttö 3.1.1 Esimerkki-PHP Luo kansioon /home/käyttäjätunnuksesi/www/ (Windows-ympäristössä: Z:\www\) teksti-tiedosto nimellä testi.php ja kirjoita sinne: <?php phpinfo();?> Tallenna tiedosto, avaa Internet Explorer, kirjoita labra-web-sivustosi osoite: http://student.labra.jypoly.fi/~käyttäjätunnuksesi/testi.php Jos teit ohjeiden mukaan ja kaikki toimii hyvin niin sinulle pitäisi avautua seuraavanlainen sivu: Tarkistanut: Jouni Huotari - 6 Versio 2.0
3.2. MySQL-kantaan yhdistäminen PHP:ssa 3.2.1 Serverin nimi ja portti Labra-verkossa toimivan MySQL-serverin osoite on localhost ja portti on Numero 3306. 3.2.2 Käyttäjänimi ja salasana Käyttäjänimi omaan tietokantaasi on oma opiskelijatunnuksesi, salasana löytyy.mysql_ohjeet.txt -tiedostosta joka on omassa juuri-hakemistossa. 3.2.3 Tietokannan nimi Tietokannan nimi on LABRA-verkon MySQL-serverissä yleensä oma opiskelijatunnuksesi. Jos sinulla on tarvetta (esim. projektisi käyttää useaa tietokantaa) luultavasti saat lisää tietokantoja ottamalla yhteyttä opettajaan. 3.2.4 Tietokantaan yhdistämis-esimerkki PHP:lla Tässä luvussa esittelen lyhyesti kuinka PHP:lla yhdistetään MySQL-serveriin. Toimintamalli on useissa ohjelmointi-kielissä samankaltainen. Luo teksti-tiedosto mysql_connect.php www-kansioosi. Kirjoita tiedostoon: 1 <?php 2 3 $mysql_server_name= localhost: ; 4 $mysql_server_port= 3306 ; 5 $mysql_server_username= mysql_tunnuksesi ; 6 $mysql_server_password= mysql_salasanasi ; 7 8 $database_name= mysql_tietokantasi_nimi ; 9 10 mysql_connect($mysql_server_name.$mysql_server_port, 11 $mysql_server_username, 12 $mysql_server_password); 13 14 mysql_select_db($database_name); 15?> Tallenna tiedosto. Yllä oleva ohjelma ottaa yhteyden tietokantaan ja tekee ensimmäisen varsinaisen toiminnon rivillä 14 valitsemalla tietokannan. Selostan ohjelman rivi kerrallaan: Tarkistanut: Jouni Huotari - 7 Versio 2.0
Rivi 1 PHP-tiedoston aloitus-komento <?php Rivi 3 Asetetaan serverin nimi muuttujaan, serverin nimen perään lisätään kaksoispiste (:) sillä yhdistäminen serveriin tapahtuu syntaksilla: localhost:3306. Eli serverin nimi kaksoispiste serverin portti. Kaksoispiste on lisätty tässä vaiheessa tuohon tämän Word-dokkarin stilisoinnin takia. Rivi 4 Rivi 5 Rivi 6 Rivi 8 Asetetaan serverin portti muuttujaan. Asetetaan oma MySQL-tunnuksesi muuttujaan. Asetetaan oma MySQL-salasanasi muuttujaan. Asetetaan oma MySQL-tietokantasi nimi muuttujaan. Rivit 10-12 Yhdistetään MySQL-serveriin funktiolla mysql_connect(...) jossa on siis kolme parametria jotka ovat: 1.) Serverin nimi ja portti yhdistettyinä (piste-operaattorilla) 2.) Käyttäjätunnus 3.) Salasana Rivi 14 Valitaan käytettävä tietokanta funktiolla mysql_select_db(...) yhdellä parametrilla joka on tietokantasi nimi (talletettuna $database_name-muuttujaan). Rivit 15 PHP-tiedoston lopetus-komento?>. Tarkistanut: Jouni Huotari - 8 Versio 2.0