Installazione di phpBB3

Si prega di leggere completamente questo documento prima di procedere con l'installazione, l'aggiornamento o la conversione.

Questo documento vi guiderà attraverso le basi per l'installazione, l'aggiornamento e la conversione.

Una panoramica di base di eseguire phpBB3 si trova nel file README. Leggi entrambe i documenti! Per informazioni più dettagliate sull'uso, l'installazione, l'aggiornamento e la conversione di phpBB3 puoi leggere la documentazione disponibile online.

1. Installazione rapida
2. Requisiti
3. Nuova installazione
4. Aggiornamento da versioni stabili di phpBB 3.0.x
   • Pacchetto completo
   • Solo file modificati
   • Patch file
   • Pacchetto di aggiornamento automatico
   • Pacchetto lingua
5. Conversione da phpBB 2.0.x a phpBB 3.0.x
   • Requisiti prima della conversione
   • Conversione
   • Cose da fare dopo la conversione
   • Problemi comuni di conversione
6. Note importante (riguardanti la sicurezza) post-installazione per tutti i metodi di installazione
   • Invio avatar

7. Disclaimer

1. Installazione rapida
Se hai conoscenza di base di FTP e sei sicuro che il tuo servizio hosting o server potrà eseguire phpBB3 è possibile utilizzare questa procedura per completare rapidamente l'installazione. Per una spiegazione più dettagliata si può saltare questo passaggio e passare al punto 2 qui di seguito.

1. Decomprimi l'archivio phpBB3 in una cartella locale sul tuo PC
2. Carica tutti i file contenuti in questo archivio (mantenendo la struttura della cartella) in una cartella web accessibile sul tuo server o sul tuo spazio hosting
3. Modifica i permessi di scrittura sul config.php in (666 o -rw-rw-rw-)
4. Modifica i permessi di scrittura alle seguenti cartelle in (777 o -rwxrwxrwx): store/, cache/, files/ e images/avatars/upload/
5. Utilizza il tuo browser e digita l'indirizzo ove hai messo phpBB3 aggiungendo install/index.php o andando direttamente su install/, es. http://www.miodominio.it/phpBB3/install/ o http://www.miodominio.it/forum/install/
6. Clicca sul pulsante Installa, segui la procedura e riempi tutte le informazioni richieste
7. Modifica i permessi di scrittura sul config.php (644 o -rw-r--r--)
8. phpBB3 dovrebbe ora essere disponibile, leggere almeno il punto 6 qui di seguito riguardano la sicurezza post-installazione.

Se hai riscontrato problemi o non sai come procedere nei passaggi sopradescritti leggi tutto il documento.

2. Requisiti
phpBB3 ha alcuni requisiti che devono essere soddisfatti prima di essere installato.

• Un server web o web hosting con sestema operativo tra i più importanti con supporto PHP
• Un sistema di database SQL, a scelta tra:
  • MySQL 3.23 o superiore (MySQLi supportato)
  • PostgreSQL 7.3 o superiore
  • SQLite 2.8.2 o superiore
  • Firebird 2.0 o superiore
  • MS SQL server 2000 o superiore (diretto o via ODBC)
  • Oracle
• La presenza di questi moduli opzioninali nel PHP ti permetterà di accedere a caratteristiche aggiuntive
  • Supporto compressione zlib
  • Supporto FTP remoto
  • Supporto XML
  • Supporto Imagemagick
  • Supporto GD

Se il tuo server o spazio hosting non soddisfano i requisiti sopra citati phpBB3 non potrà essere installato.

3. Nuova installazione
L'installazione di phpBB3 varia in base al tuo server e al database. Se si dispone di accesso a shell (via telnet o ssh) è possibile caricare l'intero archivio phpBB3 (in modo binario!) in una cartella sul tuo host e scompattarlo direttamente li.

Se non si dispone di un'accesso a shell o non vuoi usarlo è necessario decomprimere l'archivio phpBB3 in una cartella locale sul tuo PC utilizzando un programma di compressione, es. winzip, rar, zip, ecc. Successivamente è necessario inviare via FTP tutti i file contenuti (assicurandoci di mantenere la struttura corretta dei file e delle cartelle). Non modificare nome a file o cartelle questo causerebbe un malfunzionamento del sistema.

