• Apache: 2.0.55
• PHP HP 4.4.2 in 5.1.2
• MySQL 5.0.22

Zadnji moji projekti močno bazirajo na knjižicah Zend Frameworka, ki pa rabijo verzijo PHP-ja vsaj 5.1.4 (priporočljiva je uporaba 5.2.3 naprej). Kar pomeni, da bi se lahko pod nosom obrisal, da bi VPS uporabljal kot platformo za razvoj, z samo predpripravljenimi paketi seveda.

Ostali sta mi dve opciji:

• building in compiling iz nule
• download in usposobitev XAMPP-a^[1]

Predvsem zaradi varnosti in dejstvu, da imam rad vajeti vedno v rokah, sem se odločil, da bom inštaliral veliko trojico iz nule. Pljunil sem v roke, ter zavihal rokave … ./configure, make in make install so bili dva dni moji hardcore spremljevalci. Ker je bil to moj prvi podvig inštalacije apache, mysql in php-ja iz source datotek, je bilo veselje ko je vse skupaj zalaufalo brez napak toliko večje.

Za vse, ki bi kdaj želeli ubosti podoben podvig, pa sem pripravil nekaj skript, da vam bo stvar lažje šla od rok.

How to Build Apache 2.2.8, MySQL 5.0.51, PHP 5.2.5 on Ubuntu Dapper (6.06)

Poglejmo konfiguracijo:

• Apache/2.2.8 mod_ssl/2.2.8 OpenSSL/0.9.7m DAV/2
• MySQL 5.0.51 z SSL podporo
• PHP 5.2.5 v večino dodatkov ki jih rabim pri razvoju: cURL, OpenSSL, PDO MySQL, IMAP, …

Na kakšne večje težave nisem naletel. OpenSSL verzija 0.9.8 se nikakor ni hotela skompajlirat z MySQL-om, tako da sem potem ubodel eno minor verzijo niže. Nekatere skripte (imap, PDO_MySQL) so v configuracijskih datotekah narobe referencirale nekatere knjižice. To se najlažje reši z simboličnim linkanjem na zahtevane knjižice.

Še kratka navodila. Skripte, ki jih najdete v zip-u prebirajte in zaganjajate v tem vrstem redu^[2]:

• preberi apache2-pre-install.txt
• zaženi apache2-download.sh
• zaženi apache2-install.sh
• preberi apache2-post-install.txt
• enako storitze še za mysql ter php

Apache laufa pod svojim userjem, prav tako MySQL. Ne pozabite še nastavit root gesla za MySQL uporabnika. V primeru da se compiler ustavi in ne boste vedeli, kaj je narobe, sem vam na voljo :)

Še vpogled v eno od shell skript – apache2-download.sh

#!/bin/sh

#
# Downloads and unpacks apache2 with dependencies
#
# @author Ales Loncar <ales.loncar@internet-solutions.si>
# @copyright 	Copyright (c) 2008 Internet Solutions
# @license GNU Public License
# @link http://www.internet-solutions.si
# @version 1.0

echo
echo apache2-download.sh
echo - This script downloads and unpacks all prerequisite packages
echo - Run this script before apache2-install.sh
echo
read -p  "(Press any key to continue)" temp;
echo

# Abort on any errors
set -e

#source directory (/usr/local/src)
SRCDIR=/usr/local/src

# Set DISTDIR to somewhere persistent, if you plan to muck around with this
# script and run it several times!
DISTDIR=/usr/local/dist

# Update version information here.
# Zlib
ZLIB="zlib-1.2.3"
# OpenSSL
OPENSSL="openssl-0.9.7m"
# libiconv
LIBICONV="libiconv-1.12"
# apache2
HTTPD="httpd-2.2.8"

cd ${DISTDIR}

# Get all the required packages
echo
echo --- Downloading all required packages ---
echo

# Zlib
wget -c http://www.zlib.net/${ZLIB}.tar.gz
# OpenSSL
wget -c http://www.openssl.org/source/${OPENSSL}.tar.gz
# libiconv
wget -c http://ftp.gnu.org/pub/gnu/libiconv/${LIBICONV}.tar.gz
# apache2
wget -c http://www.apache.si/httpd/${HTTPD}.tar.gz

echo
echo --- Unpacking downloaded archives. This process may take several minutes! ---
echo

cd ${SRCDIR}
# Unpack them all
# Zlib
echo Extracting ${ZLIB}...
tar xzf ${DISTDIR}/${ZLIB}.tar.gz > /dev/null
echo Done.
# OpenSSL
echo Extracting ${OPENSSL}...
tar xzf ${DISTDIR}/${OPENSSL}.tar.gz > /dev/null
echo Done.
# libiconv
echo Extracting ${LIBICONV}...
tar xzf ${DISTDIR}/${LIBICONV}.tar.gz > /dev/null
echo Done.
# apache2
echo Extracting ${HTTPD}...
tar xzf ${DISTDIR}/${HTTPD}.tar.gz > /dev/null
echo Done.

