[PHP]: Nuova Classe Uploader

Qualche tempo fa, avevo pubblicato un articolo ad una mia classe che permetteva di facilitare l’upload dei file, con pochi semplici comandi…

A distanza di tempo mi sono accorto di numerosi bug che corrompevano la corretta esecuzione dello script ( è stata la mia prima classe php 😛 )

Esattamente oggi, l’ho riscritta e testata modificando anche i comandi di esecuzione, in modo da facilitarne ancor di più l’esecuzione.

Requisiti:

• PHP 5
• Permessi in Scrittura sulla Cartella

Iniziamo scaricando il file sorgente della libreria:

class Uploader {

		private $ext_ok = array();
		private $ext_no = array();
		private $ctrl_ext = false;
		private $owrite = true;
		private $max_size = 0;
		private $path_file = '';
		private $campo = '';
		private $errore = '';

		public function Uploader($campo)
		{
			$this->campo = $campo;
		}

		public function getError()
		{
			return $this->errore;
		}

		public function set_opt($opzione, $valore)
		{
			if($opzione == 'controllo estensione')
			{
				$this->ctrl_ext = (bool)$valore;
			}
			elseif($opzione == 'estensioni consentite')
			{
				$this->ext_ok = explode(',', $valore);
			}
			elseif($opzione == 'estensioni non consentite')
			{
				$this->ext_no = explode(',', $valore);
			}
			elseif($opzione == 'massima dimensione')
			{
				$this->max_size = (int)$valore;
			}
			elseif($opzione == 'sovrascrittura')
			{
				$this->owrite = (bool)$valore;
			}
		}

		public function upload($destinazione)
		{
			$file = $_FILES[$this->campo]['name'];
			$size = $_FILES[$this->campo]['size'];
			$temp = $_FILES[$this->campo]['tmp_name'];

			if($this->max_size != 0 && ($size > $this->max_size))
			{
				$this->errore = ERR_TOO_BIG;
				return false;
			}
			else
			{
				$err = 0;

				if($this->ctrl_ext)
				{
						// non consentite
						if(count($this->ext_no) != 0)
						{
							foreach($this->ext_no as $no)
							{
								if(trim($no) == $this->getExt($file))
								{
									$err = 1;
								}
							}
						}

					if($err == 0)
					{
						$ctrl = 0;

						if(count($this->ext_ok) != 0)
						{
							foreach($this->ext_ok as $ok)
							{
								if(trim($ok) == $this->getExt($file))
								{
									$ctrl = 1;
								}
							}
						}
						else
						{
							$ctrl = 1;
						}

						if($ctrl == 0)
						{
							$err = 1;
						}
					}
				}

				if($err == 0)
				{
					if($this->owrite)
					{
						$this->path_file = $file;
					}
					else
					{
						if(file_exists($destinazione.$file))
						{
							$cas = md5(rand(0,9999999999));

							$nome = $this->dividi($file);

							$iniziali = substr($nome, 0, 3);

							$estensione = $this->getExt($file);

							$this->path_file = $iniziali.$cas.'.'.$estensione;
						}
						else
						{
							$this->path_file = $file;
						}
					}

					if(is_uploaded_file($temp))
					{
						if(move_uploaded_file($temp, $destinazione.$this->path_file))
						{
							return true;
						}
						else
						{
							$this->errore = ERR_UPLOAD;
							return false;
						}
					}
					else
					{
						$this->errore = ERR_UPLOAD;
						return false;
					}
				}
				else
				{
					$this->errore = ERR_WRONG_EXT;
					return false;
				}
			}
		}

		private function getExt($path)
		{
			$file_split = explode(".", $path);

			$estensione = array_pop($file_split);

			return $estensione;
		}

		private function dividi($nome)
		{
		   $file_split = explode(".", $nome);

			$estensione = array_pop($file_split);

			$len_ext = strlen($estensione);

			$nomef = substr($nome, 0, (strlen($nome) - ($len_ext + 1)));

			return $nomef;
		}

		public function getName()
		{
			return $this->path_file;
		}

	}

Ed ora veniamo all’utilizzo della classe stessa:

Definiamo il testo degli errori con la sintassi:

define(‘ERR_TOO_BIG’, ‘Il File è troppo Grande!’);
define(‘ERR_WRONG_EXT’, ‘Estensione non Consentita!’);
define(‘ERR_UPLOAD’, ‘Errore nell\’Upload del File’);

Ora includiamo la libreria con:

include(“libs/upload.inc.php”);

Istanziamo la classe con la variabile $up passando come riferimento della funzione il nome del campo di tipo file che ha inviato il dato:

$up = new Uploader(‘userfile’);

Ora veniamo alle opzioni, si usa la funzione set_opt(parametro, valore) come in questo esempio:

$up->set_opt(‘controllo estensione’, true); // impone di controllare l’estensione, quindi richiede l’opzione delle estensioni non consentite OPPURE quella delle opzioni consentite.

$up->set_opt(‘estensioni non consentite’, ‘txt, png’); // indica quali estesioni non sono consentite (separate con una virgola)

// $up->set_opt(‘estensioni consentite’, ‘jpg, bmp’); // indica quali estesioni  sono consentite (separate con una virgola)

$up->set_opt(‘sovrascrittura’, false); // indica che il file verrà rinominato invece di essere sovrascritto in caso esistesse gia

Dopo aver impostato lo script, lanciate il comando di upload e come parametro impostate il percorso dove andrà salvato il file:

if(!$up->upload(‘files/’))
{
die($up->getError());
}

La funzione ritorna un risultato booleano con il quale potrete richiamare la funzione getError() in caso di errore nell’upload, oppure getName() che ritorna il nome del file uppato in caso di riuscita.

Qui in allegato tutti i file pronti da scaricare: Classe Upload