Tutti i file .php, .inc, .sql, .cfg, .html e .txt devono essere caricati in modalità ASCII, mentre tutta la struttura grafica deve essere caricata in modalità binario. Se non conosci queste funzioni fai riferimento alla documentazione del tuo client FTP. Nella maggior parte dei casi questo è gestito automaticamente dal client FTP ma se incontri problemi dovai caricare i file correttamente come qui descritto.

phpBB3 se scaricato da phpbb.com viene fornito in lingua Inglese, se scaricato da phpbb.it viene fornito in lingua Italiana. Tuttavia sono disponibili molti pacchetti separati tradotti in varie lingue. Il processo di installazione ti permetterà di selezionare una lingua predefinita da quelle disponibili (potrai naturalmente modificare questo anche in un momento). Per maggiori dettagli sui pacchetti di lingua, dove reperirli e come installarli leggi README.

Una volta che tutti i file sono stati caricati nel tuo sito devi puntare il browser a questo percorso con l'aggiunta di install/ es. se il tuo nome dominio è www.miodominio.it e phpBB3 risiede nella cartella /phpBB3 dovrai scrivere:
http://www.miodominio.it/phpBB3/install/ o (in alternativa) http://www.miodominio.it/phpBB3/install/index.php. Dovresti ora vedere la schermata di installazione phpBB3.

Introduzione:
La schermata di installazione visualizza una breve introduzione a phpBB e ti consente di leggere la licenza secondo cui phpBB3 è stato rilasciato (General Public License) fornendo anche le informazioni su come è possibile ricevere supporto. Per avviare l'installazione, clicca il pulsante Installa.

Requisiti:
La prima pagina che ti viene mostrata dopo l'inizio dell'installazione è quella contenente la lista dei REQUISITI.
PhpBB3 controlla automaticamente che sul server sia installato tutto il necessario per una corretta esecuzione. È necessario che sia installato almeno la versione minima di PHP e almeno un database disponibile per continuare l'installazione. È importante anche che tutte le cartelle mostrate siano disponibili e abbiano i permessi corretti. Osservando la descrizione di ogni sezione è possibile capire cosa è opzionale e cosa è necessario per l'esecuzione di phpBB 3.0. Se tutto è corretto è possibile continuare l'installazione con il pulsante Inizia Installazione.

Impostazioni del database:
Adesso devi scegliere quale database usare. Guardando la sezione riguardante i requisiti Requisiti di phpBB3 è possibile trovare informazione sui database supportati. Se non conosci le impostazioni del tuo database devi contattare e chiederle al tuo servizio hosting, in caso contrario non potrai continuare l'installazione. Sono necessari:

• TIPO DI DATABASE - seleziona il tipo di database che utilizzerai
• DSN o HOSTNAME - scrivi l'indirizzo server del database (solitamente localhost)
• PORTA SERVER DATABASE - scrivi la porta utilizzata dal server per il database (la maggior parte delle volte non è necessaria)
• NOME DATABASE - scrivi il nome del database che ti è stato fornito
• NOME UTENTE DATABASE e PASSWORD DATABASE - scrivi i dati di accesso al database che ti sono stati forniti

Note:
Se stai installando utilizzando SQLite, devi inserire il percorso completo del tuo database nel campo DSN e lascia vuoti i campi nome utente e password. Per ragioni di sicurezza, dovresti assicurarti che il database non sia allocato in un luogo accessibile da web.

Non hai bisogno di cambiare il Prefissi alle tabelle del database, a meno che tu non intenda installare diversi phpBB3 sullo stesso database. In questo caso puoi usare un prefisso diverso per ogni installazione per farlo funzionare.

Dopo aver inserito i tuoi dettagli, puoi continuare utilizzando il bottone Procedi al passaggio successivo. Ora phpBB3 controllerà che i dati inseriti permettano una corretta connessione al database e se esistono già tabelle con lo stesso prefisso.

Se ricevi l'errore Impossibile collegarsi al database significa che non hai inserito i dati correttamente e phpBB3 non può connettersi. Assicurati che siano stati inseriti correttamente e riprova. Se non sei sicuro delle impostazioni del tuo database contatta il tuo host.

Se hai già installato un'altra versione di phpBB sullo stesso database e con lo stesso prefisso, phpBB ti informerà che devi utilizzare un prefisso diverso.

