Gli utilizzi sono molteplici, nel mio caso si tratta di far comunicare due applicazioni flash usando delle pagine php come ponte, nel modo più veloce e meno oneroso possibile. La prima applicazione inizializza semaforo, memoria condivisa e variabile di comunicazione, sfruttando come discriminante il proprio id di sessione.

<?php
/* start.php */
session_start();

$MEMSIZE = 512; //  dimensione della memoria condivisa (byte)

$filename = session_save_path() . '/sess_' . session_id();
echo "$filename<br />\n";

$SEMKEY = ftok('/','S');    //  key semaforo
$SHMKEY = ftok('/','M');    //  key shared memory
echo "$SEMKEY [semaforo]<br />\n";
echo "$SHMKEY [shared mem]<br />\n";

// Creo il semaforo
$sem_id = sem_get($SEMKEY, 1);
if ($sem_id !== false) {
	echo "Semaforo creato [$sem_id]<br />\n";

	// Acquisisco il semaforo
	if (sem_acquire($sem_id)) {
		echo "Semaforo acquisito [$sem_id]<br />\n";

		// Associo la shared mem al semaforo
		$shm_id = shm_attach($SHMKEY, $MEMSIZE);
		if ($shm_id !== false) {
			echo "Memoria condivisa associata [$shm_id]<br />\n";

			// Inializzo la variabile
			if (shm_put_var($shm_id, 1, "Variable 1 ciao")) {
				echo "Variabile inizalizzata<br />\n";

				// Rilascio il semaforo
				if (sem_release($sem_id)){
					echo "Semaforo rilasciato<br />\n";
				} else {
					echo "Errore nel rilascio del semaforo<br />\n";
					sem_remove($sem_id);
					shm_remove($shm_id);
				}
				
			} else {
				echo "Errore nella scrittura della variabile<br />\n";
				sem_remove($sem_id);
				shm_remove($shm_id);
			}
		} else {
			echo "Errore nell'associazione della memoria condivisa<br />\n";
			sem_remove($sem_id);
		}
	} else {
		echo "Errore nell'acquisizione del semaforo<br />\n";
		sem_remove($sem_id);
	}
} else {
	echo "Errore nella creazione del semaforo<br />\n";
}
<?

A questo punto la sessione paritaria deve soltanto conoscere l'id della sessione con cui vuole comunicare, in modo da poter inizializzare le chiavi del semaforo e della memoria condivisa. Richiamando il codice seguente, per esempio, può leggere il valore della variabile condivisa:

/* read.php */
<?php
session_start();

if (isset($_GET['file'])){

	$filename = $_GET['file'];
	echo "$filename<br />\n";

	$MEMSIZE = 512;             //  dimensione della memoria condivisa (byte)
	$SEMKEY = ftok('/','S');    //  key semaforo
	$SHMKEY = ftok('/','M');    //  key shared memory
	echo "$SEMKEY [semaforo]<br />\n";
	echo "$SHMKEY [shared mem]<br />\n";

	// Creo il semaforo
	$sem_id = sem_get($SEMKEY, 1);
	if ($sem_id !== false) {
		echo "Semaforo creato [$sem_id]<br />\n";

		// Acquisisco il semaforo
		if (sem_acquire($sem_id)) {
			echo "Semaforo acquisito [$sem_id]<br />\n";

			// Associo la shared mem al semaforo
			$shm_id = shm_attach($SHMKEY, $MEMSIZE);
			if ($shm_id !== false) {
				echo "Memoria condivisa associata [$shm_id]<br />\n";

				// Leggo la variabile
				$var1 = shm_get_var($shm_id, 1);
				if ($var1 !== false) {
					echo "Variabile letta [$var1]<br />\n";

					// Rilascio il semaforo
					if (sem_release($sem_id)){
						echo "Semaforo rilasciato<br />\n";
					} else {
						echo "Errore nel rilascio del semaforo<br />\n";
						sem_remove($sem_id);
						shm_remove($shm_id);
					}
					
				} else {
					echo "Errore nella lettura della variabile<br />\n";
					sem_remove($sem_id);
					shm_remove($shm_id);
				}
			} else {
				echo "Errore nell'associazione della memoria condivisa<br />\n";
				sem_remove($sem_id);
			}
		} else {
			echo "Errore nell'acquisizione del semaforo<br />\n";
			sem_remove($sem_id);
		}
	} else {
		echo "Errore nella creazione del semaforo<br />\n";
	}
} else {

?>

<form action='read.php' method='get'>
  <input type='text' name='file' /><br />
  <input type='submit' />
</form>

<?php
}
?>

