PhpBB 2.0.10

Introduzione

Una tra le migliori soluzioni di Forum di discussione open-source in PHP è senza dubbio phpBB, php bulletin board, sviluppato dal phpBB Group. Tra i pregi del software vi sono la semplicità di installazione, la scalabilità, il supporto multilingue, il supporto per vari database server, le notevoli possibilità di personalizzazione, l'interfaccia user-frendly e, non ultimo, il rilascio gratuito sotto licenza GPL.

Oltre alle tipiche funzionalità di post e reply dei messaggi, gestione di thread di discussione, ricerca testuale all'interno dei messaggi, il software prevede l'utilizzo di stili personalizzati, la pubblicazione di sondaggi, la gestione di gruppi di utenti, l'invio di mass-mailing agli iscritti, lo scambio di messaggi privati e molto altro ancora.

Il passaggio di phpBB dalla versione 1.x, di cui abbiamo fornito a suo tempo un PhpBB 1.4.0, alla 2.x ha comportato una radicale riscrittura del codice e reingegnerizzazione del prodotto che è divenuto notevolmente più professionale, sicuro e stabile.

Al momento della stesura di questo tutorial è disponibile la versione 2.0.10, anche se il phpBB group sta lavorando alla versione 2.2, senza però anticipare una possibile data di rilascio. In realtà esiste anche una versione di sviluppo 2.1.x, da non usarsi in produzione, che, appena divenuta stabile, verrà rilasciata come 2.2. Secondo tradizione sarà sicuramente sviluppato un tool di upgrade automatico dalla precedente versione.

I requisiti minimi per l'installazione sono la disponibilità di un web server su cui giri PHP, almeno nella versione 3.0.9. Il team di sviluppo dichiara esplicitamente che il software non è stato scritto per funzionare con PHP 5. Viene comunque segnalato che alcuni membri della community hanno installato con successo phpBB configurando opportunamente PHP 5. Ulteriore requisito la disponibilità di un database server tra MySQL (minimo 3.22), PostgreSQL (minimo 7.0.3), Microsoft SQL Server (7 o 2000) o Microsoft Access (2000 o XP). La scelta di quest'ultimo è sconsigliata se si prevedono più di due o tre utenti in linea contemporaneamente.

Download gratuito dei file

Le indicazioni di seguito riportate fanno riferimento all'installazione di phpBB 2.0.10 su un web server Linux RH 7.3 con Apache 1.3.27, PHP 4.2.3 e MySQL 3.23.56, ma possono facilmente adattarsi a sistemi con altre caratteristiche. Per l'installazione di Linux, Apache, PHP e MySQL (LAMP), fate riferimento ad un LAMP: Installare Apache, PHP e MySQL in ambiente Linux.

Per velocizzare la procedura abbiamo raccolto in un unico file compresso i tre file che ci serviranno per l'installazione: phpBB-2.0.10.zip (il cuore dell'applicazione), lang_italian.zip (la localizzazione in italiano) e subSilver_italian.zip (le immagini in italiano). Per chi volesse scaricarli dal sito ufficiale basta puntare il browser verso la sezione Download di phpbb.com.

L'archivio compresso contenente le immagini (subSilver_italian.zip) fa riferimento allo stile grafico denominato subSilver che è lo stile di default adottato dall'applicazione. A questo proposito, in fondo alla pagina, nella sezione subSilver SDK, sono disponibili per il download anche i files grafici originali utilizzati per produrre lo stile omonimo (compatibili con Photoshop, Gimp, Paint Shop Pro, etc.). Si faccia attenzione: subSilver SDK non è rilasciato sotto GPL, consultate quindi attentamente i limiti imposti dalla licenza.

Scompattiamo il nostro pacchetto e poi scompattiamo phpBB-2.0.10.zip sotto la document root del nostro web server, la directory in cui siamo soliti memorizzare le nostre pagine per intenderci. Verrà così creata, a partire dalla directory phpBB2, tutta la struttura di directory e sottodirectory del forum. È possibile modificare il nome di default phpBB2 con uno di nostro gradimento, nelle righe successive, però, ci riferiremo con tale nome alla directory base dell'installazione. Se decidete di rinominarla dovrete avere l'accortezza di modificare di conseguenza le indicazioni fornite nel tutorial. A questo punto supponendo che il nostro sito sia raggiungibile alla url http://www.miosito.it digitando http://www.miosito.it/phpBB2 raggiungeremo le pagine relative al forum: abbiate pazienza è ancora troppo presto per farlo.

Scompattiamo il file lang_italian.zip in phpBB2/language, al termine dell'operazione dovrà comparire la directory lang_italian accanto alla già presente lang_english. Ripetiamo l'operazione con subSilver_italian.zip a partire da phpBB2/templates, se tutto si è svolto correttamente dovremo vedere la directory lang_italian in phpBB2/templates/subSilver/images accanto alla solita lang_english presente di default.