Se vedi il messaggio connesso con successo, puoi continuare col successivo passaggio.

Dettagli Amministratore:
Ora devi creare l'amministratore. Questo utente avrà accesso totale alla gestione, e sarà il primo utente del tuo forum. Tutti i camipi in questa pagina sono obbligatori. Puoi anche impostare la lingua predefinita per il tuo forum. Il pacchetto standard di phpBB3 se scaricato da phpBB.it include la lingua Inglese e la lingua Italiana. Puoi scaricare altre lingue da http://www.phpbb.com/.

Configurazione del file:
In questo passaggio phpBB proverà a scrivere automaticamente il file di configurazione, Il forum necessita di tale configurazione per poter funzionare correttamente. Contiene tutte le impostazioni del database, senza le quali, phpBB non è in grado di connettersi.

Di solito la scrittura del file di configurazione avviene automaticamente, ma in alcuni casi questo può fallire a causa di permessi errati dei file. In questo caso, è necessario caricare il file manualmente. phpBB ti chiederà di scaricare il file config.php e ti spiega cosa fare. Leggi attentamente le istruzioni. Dopo aver caricato il file, premi Fatto e procedi al passaggio finale. Se si ritorna alla pagina precedente, e non si riceve il messaggio di successo, vuol dire che non hai caricato il file correttamente.

Impostazioni avanzate:
Le Impostazioni avanzate ti permettono di impostare alcuni parametri per la configurare il sistema.
Sono opzionali e puoi sempre cambiarle successivamente. Quindi se non sei sicuro di cosa significano queste impostazioni, procedi al passaggio successivo e termina l'installazione.

Se l'installazione ha avuto successo puoi usare il bottone Login e accedere al Pannello di Controllo Amminstratore. Congratulazioni, phpBB3 è stato installato con successo. Ma hai ancora molto lavoro da fare!

Se non sei in grado di installare phpBB3 anche dopo aver letto questa guida, dai un'occhiata alla Sezione di supporto per sapere dove poter chiedere ulteriore assistenza.

A questo punto se stai aggiornando dalla versione phpBB2 fai riferimento alla sezione aggiornamento per ulteriori informazioni. Diversamente devi rimuovere la cartella install/ dal server la cui presenza permette di navigare solo il Pannello di Controllo Amministratore.

4. Aggiornamento da versioni stabili di phpBB 3.0.x
Se si sta utilizzando una versione stabile di phpBB3 l'aggiornamento all'ultima versione è veramente molto semplice. In base al pacchetto scaricato dei quattro pacchetti a disposizione determina ciò che devi fare. Nota: prima di effettuare l'aggiornamento è consigliabile eseguire un backup completo del database e dei file di phpBB3! Se non sai come fare rivolgiti al tuo fornitore di hosting.

Devi aggiornare i file sorgente di phpBB3 anche se si esegue il file database_update.php.

4.1 Pacchetto completo
Il pacchetto completo è di norma utilizzato per nuove installazioni, ma in alcuni casi questo pacchetto può essere utile per sovrascrivere tutti i file sorgente.

In caso tu voglia sovrascrivere tutti i file la prima cosa da fare è una copia del tuo attuale file config.php, e conservarlo in un luogo sicuro! Successivamente puoi eliminare tutti i file esistenti, magari mantenendo le cartelle files/ e images/ e salvando gli stili alternativi. Una volta completato l'invio utilizza la copia salvata del file config.php, in sostituzione a quello presente. Un altro metodo è quello di sostituire solo i file esistenti con i file del pacchetto - assicurandoti di non sovrascrivere il tuo file config.php.

Ora devi eseguire l'installazione install/database_update.php che, a seconda della versione in uso, farà un certo numero di modifiche nel database. È possibile ricevere MALFUNZIONAMENTI nel corso di questa procedura, non dove essere un motivo di preoccupazione se non si vede un effettivo ERRORE, in qual caso lo script si ferma (quindi devi cercare aiuto attraverso il nostro forum o bug tracker).

Una volta che install/database_update.php ha completato cancella la cartella install/ come consigliato.

4.2 Solo file modificati
Questo pacchetto è destinato a coloro che desiderano sostituire solo i file cambiati da una versione precedente alla versione più recente. Questo pacchetto contiene normalmente i file modificati per un massimo di cinque versioni precedenti.

