In questo capitolo extra, ripeterò l'esempio del capitolo precedente utilizzando la programmazione orientata agli oggetti (OOP).

Ho scritto una classe Cookie molto semplice ma che ci consente di trarre dei vantaggi che non avremmo con la sola funzione nativa setcookie.

Classe Cookie

Attributi :

• name - Un nome per il cookie
• value - Il valore da registrare nel cookie
• expire - La durata del cookie espressa in secondi
• path - Path del sito da cui è accessibile il cookie
• domain - Dominio web da cui è accessibile il cookie
• secure - Per impostare il cookie solo su connessioni sicure HTTPS
• httponly - Per rendere accessibile il cookie solo attraverso il protocollo HTTP

Come per setcookie(), solo name è obbligatorio mentre tutti gli altri attributi sono facoltativi.

Metodi :

• setcookie() - Metodo per impostare il cookie
• getPath() - Metodo statico che restituisce la path dello script attualmente in esecuzione
• unserialize() - Metodo statico per recuperare da un cookie l'istanza originale della classe Cookie
• cancella() - Metodo statico per cancellare un cookie
• __toString() - Metodo che restituisce direttamente il valore del cookie se questo viene usato come stringa

Listato della classe Cookie

Introduco ora il codice della classe Cookie che risiede in un file esterno nominato Cookie.php :

<?php

	class Cookie
	{
		public $name;
		public $value;
		public $expire;
		public $path;
		public $domain;
		public $secure;
		public $httponly;

		public function Cookie($n, $v = "", $e = 0, $p = NULL, $d = NULL, $s = false, $h = false)
		{
			$this->name = $n;
			$this->value = $v;
			$this->expire = ($e == 0) ? $e : (int) ($e * 60 * 60) + time();
			$this->path = ($p == NULL) ? Cookie::getPath() : $p;
			$this->domain = $d;
			$this->secure = $s;
			$this->httponly = $h;
		}

		public function setcookie($salva_tutto = false)
		{
			$cookie = ($salva_tutto) ? serialize($this) : $this->value;

			$_COOKIE[$this->name] = $cookie;
			setcookie($this->name, $cookie, $this->expire, $this->path,
			$this->domain, $this->secure, $this->httponly);
		}

		static public function getPath()
		{
			$cartelle = explode("/", $_SERVER["PHP_SELF"]);

			$path = "";
			$dimensione = count($cartelle) - 1;

			for ($i = 0; $i < $dimensione; $i  )
				$path .= $cartelle[$i] . "/";

			return $path;
		}

		static public function unserialize($nomeCookie)
		{
			$cookie = unserialize(stripslashes($_COOKIE[$nomeCookie]));

			if ($cookie instanceof Cookie)
				return $cookie;
			else
				throw new Exception("Cookie corrotto");
		}

		static public function cancella($nomeCookie)
		{
			unset($_COOKIE[$nomeCookie]);
			setcookie($nomeCookie, "", time() - 86400); // Imposta la scadenza al giorno prima
		}

		public function __toString()
		{
			return $this->value;
		}
	}

?>

Vantaggi della classe Cookie

Uno dei vantaggi di questa classe è quello di poter usare solo i parametri che ci interessano realmente, senza obbligatoriamente specificare anche tutti gli altri come avviene con setcookie().

Se ad esempio volessimo specificare solo il nome del cookie, un valore e impostare a true l'opzione httponly sarebbe sufficiente utilizzare il seguente codice :

<?php

	require_once("Cookie.php");
	
	$cookie = new Cookie("nome cookie", "valore del cookie");
	$cookie->httponly = true;
	$cookie->setcookie();

?>

Con setcookie() invece avremmo dovuto specificare per forza anche expire, path, domain e secure per poter arrivare ad httponly rendendo il codice molto meno intuitivo e leggibile. La variante che segue è equivalente al codice soprastante :

<?php

	setcookie("nome cookie", "valore del cookie", 0, "/", NULL, false, true);

?>

Altra particolarità di questa classe è che ci consente di specificare come scadenza direttamente il numero di ore a partire dal momento in cui viene impostato il cookie. Potete facilmente modificare la classe, ad esempio per considerare expire come il numero di giorni di vita del cookie e così via :

<?php

	$cookie = new Cookie("nome cookie", "valore del cookie", 24); // Dura 24 ore
	$cookie->httponly = true;
	$cookie->setcookie();

	// oppure

	setcookie("nome cookie", "valore del cookie", time()   (60 * 60 * 24), "/", NULL, false, true);

?>

Esempio classe Cookie