Se non abbiamo la disponibilità di una shell sul server, ma solo un accesso via ftp, l'operazione risulterà un po' più laboriosa. Dovremo innanzitutto scompattare gli archivi compressi in locale secondo le indicazioni fornite in precedenza e poi, nel trasferire i files, ricreare sul server l'identica struttura delle directory.

Nella remota eventualità che il vostro server non utilizzi .php come estensione per l'esecuzione di script PHP, ma ad esempio .php3 o .phtml sarà necessario rinominare tutti i files assegnando l'estensione desiderata. Poi bisognerà modificare il file extension.inc, che si trova in phpBB2, assegnando alla variabile $phpEx l'estensione corretta.

Creazione del database

Il passo successivo sarà la creazione del database destinato a contenere le tabelle del forum e dell'utente che potrà operare su tale database, sempre che non decidiate di utilizzare un database già esistente. Facciamo partire il client a linea di comando di MySQL, loggandoci sul database server:

user password

Al posto di 'user' e 'password' dovremmo naturalmente inserire la nostra username e password di login. Dal prompt di MySQL creiamo il database phpBB_2:

mysql> CREATE DATABASE phpBB_2;

Controlliamo che il database sia stato creato e compaia nell'elenco digitando:

mysql> SHOW DATABASES;

Creiamo l'utente phpbb_user con i privilegi necessari identificato dalla password phpbb_password. Ovviamente in un'installazione reale non utilizzate questi nome utente e password puramente esemplificativi!!

mysql> GRANT select,update,insert,delete,create ON phpBB_2.* TO phpbb_user@localhost IDENTIFIED BY 'phpbb_password';

Si è presupposto che il database server si trovi sul medesimo server che ospita le pagine del forum, concedendo i privilegi di selezione, aggiornamento, inserimento, cancellazione dei record nonché creazione di tabelle all'utente phpBB_user che accede dal localhost, phpbb_user@localhost. Se così non fosse dovrete indicare l'host corretto da cui si collegherà l'utente.

Le medesime operazioni si possono naturalmente eseguire con strumenti di amministrazione visuali quali phpMyAdmin, MySQL-Front o altri. Se non avete privilegi sufficienti per tali operazioni, sarà necessario contattare chi amministra il server, tipicamente il supporto tecnico del vostro hosting provider.

L'ultima operazione, prima di iniziare con l'installazione vera e propria, è la modifica dei permessi sul file config.php

Installazione del forum

Eccoci pronti a partire: digitiamo nel nostro browser l'indirizzo http://www.miosito.it/phpBB2/install/install.php e, se tutto funziona correttamente, ci risponderà la pagina di benvenuto della procedura d'installazione. A questo punto dobbiamo inserire nel modulo innanzi a noi alcuni dati necessari alla configurazione del forum. Alcuni risultano già preimpostati nei campi di input ed andranno modificati solo se non corrispondenti ai nostri requisiti.

Sono previste tre sezioni: Configurazione Base, Configurazione Database, Configurazione Amministrazione. Analizziamole una per una considerando le caratteristiche del server assunte all'inizio del tutorial.

• Configurazione Base
  Selezioniamo come Lingua di default Italian Tipo di Database MySQL 3.x Scegli un metodo di installazione Installa
• Configurazione Database
  
  Come Database Server/Hostname localhost Nome del tuo Database phpBB_2 Username per il database phpbb_user Password per il database phpbb_password Prefisso per le tabelle nel database phpbb_
• Configurazione Amministrazione
  
  Come Indirizzo Email Amministratore info@miodominio.it Nome Dominio www.miodominio.it Porta del Server 80 Percorso Script /phpBB2/ Username Amministratore amministratore Password Amministratore Password Amministratore [Conferma]

Controlliamo con attenzione i dati inseriti e proseguiamo nella procedura cliccando sul pulsante Inizia l'Installazione.

Lo script di installazione procederà alla creazione e riempimento delle tabelle e cercherà di scrivere nel file config.php. Se abbiamo provveduto correttamente a cambiare i permessi non ci saranno problemi, in caso contrario ci verrà proposto di scaricare il file o di caricarlo automaticamente via ftp. Se si decide di downlodarlo si dovrà poi procedere all'upload sovrascrivendo quello vuoto presente sul server.

Se tutto ha funzionato a dovere dovremmo vedere il messaggio di conferma della corretta installazione del nostro forum. Prima di selezionare il pulsante Termina l'Installazione ripristiniamo i permessi originali sul file config.php con un chmod 644 e poi procediamo.

