In genere si sente spesso parlare di LAMP (Linux, Apache, MySQL e PHP), con riferimento alla famosa e diffusa piattaforma open per lo sviluppo di applicazioni web based (per informazioni complete e dettagliate sull’impostazione di un sistema LAMP vi invito a leggere la guida LAMP: Linux, Apache, MySQL e PHP). In questa guida, invece, vorrei proporvi una variante di tale piattaforma in cui il DBMS MySQL viene sostituito da Oracle Server 10g Express Edition, una versione free del più blasonato DBMS commerciale, disponibile anche per il pinguino, seppur con alcune limitazioni di cui parlerò in seguito. In questa guida si focalizzerà l’attenzione sull’installazione e la configurazione di Apache, PHP ed Oracle Database Server 10g XE e sulle modalità di interazione tra questi software, in modo tale da disporre di una piattaforma completa per lo sviluppo di applicazione web-based. Tutti i passaggi indicati in questa guida sono stati eseguiti su un sistema Debian GNU/Linux 4.0 R3 Netinst. Buona lettura!

Oracle Database Server 10g XE

Installazione

Sul sito di Oracle Corp., previa procedura di registrazione, sono disponibili i pacchetti per Debian, Ubuntu, Suse Novell, Red Hat/Fedora e Mandriva di Oracle Database Server 10g XE con una serie di limitazioni rispetto alla versione a pagamento:

• se Oracle Database Server 10g XE viene installato su un computer con più di una CPU (incluse anche le CPU dual core), esso utilizzerà esclusivamente le risorse di una sola CPU
• su un singolo computer può essere effettuata l’installazione di una sola copia di Oracle Database Server 10g XE; in aggiunta, gli utenti possono far girare una sola istanza del database Oracle su ciascun computer. Quest’ultima limitazione può comunque essere aggirata in quanto, anche sulla stessa installazione di Oracle Database Server 10g XE possono convivere più schemi, ciascuno dei quali contenente le proprie tabelle. Di fatto, è come se sulla stessa macchina fossero presenti più database simultaneamente
• la quantità massima di dati contenuta in un database Oracle Database Server 10g XE non può superare i 4 gigabytes di spazio disco, tuttavia se i dati degli utenti dovessero superare tale quota, il sistema invierebbe l’errore ORA-12592
• la quantità massima di memoria RAM che Oracle Database Server 10g XE utilizza non può eccedere un gigabyte, anche se ne è disponibile una quantità maggiore. La quantità di memoria totale utilizzata dal server Oracle viene ricavata come somma della System Global Area (SGA) e della Program Global Area (PGA) aggregata
• il protocollo HTTPS (Secure HTTP) non è supportato nativamente dal listener HTTP presente in Oracle 10g XE, quindi è necessario far uso di un web server, come Apache, che supporti tale protocollo

Limitazioni a parte, Oracle Database Server 10g XE resta, a mio avviso, un buon prodotto utilizzato, tra l’altro, anche dalla recente soluzione di virtualizzazione proposta dalla stessa Oracle.Una volta effettuato il download del pacchetto, l’installazione di Oracle Database Server 10g XE si riduce al seguente comando:

L’installazione di Oracle Database Server 10g XE richiede la presenza di alcuni pacchetti che vanno installati a parte, se non presenti, con il seguente comando:

Configurazione

Al termine dell’installazione, bisogna configurare opportunamente Oracle Database Server 10g XE lanciando lo script oracle-xe con l’opzione “configure”. Tale script si trova nella directory /etc/init.d/ e va eseguito sempre con i privilegi di root. Lo script in questione richiede interattivamente all’utente di fornire una serie di informazioni per eseguire Oracle Database Server 10g XE tra cui:

