Code: Alles auswählen
[url=https://www.phpbb.de/community/viewtopic.php?t=246810]phpBB File Check - Zum prüfen auf Existenz und Intaktheit der phpBB Dateien[/url]
- Einleitung
- Beispiel Bericht
- Erklärung der Meldungen
- Anleitung
- Nach Benutzung löschen
- Sonstiges
- Download
Es kommt immer mal wieder vor, dass bei der Installation von phpBB oder nach einem Update der Verdacht besteht, dass Dateien von phpBB entweder defekt sind oder ganz fehlen. In den meisten Fällen sind Probleme beim Hochladen der zahlreichen Dateien die Ursache. Da eine manuelle Prüfung aller Dateien durch ihre schiere Anzahl (über 4000 beim deutschen Komplettpaket) praktisch nicht durchführbar ist, wurde dieses Tool geschaffen. Damit kann der komplette phpBB Core schnell und zuverlässig auf Vollständigkeit und Integrität überprüft werden.
- Das Tool wird bei Bedarf von den Supportern (nicht auf das phpBB.de Team beschränkt) verlinkt, wenn der Verdacht auf eine beschädigte Dateistruktur besteht.
- Wer Änderungen an Core Dateien vorgenommen hat, der bekommt bei den betroffenen Dateien entsprechende
* CHANGED
Meldungen. - Das Tool kann nicht zwischen einer gezielten Änderung und einem echten Defekt unterscheiden, sondern kann nur feststellen, ob eine Datei noch im Originalzustand ist oder nicht.
- Kann sowohl im Browser als auch in der Shell ausgeführt werden, File Check passt sich automatisch an.
- Kann sowohl unter Linux als auch unter Windows ausgeführt werden.
- Benötigt zur Ausführung keine phpBB Komponenten, ist also vollständig autark. Somit kann auch eine stark beschädigte phpBB Installation geprüft werden.
- Voraussetzung: PHP 7.1 oder höher. Getestet bis einschließlich PHP 8.3.
Code: Alles auswählen
phpBB File Check v1.1.0
=======================
phpBB Version: 3.3.10
MD5 Version 1: 3.3.10 (phpBB.com) AUTO
MD5 Version 2: 3.3.10 (phpBB.de) AUTO
PHP Version : 8.2.8 (WINNT)
Please wait, 4049 checksums are being processed...
--------------------------------------------------------------------------------------------------------
{1: 20} ! MISSING: [web.config]
{1: 246} * CHANGED: [config/production/config.yml] (hash: d063b506c36d582fddd1af49e7bd3ea9)
{1:1512} * CHANGED: [styles/prosilver/template/index_body.html] (hash: f4e8fe3cec80919fb78ac2e5449752bf)
{2: 210} NOTICE : [vendor/autoload.php] has the phpBB.de hash
{2: 211} NOTICE : [vendor/composer/autoload_real.php] has the phpBB.de hash
{2: 212} NOTICE : [vendor/composer/autoload_static.php] has the phpBB.de hash
{2: 213} NOTICE : [vendor/composer/installed.php] has the phpBB.de hash
--------------------------------------------------------------------------------------------------------
Checked files: 4021
Missing files: 1
Changed files: 2
Notices : 4
Finished! Run time: 0.324 seconds
- In den geschweiften Klammern wird zuerst die Nummer der Prüfsummen-Datei aufgeführt: 1 = phpBB.com, 2 = phpBB.de. Dann folgt hinter dem Doppelpunkt die Zeilennummer in der Prüfsummen-Datei, durch die die Meldung ausgelöst wurde.
Die Angaben in den geschweiften Klammern sind lediglich eine Randinformation und für die Auswertung der Meldungen nicht relevant.
- Danach folgt der Meldungstyp:
! MISSING
= Datei fehlt.! WARNING
= Verschiedene Warnungen in Bezug auf phpBB Dateien.* CHANGED
= Datei geändert (oder beschädigt).NOTICE
= Verschiedene Hinweise in Bezug auf phpBB Dateien.~ ERROR
= Fehler die bei der Ausführung von File Check auftreten können.
- IGNORED
= Datei wurde aufgrund einer Ignorieren-Regel von der Prüfung ausgeschlossen.- EXCEPTION
= Datei wurde aufgrund einer Ausnahme-Regel von der Prüfung ausgeschlossen.
Der Debug-Modus kommt nur in Sonderfällen zum Einsatz. - In den eckigen Klammern wird der vollständige Dateiname angezeigt.
- In runden Klammern wird bei geänderten Dateien der berechnete MD5 Hash angezeigt.
File Check steht am Ende dieses Beitrags als Anhang zum Download zur Verfügung. Zusätzlich wird noch das passende Prüfsummen-Paket benötigt, welches in der aktuellen Version in unserem Download Bereich unter phpBB-Pakete beim Punkt "Prüfsummen-Paket" zu finden ist.
Bei älteren phpBB Versionen, findet man das passende Prüfsummen-Paket im Paketarchiv, dort sind Prüfsummen-Pakete ab phpBB 3.2.0 verfügbar. Die Prüfsummen-Pakete haben das Dateimuster
phpBB-x.y.z-deutsch-FileCheck-MD5.zip
. Wenn man sich im Paketarchiv im richtigen Ordner befindet, kann man den Browser nach "FileCheck" suchen lassen, in vielen Browsern geht das mit Strg+F.- In das Foren-Root müssen folgende Dateien hochgeladen werden, also dorthin, wo auch
config.php
ist.filecheck.php
filecheck_x.y.z.md5
filecheck_x.y.z_diff.md5
filecheck_exceptions.txt
x.y.z
muss zur vorhandenen phpBB Version passen. - Sofern möglich: Dann ruft man im Forum am besten zuerst den Index (Foren-Übersicht) auf.
- Sofern möglich: Anschließend im Adressfeld des Browsers den Teil
index.php
und alles rechts davon entfernen. Stattdessen gibt manfilecheck.php
ein. - Schlussendlich hat man also in etwa das im Adressfeld stehen:
https://meinforum.de/filecheck.php
oderhttps://meineseite.de/forum/filecheck.php
. Dann einfach mit Enter ausführen. - Nachdem der Bericht vollständig erzeugt wurde, kann dieser mit dem Button "Copy report to clipboard" direkt in die Zwischenablage kopiert werden.
Das Tool stellt keinerlei Risiko bezüglich Sicherheit dar, weil es keine Benutzereingaben verarbeitet, keine Schreibzugriffe ausführt und auch keine sensiblen Informationen anzeigt. Trotzdem sollten die Dateien von File Check wieder vom Server entfernt werden, wenn das Tool nicht mehr benötigt wird, da es während der Ausführung tausende Lesezugriffe ausführt und auch rechenintensiv ist. Wenn die Dateien von File Check auf dem Server verbleiben, dann besteht die Gefahr, dass das Tool eventuell von Suchmaschinen indiziert und dann regelmäßig frequentiert wird, wodurch die Leistung des Forums unnötig reduziert wird. Auf jeden Fall sollte mindestens die Datei
filecheck.php
gelöscht werden, damit das Tool nicht mehr ausgeführt werden kann.6. Sonstiges
Das Tool kann hier diskutiert werden.
Die bisherigen Änderungen am Tool können im Changelog auf GitHub nachgelesen werden.
7. Download
Vorherige kumulierte Downloads: 154