Interfejs

<?php
 
/**
* Definicja interfejsu
*/
interface Testowy
{
	/**
	* Metoda, którą musi zawierać klasa opierająca się na tym interfejsie
	*/
	public function wymaganaMetoda($argument, $innyArgument);
 
	/**
	* Inna wymagana metoda
	*/
	public function innaWymaganaMetoda($argument);
 
	/*
	* ...
	* Definicje innych wymaganych metod
	* ...
	*/
}
?>

<?php
 
/**
* Klasa, która implementuje interfejs Testowy
*/
class Klasa implements Testowy
{
	/*
	* Zwykła definicja klasy, w której muszą się znależą metody zdefiniowane w interfejsie Testowy
	*/
 
	/**
	* Metoda wymagana przez interfejs
	*/
	public function wymaganaMetoda($argument, $innyArgument)
	{
		/*
		* ...
		* Zawartość metody
		* ...
		*/
	}
 
 
	/**
	* Metoda wymagana przez interfejs
	*/
	public function wymaganaMetoda($argument, $innyArgument)
	{
		/*
		* ...
		* Zawartość metody
		* ...
		*/
	}
 
	/*
	* ...
	* Inne metody, które nie są wymagane - publiczne lub prywatne
	* ...
	*/
}
 
?>

<?php
 
/**
* Klasa, która implementuje interfejsy Testowy i InnyInterfejs
*/
class Klasa implements Testowy, InnyInterfejs
{
	/*
	* ...
	* Metody zdefiniowane w interfejsach Testowy i InnyInterfejs
	* ...
	*/	
}
 
?>

<?php
/*
* Kod zadziałał jedynie w PHP od wersji 5.0
*
* Komentarze w formacie phpDoc
*/
 
/**
* Interfejs dla parsera URL
*/
interface Url
{
	/**
	* Konstruktor
	*
	* @param	string	$url	URL do sparsowania
	* @return	void
	*/
	public function __construct($url);
 
	/**
	* Zwraca parametr wyciągnięty z URLa
	*
	* @param	string	$name	Nazwa parametru
	* @return	string		Wartość parametru
	*/
	public function getParam($name);
 
	/**
	* Zwraca ścieżkę wyciągniętą z URLa
	*
	* @return	string		Scieżka
	*/
	public function getPath();
 
	/**
	* Zwraca nazwę hosta wyciągniętą z URLa
	*
	* @return	string		Nazwa hosta
	*/
	public function getHost();
 
	/**
	* Zwraca prefiks protokołu wyciągnięty z adresu URL
	*
	* @return	string		Prefiks protokołu
	*/
	public function getProtocol();
}
 
?>

<?php
/*
* Kod zadziałał jedynie w PHP od wersji 5.0
*
* Komentarze w formacie phpDoc
*/
 
/**
* Parser URLa w standardowym formacie
*/
class StandardUrl implements Url
{
	/**
	* @var	string	Niesparsowany URL
	*/
	private $url;	
 
	/**
	* @var	array	Parametry wyciągnićte z URLa
	*/
	private $params;
 
	/**
	* @var	string	Nazwa hosta wyciągnićta z URLa
	*/
	private $hostName;
 
	/**
	* @var	string	Ścieżka  wyciągnięta z URLa
	*/
	private $path;
 
	/**
	* Konstruktor
	*
	* @param	string	$url	URL do sparsowania
	* @return	void
	*/
	public function __construct($url)
	{
		$this->url = $url;
 
		try
		{
			$this->parse();
		}
		catch (Exception $e)
		{
			// ... obsługa błędów ...	
		}
	}
 
	/**
	* Parsuje URL
	*
	* @return void
	*/
	private function parse()
	{
		/*
		* ...
		* Parsowanie URLa:
		* Wyciąganie z niego parametrów, nazwy hosta, ścieżki, prefiksu protokołu, itp
		* oraz wwalenie ich do odpowiednich pól klasy
		* ...
		*/
	}
 
	/**
	* Zwraca parametr wyciągnićty z URLa
	*
	* @param	string	$name	Nazwa parametru
	* @return	string			Wartość parametru
	*/
	public function getParam($name)
	{
		if (isset ($this->params[$name]))
		{
			return $this->params[$name];
		}
		else 
		{
			throw new Exception('Parametr nie istnieje');
		}
	}
 
	/**
	* Zwraca ścieżkć wyciągniętą z URLa
	*
	* @return	string		Ä?Âącieżka
	*/
	public function getPath()
	{
		if ($this->path)
		{
			return $this->path;
		}
		else 
		{
			throw new Exception('Sciezka nie zostala zdefiniowana');
		}
	}
 
	/**
	* Zwraca nazwę hosta wyciągniętą z URLa
	*
	* @return	string		Nazwa hosta
	*/
	public function getHostName()
	{
		if ($this->hostName)
		{
			return $this->hostName;
		}
		else 
		{
			throw new Exception('Nazwa hosta nie zostala zdefiniowana');
		}
	}
}
 
?>