Richiamando (da un altro browser) la pagina senza parametri viene presentata una form che richiede l'inserimento del path del file di sessione del paritario. In questo caso basta un cut/paste dall'output della pagina precedente, in un applicazione reale ci si appoggierà ad un database. Inserendolo si prende il controllo del semaforo, ed in seguito si può leggere il contenuto della variabile di sessione. In modo del tutto analogo si può modificare il contenuto della variabile:

/* write.php */
<?php
session_start();

if (isset($_GET['file']) && isset($_GET['value'])){

	$filename = $_GET['file'];
	echo "$filename<br />\n";
	$value = $_GET['value'];
	echo "$value<br />\n";

	$MEMSIZE = 512;             //  dimensione della memoria condivisa (byte)
	$SEMKEY = ftok('/','S');    //  key semaforo
	$SHMKEY = ftok('/','M');    //  key shared memory
	echo "$SEMKEY [semaforo]<br />\n";
	echo "$SHMKEY [shared mem]<br />\n";

	// Creo il semaforo
	$sem_id = sem_get($SEMKEY, 1);
	if ($sem_id !== false) {
		echo "Semaforo creato [$sem_id]<br />\n";

		// Acquisisco il semaforo
		if (sem_acquire($sem_id)) {
			echo "Semaforo acquisito [$sem_id]<br />\n";

			// Associo la shared mem al semaforo
			$shm_id = shm_attach($SHMKEY, $MEMSIZE);
			if ($shm_id !== false) {
				echo "Memoria condivisa associata [$shm_id]<br />\n";

				// Scrivo la variabile
				if (shm_put_var($shm_id, 1, $value)) {
					echo "Variabile scritta [$value]<br />\n";

					// Rilascio il semaforo
					if (sem_release($sem_id)){
						echo "Semaforo rilasciato<br />\n";
					} else {
						echo "Errore nel rilascio del semaforo<br />\n";
						sem_remove($sem_id);
						shm_remove($shm_id);
					}
					
				} else {
					echo "Errore nella scrittura della variabile<br />\n";
					sem_remove($sem_id);
					shm_remove($shm_id);
				}
			} else {
				echo "Errore nell'associazione della memoria condivisa<br />\n";
				sem_remove($sem_id);
			}
		} else {
			echo "Errore nell'acquisizione del semaforo<br />\n";
			sem_remove($sem_id);
		}
	} else {
		echo "Errore nella creazione del semaforo<br />\n";
	}
} else {

?>

<form action='write.php' method='get'>
	<input type='text' name='file' /><br />
	<input type='text' name='value' /><br />
	<input type='submit' />
</form>

<?php
}
?>

A questo punto non resta che da implementare una pagina per distruggere l'area di memoria condivisa, in modo da non incappare in problemi di saturazione della memoria.

Lascio la creazione di tale pagina come esercizio, dato che non trovo più il relativo sorgente

/* delete.php */

Il codice presentato è un semplice proof of concept, e non è da intendersi valido per un utilizzo in produzione. Mancano tutta una serie di controlli sulla corretta gestione della memoria, sulla validazione del paritario e del necessario timing nel caso in cui si cerchi di accedere ad un semaforo "rosso". Magari in un prossimo post affronterò la questione, per ora devo andarmela a studiare

Happy coding!

Ma niente è meglio di un esempio:

Ce n'è da sbizzarrirsi, una volta caricati i dati della tabella tramite PHP, AJAX, HTML o XML entra in gioco il javascript, che permette un'infinità di giochetti. In questo esempio ho usato l'ordinamento per colonna, i filtri, l'highlight delle righe ed i link condizionali. Oltre naturalmente alla possibilità di ridimensionare al volo le colonne ed al fatto che la tabella occupa una spazio prefissato. Non ultimo l'header resta fisso durante lo scrolling, risultato non banale se mai avete tentato di fare qualcosa di simile!

Il codice usato è relativamente poco, grazie all'ottimo framework OpenRico, che si appoggia su ProtoType. Inizio con l'inizializzazione di ciò che mi serve:

// Carico tutti gli elementi necessari
Rico.loadModule('LiveGrid','LiveGridMenu','gest.css');
// var orderGrid,buffer;
var CustId='1';
var CustIdCol=7;

