ITV0110 4. töö 2017: andmebaasiga serverirakendus - Redigeerimiste ajalugu

Tammet: /* Abi ja soovitusi */

2017-11-04T13:52:54Z

Abi ja soovitusi

←Vanem redaktsioon		Redaktsioon: 4. november 2017, kell 15:52
60. rida:		60. rida:
	Esiteks: tutvu PHP ja SQL materjalidega, kas kursuse esilehelt või koopiana siitsamast:		Esiteks: tutvu PHP ja SQL materjalidega, kas kursuse esilehelt või koopiana siitsamast:

	* ~~Vaata~~ [[Vorgurakendused 1 SQL naited loengust]].		* Kõigepealt vaata [[Vorgurakendused 1 SQL naited loengust]].
	* ~~Vaata~~ [[lihtsaid php ja mysql näiteid]] loengust.		* Siis vaata [[lihtsaid php ja mysql näiteid]] loengust.
			* Lisaks on hea mõte vaadata nii w3schoolsi [https://www.w3schools.com/php/default.asp php tutoriali] kui [https://www.w3schools.com/sql/default.asp sql tutoriali].

	=== Debugimine ===		=== Debugimine ===

Tammet: /* Hindamine, kohustuslikud ja mittekohustuslikud osad */

2017-11-04T13:36:33Z

Hindamine, kohustuslikud ja mittekohustuslikud osad

←Vanem redaktsioon		Redaktsioon: 4. november 2017, kell 15:36
39. rida:		39. rida:
	* Ei kasutata otse, nö puhastamata, kasutaja sisestatud tekste SQL päringute kokkupanekul ([http://xkcd.com/327/ sql injection] takistatud)		* Ei kasutata otse, nö puhastamata, kasutaja sisestatud tekste SQL päringute kokkupanekul ([http://xkcd.com/327/ sql injection] takistatud)

	<b>Soovitavad osad</b>, mis annavad lisaks baaspunktidele veel kuni 6 punkti:		<b>Soovitavad osad</b>, mis annavad lisaks baaspunktidele veel kuni 6 punkti (igaüks ühe):

	* Oma konto tegemine nime, emaili, kasutajanime ja parooliga.		* Oma konto tegemine nime, emaili, kasutajanime ja parooliga.

Tammet – 4. november 2017, kell 13:35

2017-11-04T13:35:39Z

←Vanem redaktsioon		Redaktsioon: 4. november 2017, kell 15:35
20. rida:		20. rida:
	* [https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9 redditi kuumus-algoritm]		* [https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9 redditi kuumus-algoritm]
	* või nii: [https://medium.com/hacking-and-gonzo/how-hacker-news-ranking-algorithm-works-1d9b0cf2c08d hacker newsi kuumus-algoritm] [[hacker news hotness formula\|kokkuvõtlikult siin]]		* või nii: [https://medium.com/hacking-and-gonzo/how-hacker-news-ranking-algorithm-works-1d9b0cf2c08d hacker newsi kuumus-algoritm] [[hacker news hotness formula\|kokkuvõtlikult siin]]
	Konkreetne kuumus-algoritm vali ise, detailid ei ole siin olulised.		Konkreetne kuumus-algoritm vali ise, detailid ei ole siin olulised ja võid ajast sõltumist ise kiiremaks tuunida.

Tammet – 4. november 2017, kell 13:34

2017-11-04T13:34:48Z

←Vanem redaktsioon		Redaktsioon: 4. november 2017, kell 15:34
19. rida:		19. rida:
	Mis asi on <b>kuumus</b>? See seob skoori (plussid miinused) ja sisestamisaja (uuemad peaks olema eespool) üheks arvuks, mida saad arvutada näiteks nii:		Mis asi on <b>kuumus</b>? See seob skoori (plussid miinused) ja sisestamisaja (uuemad peaks olema eespool) üheks arvuks, mida saad arvutada näiteks nii:
	* [https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9 redditi kuumus-algoritm]		* [https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9 redditi kuumus-algoritm]
	* või nii: [https://medium.com/hacking-and-gonzo/how-hacker-news-ranking-algorithm-works-1d9b0cf2c08d hacker newsi kuumus-algoritm] ~~kokkuvõtlikult~~ [[hacker news hotness formula]]		* või nii: [https://medium.com/hacking-and-gonzo/how-hacker-news-ranking-algorithm-works-1d9b0cf2c08d hacker newsi kuumus-algoritm] [[hacker news hotness formula\|kokkuvõtlikult siin]]
			Konkreetne kuumus-algoritm vali ise, detailid ei ole siin olulised.

Tammet – 4. november 2017, kell 13:32

2017-11-04T13:32:56Z

←Vanem redaktsioon		Redaktsioon: 4. november 2017, kell 15:32
18. rida:		18. rida:

	Mis asi on <b>kuumus</b>? See seob skoori (plussid miinused) ja sisestamisaja (uuemad peaks olema eespool) üheks arvuks, mida saad arvutada näiteks nii:		Mis asi on <b>kuumus</b>? See seob skoori (plussid miinused) ja sisestamisaja (uuemad peaks olema eespool) üheks arvuks, mida saad arvutada näiteks nii:
	https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9		* [https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9 redditi kuumus-algoritm]
			* või nii: [https://medium.com/hacking-and-gonzo/how-hacker-news-ranking-algorithm-works-1d9b0cf2c08d hacker newsi kuumus-algoritm] kokkuvõtlikult [[hacker news hotness formula]]

Tammet – 2. november 2017, kell 16:03

2017-11-02T16:03:13Z

←Vanem redaktsioon		Redaktsioon: 2. november 2017, kell 18:03
5. rida:		5. rida:
	== Mis tuleb teha ==		== Mis tuleb teha ==

	Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit wikipediat] ja sarnast [https://news.ycombinator.com/ hacker ~~nwewsi~~]) kasutades selleks PHP-d ja MySQL-i.		Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit wikipediat] ja sarnast [https://news.ycombinator.com/ hacker newsi]) kasutades selleks PHP-d ja MySQL-i.

	Konkreetselt peaks funktsionaalsus olema järgmine:		Konkreetselt peaks funktsionaalsus olema järgmine:

Tammet – 2. november 2017, kell 12:22

2017-11-02T12:22:30Z

←Vanem redaktsioon		Redaktsioon: 2. november 2017, kell 14:22
5. rida:		5. rida:
	== Mis tuleb teha ==		== Mis tuleb teha ==

	Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit wikipediat]) kasutades selleks PHP-d ja MySQL-i.		Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit wikipediat] ja sarnast [https://news.ycombinator.com/ hacker nwewsi]) kasutades selleks PHP-d ja MySQL-i.

	Konkreetselt peaks funktsionaalsus olema järgmine:		Konkreetselt peaks funktsionaalsus olema järgmine:

Tammet: /* Hindamine, kohustuslikud ja mittekohustuslikud osad */

2017-11-02T07:55:02Z

Hindamine, kohustuslikud ja mittekohustuslikud osad

←Vanem redaktsioon		Redaktsioon: 2. november 2017, kell 09:55
40. rida:		40. rida:

	* Oma konto tegemine nime, emaili, kasutajanime ja parooliga.		* Oma konto tegemine nime, emaili, kasutajanime ja parooliga.
	* Sisselogimine õige ~~kasuajanime~~ ja parooliga.		* Sisselogimine õige kasutajanime ja parooliga.
			* Uudiste ja kommentaaride kuvamine koos sisestaja kasutajanimega.
	* Kuumuse rehkendus ja sorteering kuumuse järgi.		* Kuumuse rehkendus ja sorteering kuumuse järgi.
	* Kommentaaride lisamine ja kuvamine uudistele.		* Kommentaaride lisamine ja kuvamine uudistele.

Tammet: Uus lehekülg: 'Reddit == Mis tuleb teha == Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit w...'

2017-11-02T07:52:49Z

Uus lehekülg: 'left|Reddit == Mis tuleb teha == Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit w...'

Uus lehekülg

[[Pilt:reddit.png|left|Reddit]]

== Mis tuleb teha ==

Sinu ülesandeks on ehitada mini-reddit (vaata [https://www.reddit.com/ saiti] ja [https://en.wikipedia.org/wiki/Reddit wikipediat]) kasutades selleks PHP-d ja MySQL-i.

Konkreetselt peaks funktsionaalsus olema järgmine:

* Saad lisada piiratud pikkusega uudise (alla 500 baiti), mis võib sisaldada linki. Uue uudise skoor on 0.
* Saad vaadata loetelu kõigist sisestatud uudistest koos nende skooriga, sorteeritult kuumuse järgi langevalt.
* Saad vaadata uudise juures olevaid kommentaare: neid näidatakse aja järgi langevalt sorteeritult.
* Saad teha konto: anda oma kasutajanime (kontrollitakse unikaalsust) ja parooli ja pärisnime ja emaili.
* Saad sisse logida: sisesta kasutajanime ja parooli
* Kui oled sisse loginud, siis iga uudise juures saad vajutada "+1" või "-1" nuppu, mis annab uudise skoorile vastavalt ühe plussi või miinuse.
* Kui oled sisse loginud, siis saad uudisele lisada kommentaari.

Mis asi on <b>kuumus</b>? See seob skoori (plussid miinused) ja sisestamisaja (uuemad peaks olema eespool) üheks arvuks, mida saad arvutada näiteks nii:
https://medium.com/hacking-and-gonzo/how-reddit-ranking-algorithms-work-ef111e33d0d9

== Hindamine, kohustuslikud ja mittekohustuslikud osad ==

Praktikum annab maksimaalselt 12 punkti.

Konkreetselt on <b>kohustuslikud osad</b>, mis peavad olema tehtud ja mille realiseerimine annab kokku kuni 6 punkti:

* Saad sisse logida: minimaaljuhul parooli ei kasuta, sisestad mistahes kasutajanime. Edasiarendatud variandis on parooliga sisselogimine.
* Sisse logitult pead saama sisestada uudise ehk lühikese teksti.
* Uudistele saad anda plusse ja miinuseid.
* Ka ilma sisse logimata saad vaadata kõiki uudiseid sorteeritult koos skooriga.

Elementaarsed turvanõuded peavad olema täidetud:

* Ei kuvata otse, nö puhastamata välja kasutaja sisestatud tekste (javascript injection ehk XSS takistatud)
* Ei kasutata otse, nö puhastamata, kasutaja sisestatud tekste SQL päringute kokkupanekul ([http://xkcd.com/327/ sql injection] takistatud)

<b>Soovitavad osad</b>, mis annavad lisaks baaspunktidele veel kuni 6 punkti:

* Oma konto tegemine nime, emaili, kasutajanime ja parooliga.
* Sisselogimine õige kasuajanime ja parooliga.
* Kuumuse rehkendus ja sorteering kuumuse järgi.
* Kommentaaride lisamine ja kuvamine uudistele.
* Võimalus laadida uudisega koos üles ka pilti, mida siis kuvatakse koos uudisega.

Lisaks neile funktsionaalsustele võib ehitada juurde muid huvitavaid mittetriviaalseid funktsionaalsusi, mis annavad piisavalt hästi tegemise korral siis samuti veidi lisapunkte.

== Tehnoloogilised nõuded ==

* Kõik serverirakendused tuleb realiseerida [http://www.php.net/ PHP-s] ja andmeid tuleb hoida [http://www.mysql.com MySQL-s]
* Rakendus peab olema võrgus vabalt brauseriga ligipääsetav, mitte lihtsalt töötama näiteks sinu laptopis.

== Abi ja soovitusi ==

Esiteks: tutvu PHP ja SQL materjalidega, kas kursuse esilehelt või koopiana siitsamast:

* Vaata [[Vorgurakendused 1 SQL naited loengust]].
* Vaata [[lihtsaid php ja mysql näiteid]] loengust.

=== Debugimine ===

* Dijkstra php konf on selline, et php vigade korral kuvatakse neid välja veebilehel, vaata näiteks http://dijkstra.cs.ttu.ee/~tammet/t2.php
* Vajadusel kasuta - lisaks eelnevale - oma proges trükkimiseks echo käsku, et tuvastada, kus täpselt ja mis muutujate väärtuste korral viga tekib.
* Alternatiivina (mida enam ilmselt vaja ei lähe) saan endiselt teha nii, et logid dijkstrasse sisse ja ütled käsurealt
<pre>
php myprog.php
</pre>
ja siis kuvatakse sulle käsurealt süntaksivead välja. .

=== Andmebaasi tabelite versioonid vs kustutamine ===

Dijkstras ei ole myqsli kasutajale st2014 hetkel antud õigust tabeleid kustutada. Sestap on hea mõte teha oma tabelid versiooninumbriga ja jätta vanad tabelid lihtsalt prahina alles.

Näiteks nii: <tt>matriklinrvN_tabel</tt> ehk <tt>t12334v3_users</tt>

Teine hea variant on kasutusel olevaid tabeleid jooksvalt vajaduse järgi muuta. Seda saad teha näiteks nii:

<pre>
ALTER TABLE tt1v1_photos ADD filename VARCHAR(100);
</pre>

=== Faili upload ===

Uploadi jaoks sobiv tutorial on [http://www.w3schools.com/php/php_file_upload.asp siin]

Kõigepealt otse tutorialist pärit html vormi näide:
<pre>
<!DOCTYPE html>
<html>
<body>

Upload form:

<form action="upload.php" method="post"
enctype="multipart/form-data">
Select photo upload:
<input type="file" name="fileToUpload" id="fileToUpload">
<input type="submit" value="Upload Image" name="submit">
</form>

</body>
</html>
</pre>

Järgmisena sobiv näide uploaditud faili kontrollimise ja salvestamise jaoks. Näide baseerub [http://www.w3schools.com/php/php_file_upload.asp sellelsamal w3schoolsi tutorialil].

<b>NB!</b>
* Enne selle näitega katsetamist tee endale <tt>public_html</tt> alla kataloog <tt>uploads</tt> ja anna kõigile õigus sinna kataloogi kirjutada ja sealt lugeda:
<pre>
chmod a+rw uploads
</pre>
* Üleslaetud fail salvestatakse numbrilise nimega 10 pluss suffix, a la <tt>10.jpg</tt>. Vaata brauserist [http://dijkstra.cs.ttu.ee/~tammet/uploads/10.jpg taneli kataloogist]

Php näide:

<pre>

<?php

function upload_my_file($fileid) {
echo "starting";
$target_dir = "uploads/";
$target_file = $target_dir . basename($_FILES["fileToUpload"]["name"]);

echo "<p>$target_file " . $target_file;
$uploadOk = 1;
$imageFileType = pathinfo($target_file,PATHINFO_EXTENSION);
echo "<p>$imageFileType " . $imageFileType;
$saved_file = $target_dir . $fileid . "." . $imageFileType;
// Check if image file is a actual image or fake image
if(isset($_POST["submit"])) {
$check = getimagesize($_FILES["fileToUpload"]["tmp_name"]);
if($check !== false) {
echo "File is an image - " . $check["mime"] . ".";
$uploadOk = 1;
} else {
echo "File is not an image.";
$uploadOk = 0;
}
}
echo "all is fine before checks";
// Check if file already exists
if (file_exists($target_file)) {
echo "Sorry, file already exists.";
$uploadOk = 0;
}
// Check file size
if ($_FILES["fileToUpload"]["size"] > 5000000) {
echo "Sorry, your file is too large.";
$uploadOk = 0;
}
// Allow certain file formats
if($imageFileType != "jpg" && $imageFileType != "png" && $imageFileType != "jpeg"
&& $imageFileType != "gif" ) {
echo "Sorry, only JPG, JPEG, PNG & GIF files are allowed.";
$uploadOk = 0;
}
// Check if $uploadOk is set to 0 by an error
if ($uploadOk == 0) {
echo "Sorry, your file was not uploaded.";
// if everything is ok, try to upload file
} else {
if (move_uploaded_file(
$_FILES["fileToUpload"]["tmp_name"], $saved_file)) {
echo "<p>The file ". basename( $_FILES["fileToUpload"]["name"]). " has been uploaded.";
} else {
echo "<p>Sorry, there was an error uploading your file.";
}
}
}

upload_my_file(10);

?>

</pre>

=== Turvaküsimused ===

Sul on tingimata vaja teha kahte turva-asja:

* Mitte võimaldada kasutajal sisestada teksti nii, et see tekst sisaldaks veebilehele kuvamisel html tage (pilte, skripte jms). Selleks kasuta [http://php.net/manual/en/function.htmlentities.php htmlentities] funktsiooni või [http://www.w3schools.com/php/php_form_validation.asp htmlspecialchars] funktsiooni või mõnda tema analoogi. Kindlasti katseta ise, et asi töötaks!

* Mitte võimaldada kasutajal sisestada teksti nii, et see tekst tekitaks SQL lausesetes ootamatuid kõrvalefekte (näiteks kasutaja sisestab pildi nimeks '; drop table ...' vms). Selleks kasuta [http://www.w3schools.com/php/func_mysqli_real_escape_string.asp mysqli_real_escape_string] funktsiooni.

=== Veel ideid ja näpunäiteid ===

* Kõige lihtsam on teha kogu rakendus üheainsa php failina. Keerulisemate programmide puhul ei ole see hea mõte, meie lihtsal juhul aga on päris mugav.
* Kui tahad siiski oma php faili struktureerida (näiteks hoida eraldi failis päis ja jalus) siis selleks on php [http://php.net/manual/en/function.include.php include] käsk.
* Erinevad tegevused (a la sisse/väljalogimine, foto lisamine) saad realiseerida nii, et php lehel vaadatakse, mis argumendid on antud (näiteks fotod.php?username=xx&password=yy peale tehakse sisse logimine, fotof.php?op=logout peale väljalogimine jne). Alati on võimalik võtta ka kasutusele eraldi parameeter, ntx op, mille väärtus ütleb siis, et mis tegevus tuleb ette võtta.
* Debugimise jaoks on lihtsam kasutada vormidel method="get", siis näed brauserist, et mis parameetrid saadeti.
* Samuti on debugimise juures abiks trükkida välja (echo) kokkuklopsitud sql päring tervikuna, et kontrollida, kas sai selline, nagu tahtsid.
* Sisselogimise jaoks (tee seda alles siis, kui baasfunktsionaalsus olemas!) on mõistlik kasutada php session funktsiooni (lihtsa tutoriali [http://www.tizag.com/phpT/phpsessions.php leiad siit]) ja seada sessioonis sisselogimisel $_SESSION['username'] ja edaspidi alati kontrollida, kas on isset($_SESSION['username']) ja kui jah, siis kasutada seda väärtust, kui ei, siis kuvada sisselogimise vorm. Väljalogimisel piisab siis session_destroy() kasutamisest.

== Sobivad õpetused lugemiseks ==

Umbes selles järjekorras:

; PHP

* Väikese ajaloolise ülevaate leiad [http://en.wikipedia.org/wiki/PHP wikipeediast]
* Põhiõpetus on [http://www.php.net/manual/en/ php oma saidil]: loe sealt kõigepealt [http://www.php.net/manual/en/tutorial.php sissejuhatavat tutoriali]
* [http://w3schools.com/php/default.asp W3school-si php tutorial] on samuti päris OK.

; SQL, loe selles järjekorras:

* [http://www.w3schools.com/sql/default.asp enamateks detailideks loe w3schools'i tutoriali]
* [http://www.sql-tutorial.net/SQL-tutorial.asp hea pikem tutorial alternatiivina eelmistele] ja [http://www.sql-tutorial.net/SQL-Cheat-Sheet.pdf selle sees alternatiivne cheat-sheet]
* [http://dev.mysql.com/doc/refman/5.0/en/tutorial.html mysql esmane tutorial] ja [http://dev.mysql.com/doc/refman/5.0/en/index.html vaata veidi mysql manuaali]
* [http://blogs.techrepublic.com.com/security/?p=2368 SQL injection] vt ka [http://lh6.ggpht.com/_5YF7KQZuZS0/S6dvFXu5OoI/AAAAAAAACWM/qTcVpMxcDnA/licence%20plate%20camera%20sql%20injection_2%5B3%5D.jpg?imgmax=800 seda] ja [http://www.schneier.com/blog/archives/2010/10/pen-and-paper_s.html seda] ja [http://alicebobandmallory.com/articles/2010/09/23/did-little-bobby-tables-migrate-to-sweden seda]

; SQL PHP-s, loe selles järjekorras:

* [http://dmsa.concordia.ca/tutorial_files/shortsql.ppt mysql PHP-s: ppt]
* [http://www.tizag.com/mysqlTutorial/ mysql PHP-s: veebitutorial]
* [http://www.w3schools.com/php/default.asp w3schools PHP tutorial all vasakul Mysql blokk]

; Erinevad vormivälja-tüübid peale hariliku <input type=text>:

* [http://www.w3schools.com/html/html_forms.asp w3schools vormi-sissejuhatus]
* väga mahukas ka detailne info: [http://www.w3.org/TR/html401/interact/forms.html vormid html standardis] ja selle [http://www.w3.org/TR/html401/interact/forms.html#h-17.4 eriti oluline osa]

Siit leiad eelmise aasta versiooni: [[ITV0110 4. töö 2016: Andmebaasiga serverirakendus|ITV0110 4. töö 2016]]