phpBB 3.2/3.3 - Upgrade von phpBB 3.0

Beschreibung: Dieser Artikel erläutert die einzelnen Schritte des Upgrades von phpBB 3.0.x auf 3.2.x. oder phpBB 3.3.x

Kategorie: Wichtig, Installation und Update

Link zu diesem Artikel: Alles auswählen

[url=https://www.phpbb.de/kb/viewarticle?a=17&sid=5efde4a31962ac838723a76d75e85ab3]Knowledge Base - phpBB 3.2/3.3 - Upgrade von phpBB 3.0[/url]

Dieser Artikel erläutert die einzelnen Schritte des Upgrades von phpBB 3.0.x auf 3.2.x. oder 3.3.x
Mit dem Schritt von phpBB 3.0 nach 3.1/3.2/3.3 ging ein teilweise massiver Umbau der Codebasis einher, wovon insbesondere auch die Style- und Erweiterungssysteme betroffen sind.
Aus diesem Grund sind für phpBB 3.0 erstellte Styles und MODs nicht mit phpBB 3.1/3.2/3.3 kompatibel und gehen folglich durch ein Upgrade verloren bzw. können nicht mitgenommen werden.
Funktionale Erweiterungen werden jetzt durch Extensions zur Verfügung gestellt, deren großer Vorteil darin liegt, dass sie als in sich abgeschlossene Erweiterungen konzipiert sind, die bei Installation keine Änderungen am Core Code mehr erforderlich machen.
Prinzipiell gibt es zwei Möglichkeiten, ein Upgrade von phpBB 3.0 auf 3.2/3.3 durchzuführen:
  1. Die bevorzugte und empfohlene Methode: das manuelle Upgrade, auch "File Replacement Methode" genannt:
    Hierbei werden manuell alle alten Dateien der Installation (mit wenigen Ausnahmen) entfernt und durch die Dateien eines aktuellen phpBB 3.2/3.3 Komplettpaketes ersetzt.
    Das darauf von der Installationsroutine durchgeführte Datenbankupdate schließt den Upgradevorgang ab.
    Der Vorteil hierbei: es ist der einfachste und sicherste Weg zu einem 3.2 Board, da ohnehin die alten Dateien nicht mehr weiterverwendet werden können.
    Das Upgrade ist hier theoretisch von jeder 3.0 Version aus möglich.
  2. Nicht empfohlen: Upgrade via automatischem Updater:
    Hierbei übernimmt die Updateroutine den kompletten Vorgang, allerdings setzt dies als Ausgangsversion phpBB 3.0.14 voraus.
    Nachteile: abhängig von der zu wählenden Routine können dennoch Schritte verbleiben, die vom Benutzer selbst durchgeführt werden müssen und daher eine mögliche Fehlerquelle darstellen.
    Weiterhin bleibt ein Restrisiko bestehen, dass es während des Upgradelaufs zu nicht aufgefangenen Fehlern oder Unregelmäßigkeiten kommen könnte, die dann zu einem nicht stabil laufenden Board führen oder zusätzliche manuelle Nacharbeit erfordern.
    Diese Methode ist daher nur für Benutzer geeignet, die über entsprechende Erfahrung bzw. Kenntnisse verfügen.

    Hinweis: Aus den genannten Gründen und da ohnehin beim Upgrade alle 3.0.x Dateien des Kerncodes ersetzt werden müssen, wird dieses Paket von phpbb.de nicht angeboten!
    Im weiteren Verlauf dieses Artikels wird daher nur auf das manuelle Upgrade eingegangen.
Sicherheitshalber sollte die gewählte Variante an einer Kopie des Boards durchgespielt werden, um mögliche Probleme beim späteren Upgrade des Live Boards bereits im Vorfeld erkennen und ausschließen zu können.

Aufgrund der eingangs erwähnten Änderungen am Kerncode von phpBB sind einige Dinge zu beachten, daher wird im Folgenden der Upgradevorgang in drei Phasen unterteilt:
  1. Vorbereitung
  2. Bereinigung (der Ausgangsinstallation)
  3. das eigentliche Upgrade
Glossar:
  • Installationsverzeichnis (auf dem Server):
    Das Verzeichnis auf dem Server, in dem sich die Ordner und Files des phpBB Paketes befinden (= das Verzeichnis, in dem auch die Konfigurationsdatei config.php liegt).
    Bei Pfadangaben innerhalb dieses Artikels wird hierfür <phpbb_root> verwendet.
  • STK:
    Support Toolkit für phpBB 3.0 - eine Sammlung offizieller Hilfsmittel und Scripte zur Wartung und Reparatur beschädigter phpBB 3.0-Installationen.
  1. Vorbereitungen:
    1. Prüfen, ob die Systemvoraussetzungen erfüllt sind: u.a. mindestens PHP in der Version 5.4.x oder höher.
    2. Board in den Wartungsmodus versetzen (deaktivieren via ACP - Allgemein - Boardeinstellungen)
      => Admin-Bereich > Tab: Allgemein > Board-Einstellungen > Board deaktivieren: [i]ja[/i], (die Begründung ist optional)
    3. Prüfen, ob bei Verwendung von MySQL als Datenbanksystem in der config.php der Datenbanktreiber mit mysqli angegeben ist, ansonsten ändern:

      Code: Alles auswählen

      $dbms = 'phpbb\db\driver\mysqli';
      (Hintergrund: in PHP 7.x wird der ältere mysql-Treiber nicht länger unterstützt und wurde daher entfernt. Dies kann bei einem späteren Wechsel der PHP-Version auf 7.x zu Problemen und Fehlern beim Betrieb des Boards führen.}
    4. Sofern noch nicht geschehen: vollständiges Backup von Datenbank und allen Dateien im phpBB-Installationsverzeichnis machen und lokal speichern (siehe hierzu auch MySQL Backup)
    5. Das aktuelle deutsche Komplettpaket im Downloadbereich auf phpbb.de herunterladen und lokal entpacken
    6. In dem entpackten Paket die dort enthaltene config.php suchen und löschen
    7. Das zur installierten phpBB-Version passende STK herunterladen und ins phpBB-Installationsverzeichnis auf dem Server hochladen
  2. Bereinigung:
    1. Im ACP des Boards alle Styles außer Prosilver deinstallieren
    2. Falls Captchas eingesetzt wurden, die nicht zur Grundausstattung von phpBB gehören: im ACP das Captcha auf eines der Standardcaptchas zurücksetzen.
    3. Das STK aufrufen und die Datenbankbereinigung durchführen. Dabei alle Einträge der alten MODs und eventuell von ihnen eingefügte Module in der Datenbank entfernen lassen => die DB wird dadurch wieder in ihre ursprüngliche Struktur zurückgesetzt, während alle relevanten Daten (Benutzer, Foren, Beiträge etc.) erhalten bleiben
  3. Upgrade:
    1. Im Installationsverzeichnis des Boards alle Dateien/Ordner löschen außer:
      • config.php (enthält unter anderem die Zugangsdaten zur Datenbank)
      • /files (in diesem Ordner liegen die Dateianhänge)
      • /images (in diesem Ordner liegen unter anderem die Smilies, die Rangbilder und die Avatarbilder)
      • Optional: /store (hier werden u.a. übers ACP generierte Datenbank-Backups gespeichert)
      • Optional: /download (falls in diesen Ordner Dateien manuell hochgeladen wurden, die weiter verwendet werden sollen/müssen)
    2. Den Inhalt des oben ausgepackten Ordners "phpBB3" (minus der config.php ;) ) des Komplettpakets ins Installationsverzeichnis auf dem Server hochladen.
      Noch vorhandene Dateien kannst Du dabei überschreiben lassen (deswegen ja auch vorher die config.php aus dem hochzuladenden Komplettpaket entfernen ;) )
    3. Wenn alles erfolgreich und fehlerfrei hochgeladen wurde: im Browser die Adresse des Installationsordner aufrufen => <pfad_zum_board>/install/
      (Sollte dies wider Erwarten nicht zur Startseite des Upgrademoduls führen, alternativ mit <pfad_zum_board>/install/app.php erneut versuchen.)
    4. Sollte das Installationsmodul nicht in Deutsch angezeigt werden: dies kann rechts oben in der Sprachauswahl korrigiert werden.
    5. Von den Tabs links oben "Aktualisieren" anklicken
    6. Da bereits alles Dateien durch neue ersetzt wurden bekommst Du als Option nur noch "Datenbankupdate durchführen" angeboten => auswählen und bestätigen, um das DB-Update zu starten.
    7. Wenn dieser Lauf erfolgreich abgeschlossen ist: das /install/ Verzeichnis auf dem Server löschen und Dich am ACP anmelden
    8. Bitte beachten / wichtig:
      Im darauffolgenden Bildschirm werden zwei Optionen angezeigt, die noch bestätigt werden müssen:
      • "Statistische Informationen senden"
      • Unter VigLink => "Aktivieren"
      Die im Paket enthaltene VigLink Extension wurde im Laufe des Upgradeprozesses bereits installiert und aktiviert (!) - wenn Du dies wieder rückgängig machen willst, dann hier unbedingt die bereits markierte Option wieder abwählen und bestätigen!
    9. Sicherheitshalber Board- und Browsercache leeren
      (In seltenen Fällen kann es ansonsten zu vermeintlichen Darstellungsfehlern des Styles Prosilver kommen)
    10. Testen, ob Fehler auftreten - wenn die Tests erfolgreich verlaufen sind:
    11. Wartungsmodus wieder aufheben (Board aktivieren via ACP - Allgemein - Board-Einstellungen)
Du hast jetzt ein aktuelles 3.2/3.3 Board ohne Reste früherer MODs.