Qui c'è la parte più succosa: definisco una classe che in seguito assegnerò alla variabile control, all'interno della definizione delle colonne. Questa classe indica a alla LiveGrid che le colonne interessate dovranno avere un determinato colore di sfondo ed un link condizionale, stabilito sulla base del contenuto di una colonna. Le classi predefinite in OpenRico sono disponibili nel file ricoLiveGridControls.js, e sono un ottimo punto di partenza per svilupparne di proprie.

// Creo la Classe - classi preesistenti in ricoLiveGridControls.js
HighlightCellAndLink = Class.create();
// Dichiaro la classe - si tratta di un misto tra due classi esistenti
HighlightCellAndLink.prototype = {

	initialize: function(chkcol,chkval,highlightColor,highlightBackground,href,target) {
		this._chkcol=chkcol;
		this._chkval=chkval;
		this._highlightColor=highlightColor;
		this._highlightBackground=highlightBackground;

		this._href=href;
		this._target=target;
		this._anchors=[];
	},
  _create: function(gridCell,windowRow) {
		this._anchors[windowRow] = RicoUtil.createFormField(gridCell,'a',null,this.liveGrid.tableId+'_a_'+this.index+'_'+windowRow);
		if (this._target) this._anchors[windowRow].target=this._target;
		this._clear(gridCell,windowRow);
  },
  _clear: function(gridCell,windowRow) {
		gridCell.style.color='';
		gridCell.style.backgroundColor='';
	
		this._anchors[windowRow].href='';
		this._anchors[windowRow].innerHTML='';
  },
  _display: function(v,gridCell,windowRow) {
		var gridval=this.liveGrid.buffer.getWindowValue(windowRow,this._chkcol);
		var match=(gridval==this._chkval);
		gridCell.style.color=match ? this._highlightColor : '';
		gridCell.style.backgroundColor=match ? this._highlightBackground : '';
	
		this._anchors[windowRow].innerHTML=this._format(v);
		var getWindowValue=this.liveGrid.buffer.getWindowValue.bind(this.liveGrid.buffer);
		this._anchors[windowRow].href=this._href.replace(/\{\d+\}/g,
		function ($1) {
			var colIdx=parseInt($1.substr(1));
			return getWindowValue(windowRow,colIdx);
		}
	);
  }

}

Infine dichiaro alcune variabili ed intervengo sul core della LiveGrid: definisco i parametri di ciascuna colonna.

Rico.onLoad( function() {
// Carico i dati della tabella dentro al Rico Buffer javascript
var buffer = new Rico.Buffer.Base($('dataTable').tBodies[0]);
// Preparo le opzioni
var grid_options = {
headingSort: 'hover',
highlightElem: 'cursorRow',
FilterLocation: -1,
visibleRows: 23,
saveColumnInfo: {width:false, filter:false, sort:false},
columnSpecs: [

{
	height:50, 
	width:113,
	filterUI:'t^20',
	control:new Rico.TableColumn.HighlightCell(CustIdCol,CustId,'black','#FBC880')
}, // id
{
	width:185, 
	filterUI:'t^20', 
	control:new Rico.TableColumn.HighlightCell(CustIdCol,CustId,'black','#FBC880')
}, // Rag. sociale
{
	width:78, 
	filterUI:'t^20', 
	control:new Rico.TableColumn.HighlightCell(CustIdCol,CustId,'black','#FBC880')
}, // tipo lic.
{
	width:25, 
	control:new Rico.TableColumn.HighlightCell(CustIdCol,CustId,'black','#FBC880'),
	ClassName:'centred'
}, // n. lic.
{
	type:'date',
	dateFmt:'dd/mm/yyyy',
	width:75, 
	control:new Rico.TableColumn.HighlightCell( CustIdCol,CustId,'black','#FBC880' )
}, // scad. ass.
{
	visible:false
}, // log id
{
	control:new HighlightCellAndLink(CustIdCol,CustId,'black','#FBC880','/','_blank'), 
	type:'date', 
	dateFmt:'dd/mm/yyyy', 
	width:75
}, // ultimo agg.
{
	width:25, 
	filterUI:'t', 
	control:new Rico.TableColumn.HighlightCell(CustIdCol,CustId,'black','#FBC880'),
	ClassName:'centred'
}, // B
{
	width:25, 
	filterUI:'t', 
	control:new Rico.TableColumn.HighlightCell(CustIdCol,CustId,'black','#FBC880'),
	ClassName:'centred'
}, // L
{
	type:'date', 
	dateFmt:'dd/mm/yyyy', 
	width:75, control:new Rico.TableColumn.HighlightCell( CustIdCol,CustId,'black','#FBC880' )
}, // ultimo int.
{
	type:'date', 
	dateFmt:'dd/mm/yyyy', 
	width:75, 
	control:new Rico.TableColumn.HighlightCell( CustIdCol,CustId,'black','#FBC880' )
}, // data stipula

] };

// Creo un'istanza della LiveGrid
var grid = new Rico.LiveGrid('dataTable', buffer, grid_options);
});

