[[Vorlage(Archiviert,  )]] 
[[Vorlage(Fortgeschritten)]]

{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen] 
[:Terminal: Ein Terminal öffnen] 
[:Packprogramme: Archive entpacken]
}}}
[[Inhaltsverzeichnis(3)]] 

[[Bild(./logo_phpBB.png, 140, left)]] 
[https://www.phpbb.com/ phpBB] {en} ist eine Foren-Anwendung (Bulletin Board), die auf einem Web-Server mit PHP und einer Datenbank läuft. Mit Hilfe der Software lässt sich recht einfach ein [wikipedia:Internetforum:] erstellen. Für nähere Informationen zu phpBB sei auf den entsprechenden Beitrag in der [wikipedia:phpBB:Wikipedia] verwiesen.

= Voraussetzungen =
phpBB benötigt eine Reihe von Voraussetzungen: Auf dem Rechner müssen ein [:Serverdienste#Webserver: Webserver], die Skriptsprache [:PHP:] und eine von phpBB unterstützte [:Serverdienste#Datenbank: Datenbank] installiert sein. phpBB benötigt nicht unbedingt den populären [:Apache:] als Webserver. Kleine und schlanke Alternativen wie [:lighttpd:Lighty] funktionieren auch, sofern die angegebenen [https://www.phpbb.com/support/documents.php?mode=install#require Anforderungen] {en} erfüllt sind. Die Datenbank kann auf einem separaten Rechner betrieben werden. In diesem Beispiel wird jedoch davon ausgegangen, dass alle Komponenten auf einem Rechner laufen und Apache als Webserver eingesetzt wird. 

= Installation =
== Manuell ==
Die bevorzugte Variante zur Installation von phpBB sollte die manuelle Installation sein. Dazu muss phpBB als Archiv heruntergeladen werden. Man bekommt entweder die englische Originalversion von der [https://www.phpbb.com/downloads/ offiziellen Downloadseite] {en} {dl} des Projekts, welche man mit einem [#Deutsches-Sprachpaket-installieren deutschen Sprachpaket] eindeutschen muss, oder eine Version mit bereits integriertem deutschen Sprachpaket von der [https://www.phpbb.de/downloads/pakete.php Downloadseite der offiziellen deutschen Hilfs-Seite] {de} {dl}.

Dieses Archiv entpackt [3] man dann in das gewünschte Verzeichnis seines Webserver-Basisverzeichnisses (oder in ein beliebiges anderes Verzeichnis unter Verwendung eines [:Apache/Virtual_Hosts: virtuellen Hosts]). Weiterhin muss als Vorbereitung im gewünschten Datenbanksystem eine leere Datenbank angelegt werden.

Sind die Vorbereitungen abgeschlossen, muss in einem Browser das Verzeichnis, in welches phpBB entpackt wurde, (bspw. über `http://localhost/phpBB`) aufgerufen werden um die Installation zu starten. Genauere Beschreibungen zum weiteren Installationsvorgang bietet das [https://www.phpbb.com/support/documentation/3.0/quickstart/quick_installation.php phpBB-Handbuch] {en}.

[[Vorlage(Fremd, Software)]]

== Aus den offiziellen Paketquellen (bis Xenial) ==
Neben der manuellen Installation steht in den offiziellen Paketquellen auch ein Paket für phpBB bereit. 
{{{#!vorlage Experten
Obwohl die Einstiegshürde hier wesentlich geringer ist, sollte auf einem Produktivsystem, welches aus dem Internet erreichbar ist, auf die Verwendung dieses Pakets verzichtet werden. Es befindet sich lediglich in der Sektion `universe` und wird deshalb nicht offiziell unterstützt bzw. gepflegt. Des Weiteren ist die Version in den Paketquellen aus diesem Grund in der Regel veraltet und enthält im schlechtesten Fall nicht behobene Sicherheitslücken!

Weitere Vorteile der manuellen Installation sind:
 1. Es können auch andere Datenbank-Systeme als MySQL verwendet werden.
 1. Es können auch andere Webserver als Apache verwendet werden.
 1. Anpassungen am Forum werden bei einem eventuellen Update des Pakets nicht wieder mit den Originaldateien überschrieben.
}}}
Für ein kurzes Reinschnuppern auf einem lokalen Testsystem kann dieses Paket aber verwendet werden. Man kann es über

{{{#!vorlage Paketinstallation
phpbb3, universe, bis Ubuntu [:16.04:]
}}}

installieren [1], wobei hier allerdings [:Apache:] und [:MySQL:] als Abhängigkeiten konfiguriert sind und deshalb mitinstalliert und im Anschluss auch von phpBB benutzt werden.

=== Forum aktivieren ===
[[Bild(./phpBB3.png, 300, right)]] Nach Beendigung der Installation kann das Forum in einem Browser durch die Eingabe folgender Adresse aufgerufen werden: 

 * `http://localhost/phpbb`

Das Forum ist anfangs deaktiviert. Um das Forum zu konfigurieren, muss man sich als Administrator über den Link ''"Log in"'' in das Forum einloggen. Die Vorgabewerte für den Nutzernamen und das Passwort des Administrators lauten: 

 * ''"Benutzername"'': `admin`
 * ''"Passwort"'': `admin`
 
{{{#!vorlage Hinweis
Bei der Installation aus den offiziellen Paketquellen wird das Passwort des Foren-Administrators während der Installation abgefragt. In diesem Fall ist zum Login natürlich das dort vergebene Passwort einzugeben.
}}}

Nachdem man sich als Administrator eingeloggt hat, findet sich unten auf der Seite ein kleiner Link  ''"Administration Control Panel"'', über den das Konfigurationsmenü aufgerufen werden kann.  Die Option zum Aktivieren des Forums findet sich unter ''"General -> Board settings"''. Außerdem sollte man nicht vergessen, das Admin-Passwort zu ändern (falls es während der Installation nicht personalisiert wurde).

= Deutsches Sprachpaket installieren =
Wenn man die englische Originalversion oder die Version aus den Ubuntu-Paketquellen verwendet, dann muss ein Sprachpaket installiert werden, wenn man sein Forum in einer anderen Sprache als englisch verwenden möchte.

== Aus den Paketquellen ==

{{{#!vorlage Paketinstallation
phpbb3-l10n, universe, bis Ubuntu [:16.04:]
}}}

== Manuelle Installation ==
[[Vorlage(Fremd, Software)]]
Für eine manuelle Installation des Sprachpakets lädt man sich zuerst das entsprechende Sprachpaket von [https://www.phpbb.com/languages/ phpbb.com] {en} herunter und installiert es wie folgt:

 * Bei einer manuellen Installation entpackt [3] man das Archiv mit Root-Rechten in das phpBB-Basisverzeichnis, so dass sich die enthaltenen Verzeichnisse '''language''' und '''styles''' in die vorhandenen Verzeichnisse integrieren.
 * Bei der Installation aus den offiziellen Paketquellen muss das im Archiv enthaltene Verzeichnis '''language''' in das Verzeichnis '''/usr/share/phpbb3/www/language''' und das Verzeichnis '''styles''' in das Verzeichnis '''/usr/share/phpbb3/styles''' integriert werden.

Nach der Installation kann man dann unter ''"Administration Control Panel -> System -> Language packs"'' das Sprachpaket installieren lassen und bei Bedarf unter ''"General -> Board settings"'' Deutsch als Standardsprache einstellen.

= Links =
 * [https://www.phpbb.com/ phpBB Homepage] {en} - Offizielle Internetpräsenz 
 * [https://www.phpbb.de/ phpBB Forum] {de} - Offizielle deutschsprachige phpBB-Hilfe 
 * [wikipedia:phpBB:] - Wikipedia 

# tag: Server, Webforum, Forum, phpBB, phpBB3, phpBB 3