Il pacchetto contiene una serie di archivi, ciascuno contenente i file modificati da una data di rilascio per la versione più recente. Devi selezionare l'archivio per la versione corrente, es. se attualmente utilizzi la versione 3.0.1 si deve selezionare il file phpBB-3.0.1_to_3.0.2.zip/tar.gz.

La struttura delle cartelle è identica alla struttura di base e consente (se vuoi) di caricare semplicemente il contenuto dell'archivio nella posizione appropriata sul tuo server, vale a dire semplicemente sovrascrivere i file esistenti con le nuove versioni. Non dimenticare che se sono presenti Mod questi file sovrascrivono gli originali, distruggendo il loro funzionamento.

Come per le altre procedure di aggiornamento è necessario eseguire install/database_update.php dopo aver terminato l'aggiornamento dei file. In modo da aggiornare lo schema del database ed incrementare il numero della versione.

4.3 Patch file
Il pacchetto patch file è destinato a coloro che desiderano aggiornare il sistema attraverso l'applicazione della patch.

Il patch file è una soluzione ideale per chi ha molte Mod o altre modifiche. Per utilizzare questo deve poter eseguire comandi a un'programma di correzione di tipo UNIX standard. Se non si dispone di un accesso a una tale applicazione ma volete ancora utilizzare questa tipologia di aggiornamento, raccomandiamo l'uso del pacchetto di aggiornamenti automatico. È il metodo preferito di aggiornamento.

Un certo numero di file patch vengono forniti per consentire l'aggiornamento da versioni precedenti stabili. Seleziona la corretta patch, es. se la tua attuale versione è 3.0.1 dovrai usare il file phpBB-3.0.1_to_3.0.1.patch. Metti la corretta patch nella cartella contenente il tuo phpBB3 (vale a dire nella posizione dove c'è index.php, viewforum.php, ecc.). Appena termini l'invio al server della patch devi eseguire il seguente comando: patch -cl -d [PHPBB DIRECTORY] -p1 < [PATCH NAME] (dove trovi PHPBB DIRECTORY è il nome della cartella dove risiede il tuo phpBB, es. phpBB3 e dove trovi, PATCH NAME è il nome file relativo al file di correzione selezionato). Questo dovrebbe terminare rapidamente, probabilmente senza errori HUNK FAILED.

Se visualizzi errori dovrai utilizzare i file modificati per modificare e per sostituire i file che non corretti, si ricorda che è necessario reintrodurre a mano le modifiche MOD a questi particolari file.

Una volta ultimato il tutto naturalmente dovrai cancellare il file patch (o file). Quanto alle altre procedure di aggiornamento eseguire install/database_update.php dopo avere finito di aggiornare i file. Questo aggiornerà lo schema del database e incrementa il numero di versione.

4.4 Pacchetto di aggiornamento automatico
Questo metodo di aggiornamento è quello preferito. Questo pacchetto consente di rilevare automaticamente i file cambiati e confronta le modifiche se necessario.

Il pacchetto di aggiornamenti automatico mantiene, contrariamente agli altri, solo le informazioni di aggiornamento per l'aggiornamento dell'ultima versione rilasciata all'ultima versione disponibile.

Per eseguire l'aggiornamento, segui le istruzioni dal Pannello di Controllo Amministratore -> Sistema, qui ti viene indicato che hai in esecuzione una versione non aggiornata e ti guiderà attraverso l'aggiornamento o segui le istruzioni sotto elencate.

• Vai alla pagina di Download e scarica la versione più recente del pacchetto di aggiornamento in elenco, che corrisponde ai criteri della versione corrente
• Carica gli archivi contenuti sul tuo phpBB - solo la cartella di installazione, è obbligatoria. Carica l'intera cartella di installazione, mantenendo la struttura dei file
• Dopo che la cartella di installazione è presente, phpBB3 andrà automaticamente in modalità non in linea
• Punta il tuo browser alla cartella di installazione, es. http://www.tuosito.it/phpBB3/install/
• Scegli "Aggiorna" e segui le istruzioni

4.5 Pacchetto Lingua
Il file di lingua può subire modifiche, verifica se è disponibile una nuova versione. Un certo numero di stringhe mancanti possono essere state aggiunte, che anche se non indispensabili, possono essere utile agli utenti.