Il codice completo è disponibile visualizzando il sorgente della pagina, dopo una learning curve un pochino ripida vi troverete a lavorare in modo davvero semplice con questo ottimo prodotto.

Happy coding

# Aggiunta di Gabo per permettere di inserire le immagini nel corpo del messaggio
define("EMBEDUPLOADIMAGES",1);

Il problema è che non mi funzionava. Non c'era verso. Allora, armato di santa pazienza, ho messo mano al codice ed ho cercato di capire il motivo. Il problema sta nel fatto che uploadando le immagini, mediante l'FCKEditor, non si possono usare sottodirectory a quella specificata mediante

# If you want to upload images to the FCKeditor, you need to specify the location
# of the directory where the images go. This needs to be writable by the webserver,
# and it needs to be in your public document (website) area
# the directory is relative to the root of PHPlist as set above
# This is a potential security risk, so read README.security for more information
define("FCKIMAGES_DIR","uploadimages");

Dato che io amo le sottodirectory, ma soprattutto perchè gli utenti non avrebbero mai capito il motivo di non poter usare le suddette, ho messo mano al codice ed ho modificato le due funzioni preposte all'arduo compito: filesystem_image_exists e get_filesystem_image, entrambe presenti nel file admin/class.phplistmailer.php

Come prima cosa, però, ho aggiunto anche questa riga al file di configurazione, in modo da poter includere le immagini anche quando si spedisce tramite cronjob e PHP-cli:

//ADDED BY GABO
$phplistRoot = '/home/mysite/public_html';
//END ADDED BY GABO

Ecco le funzioni modificate:

## addition for filesystem images - MODIFYED BY GABO
    function filesystem_image_exists($filename) {
      ##  find the image referenced and see if it's on the server

      $elements = parse_url($filename);
      $localfile = basename($elements['path']);

      // search for subdirectory
      $basePath = $GLOBALS['phplistRoot'].$GLOBALS['pageroot'].'/'.FCKIMAGES_DIR;
      $dir = substr($elements['path'],
                    strpos($elements['path'],FCKIMAGES_DIR)+strlen(FCKIMAGES_DIR),
                    strlen($elements['path']) -
                       strpos($elements['path'],FCKIMAGES_DIR) -
                       strlen(FCKIMAGES_DIR)-strlen($localfile));

      return is_file($basePath.$dir.$localfile);
    }

    function get_filesystem_image($filename) {
      ## get the image contents
      $elements = parse_url($filename);
      $localfile = basename($elements['path']);

      $basePath = $GLOBALS['phplistRoot'].$GLOBALS['pageroot'].'/'.FCKIMAGES_DIR;
      $dir = substr($elements['path'],
                    strpos($elements['path'],FCKIMAGES_DIR)+strlen(FCKIMAGES_DIR),
                    strlen($elements['path']) -
                       strpos($elements['path'],FCKIMAGES_DIR) -
                       strlen(FCKIMAGES_DIR)-strlen($localfile));

      if (is_file($basePath.$dir.$localfile)) {
        return base64_encode( file_get_contents($basePath.$dir.$localfile) );
      }
      return 0;
    }
    ## end addition - MODIFYED BY GABO

Et voilà, le immagini sono servite. Che poi mandare 6000 email che pesano 500kb sia decisamente peggio di mandarne 6000 che pesano 20Kb è un altro discorso, ma con il management non si discute

Ho scritto GDate (GaboDate), una classe PHP5 per la gestione delle date in italiano facilmente estendibile ad altre lingue. Il concetto è semplice: memorizzo la data in un oggetto, e poi la manipolo/rappresento nei vari modi e formati che mi è capitato di dover gestire.

Oltre a gestire date Mysql, XML, Unix Timestamp ed altri, fornisce utilità come settarsi all'ultimo giorno lavorativo del mese in corso, calcolare la distanza tra due date, settarsi a giorni particolari della settimana o del mese ed altre manipolazioni classiche realtive alle date.

Un esempio è forse la cosa più utile in questo caso.

<?php
require_once 'GDate.php';