echo --------------------------------------------------
echo -- Done downloading and unpacking prerequisites --
echo --------------------------------------------------

Happy blogging(coding)!

1. Uporabo XAMPP-a odsvetujejo v produksijskem okolju, zaradi prešibke varnosti nekaterih procesov, ki laufajo brez gesel
2. Za zagon shell skript rabite root privilegije. Ne pozabite jim nastavit execute pravic: chmod +x

• ekipa sodelujočih pri razvoju iz vrst Zend-a, IBM-a, OmniTI, …
• kvaliteta in testiranje – čez 4.000 unit testov. Vse knjižice so testirane z uporabo PHPUnit.

MVC – Model View Controller
Velika večina “frameworkov” se vedno znova vrti okrog lastne implementacije MVC-ja. Če želite uiti iz tega začaranega kroga, je boljše, da tak framework me uporabite. Seveda tudi Zend Framework vključuje module, ki vam pomagajo pri postavitvi MVC-ja in načinov kako to dosežemo je kar nekaj. Z malce programerskega znanja boste lahko vključili že obstoječe “third-party” knjižice kot so SwiftMailer, Smarty, Propel, ADOdb, … ali pa svoje knjižice zamenjali z Zendovimi:

• za delo z sejami – Zend_Session
• za keširanje podatkov, objektov, spletnih strani – Zend_Cache
• …

A je za začetnike?
Možno, je da si bom s to izjavo nakopal kakšnega “sovražnika”, ampak Zend Framewok je profesionalen izdelek in ni ravno namenjen začetnikom, ki se šele spoznavajo s PHP-jem. Čeprav je glavna filozofija in moto frameworka “Extreme simplicity”, so določeni pogledi MVC-ja in ostalih modulov precej bolj kompleksni od ostalih frameworkov (CodeIgniter, CakePHP, …). Če niste ravno naklonjeni, da občasno več ur namenite brskanju po izvorni kodi ali pa vam je uporaba API-ja tuja, vam svetujem da si omislite kaj drugega!

Primer uporabe Zend Framework knjižic
Ostane nam še demo primer uporabe. Test case je vzet iz vsakdanjika. Preko URL-ja preberemo parameter id, če id ni nastavljen ali pa ni tipa int ga nastavimo na nulo. Če slučajno zaznamo metodo POST ustavimo skripto.

Stari način:

if (isset($_GET['id']) and $_GET['id'] != "") {
	$id = (int) $_GET['id'];
} else {
	$id = 0;
}

if (strtolower($_SERVER['REQUEST_METHOD']) == 'post')
	die('POST detected');

Zend Framework:

/** Zend/Validate.php */
require_once 'Zend/Validate.php';

/** Zend/Controller/Request/Http.php */
require_once 'Zend/Controller/Request/Http.php';

/** request object */
$request = new Zend_Controller_Request_Http();

/** id */
$id = ( Zend_Validate::is($request->getQuery('id'), 'Int') ) ? (int) $request->getQuery('id') : 0;

if ($request->isPost())
	die('POST detected');

Kakor vam drago :)

Happy blogging(coding)!

1. Library
2. overriding, subclassing

error_reporting(E_ALL|E_STRICT);

echo $x;

S tem error reporting levelom vsaka nedefinirana spremenljivka^[2] sproži obvestilo^[3]

/**
 * Foo Bar application
 *
 * @category	Foo
 * @package    	Foo_Static
 * @copyright  	Copyright (c) 2007 Ales Loncar
 * @license 	GNU Public License
 * @link    http://www.internet-solutions.si
 */
class Foo
{
    /**
     *  Bar method
     */
    public function Bar()
    {
        // static method - not properly defined
    }
}

$fooBar = Foo::Bar();

Neupoštevanje standardov prav tako^[4]

try/catch
PHP 5 uporablja podoben model izjem – “Exceptions” kot ostali programski jeziki. Da ne bom preveč modruval, vse je lepo opisano v PHP “manualu“. Omeniti velja le, da ko se zgodi izjema – “exception is thrown”, se koda ki sledi ne izvede, PHP bo poiskusil najti prvi ustrezen block “catch”. V primeru da izjema ni ujeta – “catch”, PHP izvede Fatal Error z sporočilom “Uncaught Exception …”^[5]
Veselo na delo, glavna ideja je taka:

• definiramo error handling funkcijo, ki vrže izjemo – exception z ustreznim sporočilom in kodo^[6]
• definiramo exception handling funkcijo s katero lovimo – “catch” izjeme, tudi tiste, ki niso v bloku try/catch
• stestiramo error/exception handler na nekaj primerih