Di seguito riporto l'esempio del capitolo precedente riscritto per la classe Cookie con la serializzazione dell'oggetto ...

classi_cookie.php

<?php

	require_once("Cookie.php");

	if ($_POST["comando"] == "cancella")
	{
		Cookie::cancella("dato");
	}
	else if ($_POST["comando"] == "imposta")
	{
		$cookie = new Cookie("dato", $_POST["dato"], $_POST["expire"]);
		$cookie->setcookie(true);
	}

?>

<html>
	<head>
		<title>Impostiamo e cancelliamo i Cookie</title>
	</head>
	<body>

		<?php

			if (isset($_COOKIE["dato"]))
			{
				try
				{
					$cookie = Cookie::unserialize("dato");

					echo "Il Cookie \"$cookie->name\" ha il valore = \"$cookie->value\"";
					echo "<br />\nScade in data " . date("d/m/Y - H:i:s", $cookie->expire);
					echo "<br />\nE' accessibile dal dominio \"" . (($cookie->domain) ? $cookie->domain : "default") . "\"";
					echo " per la path \"$cookie->path\"";
					echo "<br />\nsecure = \"" . (($cookie->secure) ? "true" : "false") . "\"";
					echo "<br />\nhttponly = \"" . (($cookie->httponly) ? "true" : "false") . "\"";
				}
				catch (Exception $e)
				{
					echo "<h3>" . $e->getMessage() . "</h3>";
				}

				?>

				<br /><br />

				<form name="deletecookie" action="classi_cookie.php" method="post">
					<input type="hidden" name="comando" value="cancella" />

					<input type="submit" value="Cancella cookie" />
				</form>

				<?php
			}
			else
			{
				?>

				<form name="writecookie" action="classi_cookie.php" method="post">
					<table width="400" border="0" cellspacing="5" cellpadding="5">

						<tr>
							<td>Dato da memorizzare</td>
							<td><input type="text" name="dato" value="" /></td>

						</tr>
						<tr>
							<td>Scadenza del cookie</td>
							<td><input type="text" name="expire" value="" /></td>

						</tr>
						<tr>
							<td><input type="submit" value="Imposta cookie" /></td>

							<td> </td>
						</tr>
					</table>
					<input type="hidden" name="comando" value="imposta" />

				</form>

				<?php
			}
		
		?>

	</body>
</html>

Come ogni linguaggio server-side che si rispetti, anche PHP ci consente lo scambio di dati fra pagine con i metodi classici che HTML ci mette a disposizione : GET e POST.

Con entrambi i metodi l'invio dei dati avviene tramite un normale form HTML, e PHP ci consente di prelevarli attraverso i due array globali $_GET[] e $_POST[].

Al form HTML sono necessari due paramentri principali : action e method.

A seconda del DOCTYPE che utilizzate nella vostra pagina e dagli scopi del vostro script potrebbero servire anche i parametri id e name (enctype, target ...) che io ormai specifico sempre perchè abituato ad usare il DOCTYPE XHTML 1.0 che richiede fra l'altro che i valori dei parametri siano racchiusi fra doppi apici, ma non è scopo di questa guida che illustrerà solo il funzionamento della parte PHP, vi consiglio pertanto lo studio delle ultime versioni di HTML e XHTML prima di cominciare a sviluppare delle applicazioni a livello commerciale.

Tornando al nostro form HTML vediamo a cosa corrispondono i parametri action e method :

• action - Indica la pagina a cui inviare i dati. Se lasciato vuoto punterà di default alla pagina stessa.
• method - Indica il metodo in cui avviene lo scambio di dati : "get" o "post".

L'attributo "name" degli elementi "input" usati all'interno del form HTML è molto importante, poichè rappresenta la chiave che useremo per accedere all'array globale $_GET[] e che ci consentirà di leggere il valore del dato inviato.

Esempio invio di dati

Iniziamo con un esempio semplice composto da due pagine : una in HTML che invia i dati e una in PHP che li riceve.

inviodati.html

<html>
	<head>

		<title>Pagina HTML per l'invio dei dati</title>
	</head>
	<body>
		<form action="ricezionedati.php" method="get">

			<input type="text" name="miotesto" />
			<input type="submit" value="Invia dati" />

		</form>
	</body>
</html>

ricezionedati.php

<html>
	<head>
		<title>Pagina PHP per la ricezione dei dati</title>
	</head>

	<body>
		<?php

			if (strlen($_GET["miotesto"]))
				echo "Mi hai inviato la stringa \"" . $_GET["miotesto"] . "\"";
			else
				echo "Non mi hai inviato nulla!!";

		?>

	</body>