$d = new GDate();
$d1 = new GDate();
$d1->setDateFromXmlDatetime('19810303T06:30:05');

echo "\nNOW IS: \n";
echo "\nLong date:\t\t" . $d->getLong(true);
echo "\nShort date:\t\t" . $d->getShort();
echo "\nMysql TimeStamp:\t" . $d->getMysqlTimeStamp(true);
echo "\nXML DateTime:\t\t" . $d->getXmlDatetime(true);
echo "\nUnix TimeStamp:\t\t" . $d->getUnixTimeStamp(true);
echo "\nIntegerdate:\t\t" . $d->getIntegerDate(true);

echo "\n";
echo "\nCOMPARING DATE: \n";
echo "\nLong date:\t\t" . $d1->getLong(true);
echo "\nShort date:\t\t" . $d1->getShort();
echo "\nMysql TimeStamp:\t" . $d1->getMysqlTimeStamp(true);
echo "\nXML DateTime:\t\t" . $d1->getXmlDatetime(true);
echo "\nUnix TimeStamp:\t\t" . $d1->getUnixTimeStamp(true);
echo "\nIntegerdate:\t\t" . $d1->getIntegerDate(true);

/* DIFFERENZA DATE */
echo "\n\n";
echo $d->getShort() ." - " .$d1->getShort();
echo " => " . $d1->compareDate($d);
echo " giorni\n";

/* ULTIMO GIORNO LAVORATIVO */
echo "\n";
$d->setLastWorkDayOfMonth();
echo "L'ultimo giorno lavorativo di " . $d->getMonthString() .
		" " . $d->getYear() . " è " . $d->getdayOfWeekString() .
		" " . $d->getDay() . "\n";

$d1->setLastWorkDayOfMonth();
echo "L'ultimo giorno lavorativo di " . $d1->getMonthString() .
		" " . $d1->getYear() . " è " . $d1->getdayOfWeekString() .
		" " . $d1->getDay() . "\n";

$d1->setDateFromShort('2/2/1992');
$d1->setLastWorkDayOfMonth();
echo "L'ultimo giorno lavorativo di " . $d1->getMonthString() .
		" " . $d1->getYear() . " è " . $d1->getdayOfWeekString() .
		" " . $d1->getDay() . "\n";

/* CHECK LAST WORKING DAY */
echo "\n";
$d = new GDate();
$d1 = new GDate();

$d1->setLastWorkDayOfMonth();

$d->setStartDay();
$d1->setStartDay();

echo "Oggi:\t\t\t" . $d->getLong(true);
echo "\n";
echo "Ultimo lavorativo:\t" . $d1->getLong(true);
echo "\n";

/* COMPARE DATE */
if ($d == $d1)
	echo "Oggi è l'ultimo giorno lavorativo del mese\n";
else
	echo "Oggi NON è l'ultimo giorno lavorativo del mese\n";

?>

Lanciando il file di esempio scaricabile insieme alla classe, si ottiene il seguente output:

g4b0@slack:~/sys/working/gdate$ php testGDate.php

NOW IS:

Long date:              23/03/2009-20:30:05
Short date:             23/3/2009
Mysql TimeStamp:        2009-03-23 20:30:05
XML DateTime:           20090323T20:30:05
Unix TimeStamp:         1237836605
Integerdate:            20090323

COMPARING DATE:

Long date:              03/03/1981-06:30:05
Short date:             3/3/1981
Mysql TimeStamp:        1981-03-03 06:30:05
XML DateTime:           19810303T06:30:05
Unix TimeStamp:         352445405
Integerdate:            19810303

23/3/2009 - 3/3/1981 => 10247 giorni

L'ultimo giorno lavorativo di Marzo 2009 è Martedì 31
L'ultimo giorno lavorativo di Marzo 1981 è Martedì 31
L'ultimo giorno lavorativo di Febbraio 1992 è Venerdì 28

Oggi:                   24/03/2009-00:00:00
Ultimo lavorativo:      31/03/2009-00:00:00

Io la trovo molto comoda, e la uso in svariati progetti. Dopo averci preso un po' la mano semplifica parecchio la vita, e velocizza lo sviluppo software. Ci sarebbero da aggiungere funzionalità varie, come la gestione dei centesimi di secondo, dei millesimi e dei microsecondi. Si potrebbero aggiungere lingue varie. Si potrebbero aggiungere nuove funzionalità.

Scarica GDate.

Questo software è rilasciato sotto licenza GPL, reperibile presso http://www.gnu.org/copyleft/gpl.html