La pagina finale chiede di eliminare le directory install/ e contrib/. A causa di un piccolo ed innocuo bug il messaggio compare in lingua inglese anzichè in italiano. Seguiamo tale indicazione per prevenire potenziali eliminazioni o alterazioni dei files anche perché, diversamente, lo script non ci permetterà di procedere nella successiva operazione di login.

A questo punto, per iniziare a configurare il nostro forum, clicchiamo sul link Log in in alto a destra ed inseriamo il nome utente e la password scelti per l'account amministrativo creato in precedenza.

Nelle pagine successive vedremo da vicino la configurazione del Forum, spiegando dettagliatamente tutte le opzioni di amministrazione.

Con il PhpBB 2.0.10 eravamo arrivati al termine del processo di installazione ed avevamo effettuato il primo login utilizzando le credenziali dell'account amministrativo. Riprendiamo da quel punto e vediamo come configurare il nostro forum.

Configurazione generale del forum

Dopo il login verremo reindirizzati alla pagina principale dell'applicazione, ovvero l'indice dei forum, dove è visibile un forum di test automaticamente creato durante il processo d'installazione. In fondo alla pagina selezioniamo il link Administration Panel, visibile solamente perché loggati come amministratore, ed entriamo nel pannello di amministrazione del forum.

Il menu di sinistra riporta diverse opzioni di configurazione raggruppate per macro aree, tra queste puntiamo l'attenzione su Amministrazione Generale e selezioniamo la voce Configurazione. Così facendo ci troveremo di fronte al form di Configurazione Generale che, come si intuisce dal titolo, permette di personalizzare gli aspetti generali del forum. Il modulo risulta in gran parte precompilato ed alcuni dati li abbiamo già inseriti in fase di installazione. Vediamoli di seguito in dettaglio.

• Nome Dominio Porta del Server Percorso script
• Nome del Sito
• Descrizione del Sito
• Disabilita il Forum
• Abilita l'attivazione degli account Nessuno Utente Amministratore
• Messaggistica email attraverso il forum
• Intervallo del Flood
• Argomenti Per Pagina
• Messaggi Per Pagina
• Numero di Messaggi per essere Popolare
• Stile di Default
• Annulla il tema dell'utente
• Linguaggio di Default
• Formato Data
• Abilita la Compressione Gzip
• Abilita il Pruning del Forum
• Dominio Cookie
• Nome Cookie
• Cookie sicuri
• Lunghezza Sessione
• Messaggi Privati

• Numero massimo di messaggi per Posta in Arrivo
• Numero massimo di messaggi per Posta Inviata
• Numero massimo di messaggi per Posta Salvata
• Numero massimo di opzioni per sondaggio
• Permetti HTML
• Tags HTML permessi
• Permetti BBCode
• Permetti Smilies
• Percorso Salvataggio Smilies images/smiles
• Permetti Firma
• Lunghezza massima firma
• Permetti cambio Username
• Abilita la Galleria Avatar
• Abilita gli Avatar remoti
• Abilita il caricamento degli Avatar
• Grandezza massima File Avatar
• Dimensioni Massime Avatar
• Percorso Salvataggio Avatar
• Percorso Galleria Avatar
• Numero di Fax per COPPA
• Indirizzo per COPPA
• Indirizzo Email Amministratore
• Firma Email
• Usa un Server SMTP per le email
• Indirizzo Server SMTP
• Username per l'SMTP
• Password per l'SMTP

Dopo aver opportunamente compilato tutti i campi clicchiamo sul pulsante Invia per memorizzare le nostre impostazioni. Abbiamo così concluso anche la fase di configurazione generale dell'applicazione. Selezionando dal menù sinistro la voce Anteprima Forum potremo verificare le modifiche apportate senza abbandonare il pannello di amministrazione.

Conclusioni

Il forum phpBB rappresenta una delle soluzioni più interessanti nell'ambito dei bullettin board in PHP, naturalmente non è l'unica. Il sito ufficiale http://www.phpbb.com fornisce ulteriori informazioni, dettagli e supporto a chiunque decidesse di adottare tale software. Esiste anche una localizzazione italiana del supporto http://www.phpbb.it, per ovvie ragioni molto meno completa, ma pur sempre utile a chi mastica a fatica la lingua inglese. Se siete interessati a seguire lo sviluppo del prodotto l'area development del phpBB Group è raggiungibile alla url http://area51.phpbb.com.