</html>

Niente di più semplice, usiamo il nome dell'attributo name per accedere all'array globale $_GET[] e il gioco è fatto.

Con la funzione strlen() effettuo un semplice controllo per vedere se è stato inviato almeno un carattere.

Una volta inviati i dati e caricata la pagina ricezionedati.php, potrete notare nella barra degli indirizzi del vostro browser che i dati inviati sono in chiaro e perfettamente leggibili dall'utente finale :

http://localhost/test/ricezionedati.php?miotesto=testo+da+inviare

Il metodo GET infatti, consiste semplicemente nell'accodare all'URL della pagina un punto interrogativo a cui seguiranno tutte le variabili inviate con la sintassi variabile=valore, separate da una E commerciale & :

pagina.php?variabile1=valore&variabile2=valore&variabile3=altro+valore

Il metodo POST è equivalente al GET con la differenza che POST quando invia i dati non li mette in chiaro nell'URL.

Un metodo è migliore di un altro a seconda del caso ma mai a prescindere.
Come forse avrete notato, in questo stesso sito vengono usati entrambi i metodi.

Ho usato POST per inviare dati sensibili preservando un minimo di sicurezza, mentre ho usato GET per far sapere a guide.php quale pagina deve caricare, mettendo in chiaro il titolo della pagina nell'URL, favorendo il posizionamento sui motori di ricerca per quelle determinate parole chiave (Web Marketing).

Scrivendo applicazioni e creando siti vi ritroverete senzaltro in situazioni in cui preferirete POST e altre in cui è preferibile GET.

Esempio invio dati su pagina singola

Vedremo ora un ultimo esempio in cui inviamo e riceviamo i dati nella stessa pagina, stavolta col metodo POST.

invio_ricezione.php

<html>
	<head>

		<title>Invio e ricezione in unica pagina</title>
	</head>
	<body>
		<?php

			if (strlen($_POST["miotesto"]))
			{
				echo "Dato inviato = " . $_POST["miotesto"];
			}
			else
			{
				?>

					<form action="" method="post">
						<input type="text" name="miotesto" />
						<input type="submit" value="Invia dato" />

					</form>

				<?php
			}

		?>
	</body>
</html>

Nota : solitamente l'estensione delle pagine contenenti PHP dovrà essere ".php" o lo script verrà interpretato come semplice testo (dipende dalla configurazione del server).

Con questo capitolo concludo tutta la parte che riguarda la struttura e la sintassi del linguaggio, per avvicinarmi a un livello più avanzato di questa guida, dove inizierò ad illustrare i metodi e gli strumenti che PHP 5 ci fornisce per realizzare delle vere applicazioni web, per interagire con l'utente e scambiare dati e molto altro.

Prima di proseguire volevo darvi qualche consiglio su come usare al meglio quello che avete imparato finora.

Per molti altri invece potrà essere un vantaggio, io in ogni caso vi consiglio di fare molta attenzione quando sviluppate i vostri script, facendo largo uso dell'operatore instanceof e specificando ogni volta che vi sarà possibile il tipo di Classe usata nei parametri delle funzioni, sfruttando il più possibile il Polimorfismo, per essere sempre certi che la vostra applicazione stia lavorando sulle classi giuste.

<?php

	$obj = new MioOggetto();

	if ($obj instanceof MioOggetto)
		// continua è tutto ok
	else throw new Exception("Tipo di dato non corretto");

?>

Usate sempre try e catch per gestire le eccezioni, ma usateli solo per le eccezioni appunto e mai come struttura di controllo.

Se siete capitati qui per caso, perchè avete cercato la frase sbagliata su Google vi consiglio di dare una letta anche al resto :-P

Non avete idea (o magari si LOL) di quanta gente che si dice esperta di IT non sa neanche fare una ricerca corretta su Internet.
Perdonate il fuori tema, ma visto che ci sono vi informo che le ricerche migliori e più rilevanti sono proprio quando beccate le frasi in mezzo a un testo in tema, che difficilmente non saranno articolate visto che nessuno parla come un cazzo di robot.

Un esempio stupido ... è più probabile ottenere dei risultati rilevanti cercando con varie frasi articolate tipo "marmellata di fragole" piuttosto che scrivere in stile telegramma "marmellata fragole".

E qui non vi metto neanche la pubblicità in mezzo al testo ... tanto nei 40 euro di tenuta server annui non ci rientro comunque.

Buon proseguimento e buone ricerche.