• il numero di porta (per default la 8080) tramite cui è possibile raggiungere l’interfaccia web (una sorta di Enterprise Manager, ma depotenziato) per la configurazione di Oracle all’url http://127.0.0.1:8080/apex
• il numero di porta (per default la 1521) su cui si mette in attesa il listener di Oracle Server, ossia un demone preposto a ricevere e servire le richieste di connessione al server Oracle, appunto. Se si dispone di un firewall potrebbe essere necessario configurarlo in modo tale da lasciare passare il traffico sulla porta 1521 o, diversamente, è possibile indicare allo script di configurazione di Oracle Server 10g XE di mettere il listener in ascolto su una porta differente
• quando far partire l’istanza di Oracle Database Server 10g XE; si può decidere se schedulare la partenza di Oracle al boot del sistema, oppure se eseguirla manualmente di volta in volta (io ho optato per la prima opzione, per comodità, ma è pur sempre possibile realizzare uno script bash per gestire l’avvio e l’arresto di Oracle in modo manuale).

Impostazione delle variabili d’ambiente di Oracle Server 10g XE

Al termine dell’installazione di Oracle Server 10g XE è necessario settare le variabili d’ambiente indispensabili per il funzionamento di tool come, ad esempio, SQL*Plus, utilizzato per le classiche operazioni di gestione del database come inserimenti, modifiche, cancellazioni, consultazioni di dati e così via. Per procedere in questo senso, è sufficiente lanciare uno script di configurazione delle variabili d’ambiente di Oracle Database Server 10g XE, disponibile in due distinte versioni dipendentemente dalla shell in uso. I due script si trovano nella directory /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/ e sono:

• oracle_env.sh (valido anche per le shell Bourne e Korn)
• oracle_env.csh (valido anche per le shell C e tsh)

Lo script oracle_env.sh, si occupa di impostare una serie di variabili d’ambiente tra cui:

• ORACLE_HOME: il path dell’installazione di Oracle 10g XE
• ORACLE_SID: il nome del database (XE)
• NLS_LANG: il character set, rilevato in base alle impostazioni in uso sul sistema operativo, che verrà utilizzato per la memorizzazione dei dati nel database
• PATH: il percorso che porta alla directory contenente gli eseguibili di Oracle Server 10g XE
• LD_LIBRARY_PATH: il percorso della directory contenente le librerie principali per Oracle Server 10g XE

ATTENZIONE: Va ricordato che riavviando il computer, i settaggi impostati con lo script oracle_env.sh vengono persi, perciò è buona norma inserire la stringa:

/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.sh

all’interno del file .bash_profile; inoltre, per poter mantenere le stesse impostazioni all’apertura di ogni nuova shell durante la sessione corrente, è conveniente aggiungere l’istruzione precedente anche all’interno del file .bashrc (sia per il proprio utente, sia per l’utente root).

Bene, l’installazione e la configurazione di Oracle Database Server 10g XE sono complete! Per assicurarsi che Oracle sia partito correttamente, è possibile lanciare il comando seguente di cui riporto anche un esempio di output:

Come si può notare dall’output dello script, il listener Oracle ha un’istanza attiva sulla porta 1521, come stabilito in fase di configurazione.

Apache e PHP

Il secondo passo consiste nell’installazione e configurazione di Apache e PHP con supporto al DBMS Oracle. È possibile installare il web server Apache e il linguaggio di scripting server side PHP tramite i pacchetti forniti dalla propria distribuzione, oppure ricompilare il tutto da sorgenti. La possibilità di compilare questi due software da sorgenti consente di scegliere autonomamente le opzioni di compilazione più adatte alle proprie necessità (ad esempio, nel caso di PHP, si può decidere di abilitare o meno il supporto per Oracle, oppure per MySQL, per LDAP, per la libreria di compressione zlib e così via).

Installazione e configurazione di Apache

I comandi seguenti consentono il download, la scompattazione e la compilazione del web server Apache sulla propria Linux box (ovviamente il numero di versione dei software indicati fa riferimento al periodo in cui questa guida è stata scritta):

