In questa mini-guida di tre parti vedremo come utilizzare GeSHi (Generic Syntax Highlighter), un software completamente scritto in PHP da Nigel McNie.
GeSHi è un prodotto straordinario che permette di "colorare" una stringa, o meglio ancora un file di testo, secondo le parole chiave che vogliamo e gli stili CSS desiderati: è perfetto per creare il cosiddetto Syntax Highlight.

Potete vedere subito un esempio in tutte le demo di moo.rd, dove utilizzo GeSHi per colorare il codice sorgente.

Download di GeSHi
Per scaricare GeSHi, (ricordo che è rilasciato sotto licenza GNU GPL) recatevi alla pagina principale del sito e cliccate nella sezione download: scaricate l’ultima release stabile da sourceforge.
Ora non vi resta che scompattarla nella vostra directory e il gioco è fatto. Avete una cartella di nome geshi che contiene il file geshi.php e un’altra sottocartella chiamata anch’essa geshi. Il primo è il file principale che fa lavorare il tutto, mentre la seconda contiene tutti i linguaggi attualmente supportati da GeSHi.

Il costruttore GeSHi
Ma dedichiamoci subito alla pratica. Utilizziamo il costruttore GeSHi ed il suo metodo parse_code per colorare una stringa contenente codice PHP:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

  // includiamo geshi
  include_once('geshi.php');
 
  // creiamo un stringa che contiene codice da colorare
  $somephp = 'for($i = 0; $i<20; $i++) {
    if($items[$i] == "the_item") echo "The item!";
    else echo "Not found item in $i";
  }';
 
  // creiamo un'istanza dell'oggetto GeSHi, scegliamo come linguaggio 'php'
  $code = new GeSHi($somephp, 'php');
 
  // stampiamo il codice
  $code->parse_code();

Una volta che invochiamo il metodo parse_code, il codice verrà stampato seguendo gli stili delle keyword del file php.php che rappresenta la struttura del linguaggio php.

Quelle che ho riportato sopra sono le funzionalità di base che permettono a GeSHi di svolgere il suo compito.
Nella seconda parte della guida vedremo come colorare la sintassi di un file .php e inserirla nel contesto di una pagina.