Keskustelu: Ohjelmointikysymykset: PHP, C#, Unity: Käyttäjän kuvan tallennus

<?php
	if (!isset($_FILES) && isset($HTTP_POST_FILES)) {
		$_FILES =& $HTTP_POST_FILES;
	}

	// Tehdään vielä oma poikkeustyyppi virheitä varten.
	class UploadException extends Exception {
		// Luokan vanha sisältö kelpaa meille.
	}

	/**
	 * Tarkistaa, että tiedosto on lähetetty onnistuneesti.
	 * Virhetilanteissa heitetään poikkeus (UploadException).
	 *
	 * @param $input        input-tagin nimi
	 * @param $maksimikoko  suurin sallittu koko tavuina
	 * @return string       palauttaa tiedoston alkuperäisen nimen
	 */

	function upload_tarkista($input, $maksimikoko = null) {
		// Tarkistetaan, että tiedosto on edes yritetty lähettää.
		if (empty($_FILES[$input])) {
			throw new UploadException("Lomakkeella ei ole tiedostoa '{$input}'!");
		}

		// Tarkistetaan tiedoston koko.
		if ($maksimikoko !== null) {
			if ($_FILES[$input]["size"] > $maksimikoko) {
				$_FILES[$input]["error"] = UPLOAD_ERR_FORM_SIZE;
			}
		}

		// Tarkistetaan lähetyksen virhetilanteet.
		// HUOMIO: oikeassa käytössä erilaiset ilmoitukset kannattaisi välittää
		// eri luokissa, jotta esim. käyttäjän virhe (liian suuri tiedosto)
		// olisi mahdollista erottaa palvelimen virheestä (tila lopussa).
		switch ($_FILES[$input]["error"]) {
			case UPLOAD_ERR_OK:
				break;
			case UPLOAD_ERR_INI_SIZE:
			case UPLOAD_ERR_FORM_SIZE:
				throw new UploadException("Tiedosto '{$input}' on sallittua suurempi!");
			case UPLOAD_ERR_PARTIAL:
				throw new UploadException("Tiedoston '{$input}' lataus keskeytyi!");
			case UPLOAD_ERR_NO_FILE:
				throw new UploadException("Tiedosto '{$input}' puuttuu!");
			case UPLOAD_ERR_NO_TMP_DIR:
				throw new UploadException("Palvelimella ei ole paikkaa tiedostoille!");
			case UPLOAD_ERR_CANT_WRITE:
				throw new UploadException("Tiedoston '{$input}' tallentaminen palvelimelle ei onnistunut!");
			case UPLOAD_ERR_EXTENSION:
				throw new UploadException("Jokin PHP:n laajennos esti tiedoston latauksen!");
			default:
				throw new UploadException("Tuntematon virhe tiedoston '{$input}' latauksessa!");
		}
		if (!is_uploaded_file($_FILES[$input]["tmp_name"])) {
			throw new UploadException("PHP:n mukaan tiedoston tmp_name on viallinen!");
		}
		return basename($_FILES[$input]["name"]);
	}

	/**
	 * Tallentaa lähetetyn tiedoston haluttuun paikkaan.
	 *
	 * @param $input   input-tagin nimi
	 * @param $kohde   uusi tiedostonimi
	 * @return string  palauttaa tiedoston alkuperäisen nimen
	 */
	function upload_tallenna($input, $kohde) {
		$nimi = upload_tarkista($input);

		// Tarkistetaan kirjoitusoikeus.
		if (!is_writeable(dirname($kohde)) || (file_exists($kohde) && !is_writeable($kohde))) {
			throw new UploadException("Virhe tiedoston '{$input}' kopioinnissa paikkaan '{$kohde}', ei kirjoitusoikeutta!");
		}

		// Yritetään kopioida tiedosto paikalleen.
		if (!@move_uploaded_file($_FILES[$input]["tmp_name"], $kohde)) {
			$virhe = error_get_last();
			throw new UploadException("Virhe tiedoston '{$input}' kopioinnissa paikkaan '{$kohde}': {$virhe["message"]}!");
		}
		return $nimi;
	}

	/**
	 * Tallentaa lähetetyn tiedoston hallitusti uudella nimellä,
	 * joka muodostetaan alkuperäisestä nimestä ja satunnaisosasta.
	 * Myös tiedostonimen pääte tarkistetaan.
	 *
	 * @param $input       input-tagin nimi
	 * @param $hakemisto   hakemisto, joka merkitään uuden nimen alkuun
	 * @param $paatteet    tiedoston sallitut päätteet
	 * @param $turvapaate  tiedostolle laitettava pääte, jos vanha pääte ei ole sallittu
	 * @return array       palauttaa taulukossa tiedoston vanhan ja uuden nimen
	 */
	function upload_tallenna_turvallinen($input, $hakemisto = ".", $paatteet = array(".jpg", ".gif", ".png", ".txt", ".dat"), $turvapaate = false) {
		$nimi = upload_tarkista($input);

		// Katsotaan, onko annetussa taulukossa tiedoston pääte.
		// Jos ei ole, käytetään annettua päätettä ($turvapaate).
		if (is_array($paatteet)) foreach ($paatteet as $paate) {
			if (substr($nimi, -strlen($paate)) == $paate) {
				$turvapaate = $paate;
				break;
			}
		}

		// Jos $turvapaate puuttuu (eikä muuta löytynyt taulukosta), hylätään tiedosto.
		if ($turvapaate === false) {
			throw new UploadException("Tiedoston '{$input}' nimi ({$nimi}) ei kelpaa!");
		}

		// Luodaan tiedostolle turvallinen nimi ja tallennetaan tiedosto.
		$nimi2 = substr(preg_replace("/[^-_.0-9A-Za-z]/", "", $nimi), 0, 32);
		if (strlen($turvapaate) && substr($nimi2, -strlen($turvapaate)) !== $paate) {
			$nimi2 .= $paate;
		}
		while (true) {
			$kohde = $hakemisto. "/upload_". uniqid("", true). "_". $nimi2;
			if (!file_exists($kohde)) {
				upload_tallenna($input, $kohde);
				return array($nimi, $kohde);
			}
		}
	}
?>

<?php
	// Käyttöesimerkkejä.
	// Tämä käsittelysivu palauttaa virheilmoitukset käyttäjälle tekstinä.
	// Laitetaan kaikki mahdolliset ilmoitukset näkyviin.
	header("Content-Type: text/plain");
	ini_set("error_reporting", E_ALL | E_STRICT);
	ini_set("display_errors", 1);

	// Otetaan funktiot mukaan.
	require_once("upload.php");


	// Esimerkki: Tarkistetaan tiedoston pääte ja yritetään tallentaa se palvelimelle.
	// Funktion toinen parametri on tallennushakemisto, "." tarkoittaa tätä hakemistoa.
	// HUOMIO! Virhettä ei tässä erikseen käsitellä, joten tulos voi olla ruma!
	list($vanha, $nimi) = upload_tallenna_turvallinen("tiedosto", ".", array(".png", ".jpg", ".jpeg", ".gif"));
	die("Tallennettiin kuva, nimi on {$nimi}, vanha nimi oli {$vanha}.\n");
?>