set_error_handler
Nastavimo lastno funkcijo za rokovanje z napakami v skripti.

/**
 * Global Error Handler
 *
 * Global error handler class
 *
 * @author		Ales Loncar
 * @license 	GNU Public License
 * @category	App
 * @package    	App_Error
 * @copyright 	Copyright (c) 2007 Ales Loncar
 */
class General_Error_Handler
{
/**
 * Global error handler.
 *
 * This should not be called by anything - only for uncaught errors.
 *
 *
 */
	public function globalErrorHandler($errno, $errstr, $errfile, $errline)
	{
		throw new Exception($errstr, $errno);
	}
}

/** set ErrorHannlder */
set_error_handler(array(new General_Error_Handler(), 'globalErrorHandler'));

set_exception_handler
Nastavimo privzeto funkcijo za rokovanje z izjemami. S tem ujamemo izjeme katere nismo ujeli v blok try/catch. Izvajanje se ustavi takoj ko se izvede exception_handler.

/**
 * Global Exception Handler
 *
 * Global exception handler class
 *
 * @author		Ales Loncar
 * @license 	GNU Public License
 * @category	App
 * @package    	App_Error
 * @copyright 	Copyright (c) 2007 Ales Loncar
 */
class General_Exception_Handler
 {
 	/**
	 * Global exception handler.
	 *
	 * This should not be called by anything - only for uncaught exceptions.
	 *
	 */
	public function globalExceptionHandler(Exception $exception)
	{
		$this->_throwException($exception);
	}

	/**
	 * Nice debugging info for Exception
	 *
	 * @param Exception $e
	 */
	private function _throwException($e)
   	{
		$o = create_function('$in','echo htmlspecialchars($in);');
                // celotno funkcijo najdete v zipu
               // totalno sjebe parser saj so v njej php tagi
        }
}

/** set Exception Handler */
set_exception_handler(array(new General_Exception_Handler(), 'globalExceptionHandler'));

Sedaj ko imamo oba handlerja, se bomo malce poigrali.
Primer uporabe izjeme v bloku try/catch

/** error reporting */
error_reporting(E_ALL|E_STRICT);

/** debug is true for development */
define('DEBUG', true);

/** let's try some of this stuff */
try {
    $x = 0;
    if (empty($x)) {
        throw new Exception('x is zero', 0);
    }
} catch(Exception $e) {
    if (DEBUG) {
        throw $e;
    } else {
        if ($e->getCode() == 0) {
            // notify about exception
			$errorCode	  = $e->getCode();
                        $errorMessage 	= $e->getMessage();
			// send mail or write log
			// ...
			echo "<b>errorCode:</b> $errorCode<br />";
			echo "<b>errorMessage:</b> $errorMessage<br />";
			echo "<br />";
        }
    }
}

// continue Execution
echo '<b>continue:</b> Foo bar';

//$x = $y;

Mali komentarček:
Celotna koda je v bloku “try/catch”. Če ne bi definirali exception handlerja in ima konstanta DEBUG vrednost true^[7] bo PHP navrgel Fatal Error
Z vključenim exception handlerjem se izvede metoda _throwException() z zelo uporabnim “Stacktracom”, celotnim naborom “Request” metod in “Response” headerjem. Izvajanje skripte se prekine.

Npr. da aplikacijo objavimo in nastavimo DEBUG vrednost na false^[8]. Sedaj v primeru izjeme le te ne vržemo – “thrown”, ampak pogledamo do kakšne napake je prišlo ter obvestimo skrbnika aplikacije oziroma zapišemo vsebino izjeme v log.^[9]. Skripta se izvaja normalno naprej.

Če podamo še primer error handlerja, ki pretvori obvestila in opozorila v izjeme. Izven bloka “try/catch” naredimo eno amatersko:

$x = $y;

Ker imamo definiran exception handler se bo koda ustavila na mestu, kjer PHP izpiše obvestilo o nedefinirani spremenljivki.

Poglejmo še samo, kaj se zgodi takrat če ne bi imeli definiran error handler. Skripta se izvede naprej, PHP pa izpiše obvestilo “Notice: Undefined variable: y in …” saj imamo nastavljen error_reporting na E_ALL|E_STRICT.

Vse skupaj sem zapakiral in lahko po mili volji “dol vlačite”: Error & Exception Handler

Happy blogging(coding)!

1. o samem frameworku in kupu uporabnih knjižic enkrat v prihodnosti
2. kot primer
3. Za ta čuden izpis je kriv Xdebug – PHP extension for debugging and profiling. Otom potom :)
4. kot primer
5. le v primeru da nimamo definiranega “custom handlerja” s funkcijo set_exception_handler()
6. tukaj dejansko pretvorimo obvestila in opozorila v izjeme
7. development
8. production
9. z karseda večimi informacijami – stacktrace …