5. Conversione da phpBB 2.0.x a phpBB 3.0.x
Questo punto spiega i passaggi necessari per convertire il tuo phpBB2 in phpBB3.

5.1 Requisiti prima della conversione
Prima della conversione devi eseguire un backup completo del database e dei file! Se non sai come fare rivolgiti al tuo fornitore hosting per un consiglio. Fondamentalmente si devono seguire le istruzioni di base per nuove installazioni. Non sovrascrivendo nessun file - installa phpBB3 in una cartella differente da quella utilizzata da phpBB2.

Una volta effettuato il backup completo e caricato via FTP phpBB3 e installato, puoi avviare la conversione.

5.2 Conversione
Per iniziare la conversione visita la cartella di installazione del tuo phpBB3 (stessa dell'installazione). Ora vedrai una nuova scheda Converti. Clicca su questa scheda.

Il processo di conversione è automatizzato. Le precedenti tabelle del database 2.0.x non verranno modificate così come i file. La conversione in realtà è solo il riempimento delle tabelle del database del phpBB3 e la copia dei dati aggiuntivi oltre all'installazione di base di phpBB3. Ciò ha il vantaggio che anche se dovesse andare male la conversione si è in grado di ripristinare, rieseguire la conversione o continuare una conversione, mentre il vecchio forum è ancora accessibile. Si consiglia di disattivare il vecchio forum, prima di avviare la conversione, altrimenti si possono avere dati incoerenti dopo la conversione.

Fai attenzione, il processo di conversione può durare molto tempo a socondo del tuo hosting che potrebbe stopparlo (a causa del server web o altri problemi di timeout). In questo caso dovrai chiedere al tuo fornitore se sono disposti a modificare temporaneamente i limiti di timeout.

Una volta completato il tuo forum dovrebbe essere immediatamente disponibile.

5.3 Cose da fare dopo la conversione
Dopo che la conversione è riuscita, ci sono alcuni cose che devi fare - oltre a verificare se l'installazione è accessibile e il tutto viene visualizzato correttamente.

La prima cosa che suggeriamo di fare è andare nel Pannello di Controllo Amministratore e controllare ogni elemento di configurazione all'interno della scheda Generale. Successivamente, si possono modificare le descrizioni/nomi del forum se hai inserito HTML. Puoi anche accedere alle altre sezioni amministrative, ad esempio, permessi, smilie, icone, ecc.

Durante la conversione l'indice di ricerca non è stato creato o trasferito. Ciò significa che dopo la conversione non siete ancora in grado di trovare alcun risultato nella ricerca. Ti consigliamo di ricostruire l'indice di ricerca all'interno di Amministrazione -> Manutenzione -> Database -> Indice di ricerca.

Dopo aver verificato le impostazioni nel PCA, è possibile eliminare la cartella di installazione per consentire l'accesso al forum. Il forum resterà disabilitato fino a quando non cancelli tale cartella.

Una volta che siete soddisfatti della vostra nuova installazione puoi rinominare il nome della cartella contenente il nuovo phpBB3. Questo è possibile senza alcun problema - ma prima devi controllare le impostazioni dei cookie nel pannello di amministrazione, il percorso dei cookie devono essere adeguati prima di rinominare la cartella.

5.4 Problemi comuni di conversione
Caratteri non latini: Il processo di conversione presuppone che la codifica del database di phpBB2 corrisponda alla codifica definita nel file lang_main.php del pacchetto di lingua predefinito dell'installazione della sorgente. Edita quel file per far cincidere la codifica del database e riavvia il processo di conversione.

HTTP 500 / pagine bianche: La conversione è un processo load-heavy. Le limitazioni vengono imposte da alcuni server hosting e possono creare problemi. Le cause più comuni sono: valori troppo bassi per le impostazioni php memory_limit e max_execution_time. I limiti di tempo di CPU consentita sono un motivo frequente di tali errori, dato che vengono limitate il numero di query consentite al database. Se non puoi modificare tali impostazioni, contatta il tuo hosting o esegui la procedura di conversione su un computer diverso. Il forum di phpBB.com e phpBB.it sono un ottimo punto di partenza per chiedere supporto.

Conversione password: A causa della codifica utf-8 sulle password in phpBB3, non è sempre possibile trasferire tutte le passworddel vecchio database. Per le password "non importate" la soluzione più semplice è quella di far utilizzare la funzione "password dimenticata".

Percorso al vecchio forum: Il convertitore si attende il percorso relativo ai file del vecchio forum. Es. se il vecchio forum risiede in http://www.tuodominio.it/forum e l'installazione di phpBB3 risiede in http://www.tuodominio.it/phpBB3, il valore corretto è ../forum. Nota che il server web deve essere in grado di accedere alla fonte di installazione del file.

Immagini mancanti: Dovrai scaricare dal phpBB.it i 2 pacchetti di immagini e inviarle dentro la cartella relativa allo stile in uso.

Smilie: Durante la conversione si deve controllare quali file di immagine la copia non sia riuscita. Può accadere se il vecchio forum conteneva smilie con gli stessi nomi come quelli del nuovo forum. Copia tali file manualmente dopo la conversione, se vuoi continuare ad utilizzare i vecchi smilie.

6. Note importante (riguardanti la sicurezza) post-installazione per tutti i metodi di installazione
Una volta installato phpBB3 correttamente devi rimuovere l'intera cartella install/. Lasciare la cartella di installazione è in atto gravissimo per potenziale problema di sicurezza e potrebbe portare alla cancellazione o la modifica di file, etc. Fai attenzione a questo, fino a quando questa cartella non è stata rimossa, phpBB3 non funzionerà e verrà visualizzato un messaggio di avviso. Oltre a cancellare la cartella install/, potete anche cancellare la cartella docs/ ma per quest'ultima non è obbligatorio.

Eliminata questa cartella vai nel Pannello di Controllo Amministratore. A seconda di come è stata completata l'installazione è possibile che ti abbia rindirizato automaticamente. Se così non fosse, effettua il login come amministratore e clicca su Pannello di Controllo Amministratore il link lo trovi in fondo a qualsiasi pagina. Garantire che i dati di cui al Admin -> Generale sono corretti!

6.1 Invio avatar
phpBB3 supporta numerosi metodi di selezione avatar per gli utenti (un avatar è una piccola immagine generalmente associata a un utente e visualizzata solo sotto il nome utente nei messaggi).

Due di queste opzioni consentono agli utenti di caricare un avatar dal proprio PC o da una posizione remota (tramite URL). Se desideri attivare questa funzione è necessario impostare correttamente il percorso della cartella per il caricamento avatar che puoi impostare da Amministrazione -> Generale -> Configurazione -> Avatar. Come impostazione predefinita la cartella di caricamento avatar è images/avatars/uploads, ma puoi cambiarla a tuo piacimento. È inoltre necessario che questa cartella abbia i permessi di scrittura. Questo significa che devi cambiare i permessi della cartella. Come impostare i permessi a una cartella dipende dal tuo client FTP o del sistema operativo del server.

Su sistemi UNIX ad esempio si imposta la cartella a+rwx (o ugo+rwx o 777). Questo può essere fatto da una riga di comando sul server utilizzando il comando chmod o tramite il client FTP (per l'uso di Modifica Permessi, chmod o altri Permessi, leggi la documentazione del tuo client FTP). La maggior parte dei client FTP ha un elenco dei permessi con questa gerarchia: Proprietario (leggi, scrivi, esegui), Gruppo (leggi, scrivi, esegui) e Pubblico (leggi, scrivi, esegui). È necessario spuntare tutte queste caselle per impostare i permessi corretti.

Sul sistemi Windows è necessario che la cartella non sia protetta da scrittura e che ha i permessi totali di scrittura (leggi la documentazione del tuo server o contatta il tuo fornitore di hosting, se non sai come agire).

Riccorda che l'impostazione di una cartella con permessi globali di accesso in scrittura è un potenziale problema di sicurezza. Ma è improbabile che possano accadere problemi su cartelle come (avatars). Quindi si deve monitorare spesso questa cartella e, se possibile, fare copie di backup regolari.

7. Disclaimer
Questo software opensource è stato rilasciato sotto licenza GPL. Consulta il codice sorgente e la documentazione all'interno della cartella docs/ del pacchetto per maggiori dettagli. Questo pacchetto e il suo contenuto sono coperti da Copyright (c) 2000, 2002, 2005, 2007 phpBB Group, Tutti i diritti sono riservati.