L'aspetto forse più interessante di phpBB è la possibilità di adottarlo per siti amatoriali o quasi, data la semplicità di installazione e configurazione, utilizzandone poi le funzionalità di base. Per converso le features messe a disposizione sono veramente tante e, se sfruttate a pieno, permettono di mettere in linea un forum altamente professionale che non smentisce il motto del logo: "phpBB creating communities". In queste pagine si sono analizzati solo gli aspetti fondamentali della configurazione, quelli più strettamente connessi alla fase di post-installazione, ulteriori dettagli saranno forse oggetto di nuovi tutorial. Come ultimo suggerimento, se decidete di adottare questo software, consultate periodicamente il sito del phpBB Group e prelevate gli aggiornamenti che in alcuni casi possono risolvere importanti problemi di sicurezza.

Configurazione generale del forum

Dopo il login verremo reindirizzati alla pagina principale dell'applicazione, ovvero l'indice dei forum, dove è visibile un forum di test automaticamente creato durante il processo d'installazione. In fondo alla pagina selezioniamo il link Administration Panel, visibile solamente perché loggati come amministratore, ed entriamo nel pannello di amministrazione del forum.

Il menu di sinistra riporta diverse opzioni di configurazione raggruppate per macro aree, tra queste puntiamo l'attenzione su Amministrazione Generale e selezioniamo la voce Configurazione. Così facendo ci troveremo di fronte al form di Configurazione Generale che, come si intuisce dal titolo, permette di personalizzare gli aspetti generali del forum. Il modulo risulta in gran parte precompilato ed alcuni dati li abbiamo già inseriti in fase di installazione. Vediamoli di seguito in dettaglio.

• Nome Dominio Porta del Server Percorso script
• Nome del Sito
• Descrizione del Sito
• Disabilita il Forum
• Abilita l'attivazione degli account Nessuno Utente Amministratore
• Messaggistica email attraverso il forum
• Intervallo del Flood
• Argomenti Per Pagina
• Messaggi Per Pagina
• Numero di Messaggi per essere Popolare
• Stile di Default
• Annulla il tema dell'utente
• Linguaggio di Default
• Formato Data
• Abilita la Compressione Gzip
• Abilita il Pruning del Forum
• Dominio Cookie
• Nome Cookie
• Cookie sicuri
• Lunghezza Sessione
• Messaggi Privati

• Numero massimo di messaggi per Posta in Arrivo
• Numero massimo di messaggi per Posta Inviata
• Numero massimo di messaggi per Posta Salvata
• Numero massimo di opzioni per sondaggio
• Permetti HTML
• Tags HTML permessi
• Permetti BBCode
• Permetti Smilies
• Percorso Salvataggio Smilies images/smiles
• Permetti Firma
• Lunghezza massima firma
• Permetti cambio Username
• Abilita la Galleria Avatar
• Abilita gli Avatar remoti
• Abilita il caricamento degli Avatar
• Grandezza massima File Avatar
• Dimensioni Massime Avatar
• Percorso Salvataggio Avatar
• Percorso Galleria Avatar
• Numero di Fax per COPPA
• Indirizzo per COPPA
• Indirizzo Email Amministratore
• Firma Email
• Usa un Server SMTP per le email
• Indirizzo Server SMTP
• Username per l'SMTP
• Password per l'SMTP

Dopo aver opportunamente compilato tutti i campi clicchiamo sul pulsante Invia per memorizzare le nostre impostazioni. Abbiamo così concluso anche la fase di configurazione generale dell'applicazione. Selezionando dal menu sinistro la voce Anteprima Forum potremo verificare le modifiche apportate senza abbandonare il pannello di amministrazione.

Conclusioni

Il forum phpBB rappresenta una delle soluzioni più interessanti nell'ambito dei bullettin board in PHP, naturalmente non è l'unica. Il sito ufficiale http://www.phpbb.com fornisce ulteriori informazioni, dettagli e supporto a chiunque decidesse di adottare tale software. Esiste anche una localizzazione italiana del supporto http://www.phpbb.it, per ovvie ragioni molto meno completa, ma pur sempre utile a chi mastica a fatica la lingua inglese. Se siete interessati a seguire lo sviluppo del prodotto l'area development del phpBB Group è raggiungibile alla url http://area51.phpbb.com.

L'aspetto forse più interessante di phpBB è la possibilità di adottarlo per siti amatoriali o quasi, data la semplicità di installazione e configurazione, utilizzandone poi le funzionalità di base. Per converso le features messe a disposizione sono veramente tante e, se sfruttate a pieno, permettono di mettere in linea un forum altamente professionale che non smentisce il motto del logo: "phpBB creating communities". In queste pagine si sono analizzati solo gli aspetti fondamentali della configurazione, quelli più strettamente connessi alla fase di post-installazione, ulteriori dettagli saranno forse oggetto di nuovi tutorial. Come ultimo suggerimento, se decidete di adottare questo software, consultate periodicamente il sito del phpBB Group e prelevate gli aggiornamenti che in alcuni casi possono risolvere importanti problemi di sicurezza.