il parametro –prefix passato al comando configure richiede il path in cui verrà installato il web server Apache. Dalla documentazione del web server si legge che il percorso di default da indicare è /usr/local/apache2/. Le impostazioni del server web Apache risiedono nel file httpd.conf (che si trova nella directory /usr/local/apache2/conf/ nel caso sia stata effettuata l’installazione da sorgenti); tale file può essere modificato, disponendo dei privilegi di root, con un qualsiasi editor di testi. Le direttive da impostare nel file httpd.conf per ottenere un funzionamento minimale del web server Apache sono:

• Listen: consente ad Apache di porsi in ascolto su un determinato indirizzo IP e/o porta
• ServerName: il nome del server, o l’indirizzo IP e il numero di porta che il server utilizza per identificare se stesso
• DocumentRoot: la directory contenente le pagine web delle proprie applicazioni. È anche possibile indicare un alias, o un link simbolico per puntare ad altre locazioni del filesystem.

Una volta salvate le modifiche apportate al file httpd.conf, si può far partire Apache con il comando:

quindi, puntando il proprio browser web all’indirizzo specificato anche con la direttiva ServerName precedentemente citata, si dovrebbe poter visualizzare la pagina di benvenuto di Apache.

Installazione e configurazione di PHP

PHP è un linguaggio di scripting server side che consente di integrare il codice HTML al fine di realizzare pagine web dinamiche, ossia il cui contenuto varia in base alle azioni intraprese dagli utenti. Poichè lo scopo di questa guida è quello di realizzare un server web in grado di interagire con una base di dati Oracle, è necessario che PHP disponga del supporto per tale DBMS. Ancora una volta, per poter abilitare esclusivamente le funzionalità richieste di PHP, si è optato per la compilazione dei sorgenti di questo software.

Come si può notare dal codice precedente, il comando configure è seguito da una serie di opzioni da attivare nella successiva fase di compilazione:

• –prefix: permette di indicare in quale directory installare PHP
• –with-apxs2: indica che si vuole compilare PHP come un moulo condiviso di Apache
• –with-config-file-path: indica il percorso dei file di configurazione di Apache
• –with-oci8: abilita il supporto per il DBMS Oracle di cui è necessario indicare il path dell’installazione.
• –enable-sigchild: abilita il gestore dei segnali proprio di PHP
• –without-mysql: disabilita il supporto al DBMS MySQL, non necessario, visto che si vuole utilizzare Oracle Database Server

Il parametro –with-oci8 richiede di specificare il percorso, sul filesystem locale, dell’installazione di Oracle Database Server, se tale installazione è stata effettuata sullo stesso server fisico di Apache e PHP. Se, invece, web server e db server risiedono su due macchine distinte, come spesso accade, allora sulla macchina che funge da server web deve essere installato l’Oracle Instant Client. I passi da seguire per installare tale software sono molto semplici:

• Scaricare, dal link sopra indicato, i package Basic e SDK
• Scompattare i file scaricati in una directory a piacere (ad es. /usr/local/src/)

• Creare un link simbolico alle librerie libclntsh.so.10.1 e libocci.so.10.1

La scompattazione dei due file precedenti crea una directory, contenente i files dell’Oracle Instant Client. Nel mio caso, tale directory si chiama instantclient_11/, ma il nome potrebbe differire, quindi ATTENZIONE. Il comando configure precedentemente lanciato per PHP va quindi modificato indicando, con la direttiva –with-oci8, il percorso in cui è stato installato l’Oracle Instant Client:

Per concludere l’installazione di PHP è sufficiente inserire il percorso /usr/local/php/lib/php all’interno del file php.ini, il quale deve essere successivamente copiato dalla directory dei sorgenti di PHP nella directory /usr/local/lib e in /usr/local/apache2/conf/ (se Apache è stato compilato da sorgenti). Se la compilazione di PHP è andata a buon fine, nel file httpd.conf sarà stata aggiunta in automatico la seguente stringa:

Questa riga indica che Apache ha caricato il modulo per il funzionamento delle pagine web contenenti codice PHP (nella versione 5), tuttavia, per far sì che i browser web interpretino correttamente il codice PHP, è necessario modificare nuovamente il file httpd.conf di configurazione del web server Apache aggiungendo le due righe seguenti all’interno della sezione

Di default, PHP offre il supporto per il DBMS MySQL, mentre nel caso di questa guida esso è stato sostituito con il supporto ad Oracle. Questo richiede di modificare alcune direttive presenti nel file php.ini per rendere PHP aderente alla sintassi utilizzata da Oracle. In particolare, MySQL ed Oracle considerano il carattere apice(’) come delimitatore di stringhe, o di date. Se si deve memorizzare una stringa all’interno di una tabella e questa stringa contiene una o più occorrenze del carattere apice, entrambi i DBMS ritorneranno un errore a meno di non eseguire un escape di tale carattere jolly. Questa operazione si rende, ovviamente, necessaria anche per i dati che gli utenti inseriscono, ad esempio, tramite i form di un sito e che poi andranno inseriti all’interno di un database, ma con una importante differenza: MySQL effettua l’escape del carattere apice tramite il carattere backslash (\), mentre Oracle utilizza un ulteriore apice. PHP consente l’escape del carattere apice, se presente nei dati passati tramite GET, POST o persino cookie, per mezzo delle seguenti direttive contenute nel php.ini:

Impostando magic_quotes_gpc e magic_quotes_sybase a “On” si ottiene l’escape del carattere apice alla maniera di Oracle, mentre se magic_quotes_sybase viene impostato a “Off” si ottiene l’escape alla maniera di MySQL.

PEAR

PHP mette a disposizione delle funzioni che consentono la comunicazione con una base di dati, ma esse dipendono strettamente dal tipo di DBMS con cui le pagine web scritte in PHP devono interagire. Per questo motivo è necessario servirsi del framework PEAR (PHP Extension and Application Repository), ossia un repository di package con cui è possibile estendere le funzionalità del linguaggio PHP. In particolare, il package MDB2, fornisce un’API che si frappone tra PHP e il DBMS sottostante, permettendo di slegare un’applicazione web dal DBMS in uso. Il vantaggio è che se dovesse rendersi necessaria una migrazione del database verso un DBMS diverso da quello attuale non vi sarà l’obbligo di modificare tutte le funzioni che PHP utilizza per interagire con la base di dati, ma solo il protocollo di comunicazione utilizzato (oci8 per Oracle, oppure mysql per MySQL, ecc).

ATTENZIONE: Attualmente, il package MDB2 è da considerarsi come standard per la connessione, mediante il framework PEAR, di un’applicazione web-based scritta in PHP con un DBMS sottostante. Tale package è andato a sostituire l’ormai obsoleto package DB che si sconsiglia di utilizzare.

Configurazione di PEAR

Conclusa la configurazione di PHP, è necessario passare a quella del framework PEAR aggiungendo i pacchetti necessari per la comunicazione con una base di dati gestita tramite Oracle. Le API messe a disposizione da PEAR potranno poi essere sfruttate nelle proprie pagine PHP per slegarsi dal DBMS in uso. L’aggiunta di un pacchetto in PEAR si esegue con il comando:

tramite cui si può installare un package prelevandolo direttamente dai repository di PEAR. Di seguito vengono indicati i comandi necessari per installare sia il package DB, sia MDB2: Per il package DB (obsoleto):

Per il nuovo package MDB2, invece:

Nota Bene: è necessario ricordarsi di includere il file MDB2.php, oppure DB.php, a seconda del pacchetto installato, all’interno delle proprie pagine PHP per poter utilizzare le funzioni messe a disposizione da questo package per l’interazione con una base di dati Oracle. L’istruzione da utilizzare all’inizio del codice PHP è la seguente:

Conclusioni

Bene, a questo punto disponiamo di un web server con Apache e PHP configurati per comunicare con una base di dati Oracle sottostante e il tutto in salsa open source!