Diskussion zu "phpBB File Check"

[LukeWCS]

Hier kann das Tool diskutiert werden.

[LukeWCS]

Die Archive sind direkt im Beitrag als Anhang zu finden und Anhänge werden doch sicher auch in deinem Forum genutzt, das sollte dir also doch eig. vertraut vorkommen.

Vertraut ist mir das schon... mich hat nur die Zeile mit "Vorherige kumulierte Downloads: 80" etwas stutzig gemacht.
Ich wusste nicht, dass ich die anklicken muss

Das ist mir jetzt unklar, kannst du das bitte mal erklären, was du damit meinst? Der Text auf den du dich beziehst, ist nur ein simpler Text der über die früheren Downloads informiert. Diesen Text kann man aber nicht anklicken, der hat keine Funktion.

Bitte mal erklären, was genau da unklar ist. Wenn da was unverständlich ist, muss ich erstmal verstehen, wo genau es im Detail klemmt.

Dieser Teil:

da zu einem späteren Zeitpunkt zumindest die notwendigen MD5-Dateien nicht mehr hier im Thema zu finden sind, sondern bei den Paket Downloads. Bis dahin gibt es die MD5 Dateien hier im Thema.

Ich weiß nicht mal was MD1-Dateien sind - da bin ich mit MD5 schon etwas überfordert...

Hmm okay, das ist dann wohl zuviel Info. ^^ MD5 ist ein Prüfsummenverfahren das in vielen Bereichen der IT eingesetzt wird. Aber um die Anleitung erfolgreich umsetzen zu können, ist diese Info eigentlich überflüssig.

Statt:

Die Dateien von File Check sind auf 2 Archive verteilt, da zu einem späteren Zeitpunkt zumindest die notwendigen MD5-Dateien nicht mehr hier im Thema zu finden sind, sondern bei den Paket Downloads. Bis dahin gibt es die MD5 Dateien hier im Thema.

Nur noch:

Die Dateien von File Check sind auf 2 Archive verteilt, die am Ende dieses Beitrags als Anhang zum Download zur Verfügung stehen.

So besser verständlich?

[Scanialady]

ganz bestimmt.

[Mike-on-Tour]

Passt so.
Aber das muss jetzt nichts bedeuten, ich hatte das andere ja auch schon verstanden (nichts für ungut an diejenigen, die es nicht verstanden haben, als Programmierer sehe ich das aus einem anderen Sichtwinkel).

[c64persian]

Dieser Text wurde von Google von Farsi auf Deutsch übersetzt, wenn ich mich irre

Hallo
Dateiprüfungs -Tools sind sehr nützlich und ich danke Ihnen, dass Sie es geschafft haben
Dieses Tool sollte in der Website enthalten sein.
Ist es für uns möglich, das persische Sprachpaket zu verwenden und wie man MD5 produziert und wie?

Dank

[LukeWCS]

Hello c64persian

Dieser Text wurde von Google von Farsi auf Deutsch übersetzt, wenn ich mich irre

We can also discuss your issue in English if that is easier for you. FC is designed for international use anyway.

I also have questions about your questions because the translation makes a few things unclear to me:

Dateiprüfungs -Tools sind sehr nützlich und ich danke Ihnen, dass Sie es geschafft haben

Thanks for the kind words. FC has helped us supporters several times to locate errors that we would otherwise have had difficulty or not found at all.

Dieses Tool sollte in der Website enthalten sein.

I'm not quite sure what you wanted to say. Do you mean that it should be available on phpBB.com?

Ist es für uns möglich, das persische Sprachpaket zu verwenden und wie man MD5 produziert und wie?

Do you mean 1) a Persian language pack for File Check itself or do you mean 2) whether you can create an MD5 package for a Persian phpBB language pack?

If you mean point 1, it was actually not intended to use a language other than English, for the reason that the reports can be read internationally.

If you mean point 2, yes, that is of course intended and that is exactly what we do here on phpBB.de. The checksum package contains the MD5 file for phpBB.com and an MD5 file for our German language packages, so that everything is checked, not just the original phpBB core.

For point 2 we use "phpBB File Check hash Generator". However, the tool is not designed for end users or supporters, but for the administrators of the national support sites. This means that in order to create a Persian checksum package, the administrator of php-bb.ir would have to set it up, because that is where the Persian complete packages and language packages are created.

There is already a GitHub page for the generator, but no instructions yet, as we are currently the only official phpBB support site that offers phpBB File Check.

[c64persian]

I'm not quite sure what you wanted to say. Do you mean that it should be available on phpBB.com?

yes

Do you mean 1) a Persian language pack for File Check itself or do you mean 2) whether you can create an MD5 package for a Persian phpBB language pack?

If you mean point 1, it was actually not intended to use a language other than English, for the reason that the reports can be read internationally.

If you mean point 2, yes, that is of course intended and that is exactly what we do here on phpBB.de. The checksum package contains the MD5 file for phpBB.com and an MD5 file for our German language packages, so that everything is checked, not just the original phpBB core.

For point 2 we use "phpBB File Check hash Generator". However, the tool is not designed for end users or supporters, but for the administrators of the national support sites. This means that in order to create a Persian checksum package, the administrator of php-bb.ir would have to set it up, because that is where the Persian complete packages and language packages are created.

There is already a GitHub page for the generator, but no instructions yet, as we are currently the only official phpBB support site that offers phpBB File Check.

i have made md5 file of persian pack in local computer with hashtool if I put this code with path like de language pack in filecheck_3.3.12_diff.md5 is it true?

[LukeWCS]

Hello

Please only quote the exact text you want to refer to directly. Full quotes are unnecessary and make the overview of a post less clear.

yes

Okay, I have already contacted phpBB.com. I have wanted to do this for months, but something always came up and I have limited time. So your request here was the final trigger for my request to phpBB.com. Whether phpBB.com also wants to offer FileCheck depends primarily on whether the phpBB.com supporters want it.

i have made md5 file of persian pack in local computer with hashtool if I put this code with path like de language pack in filecheck_3.3.12_diff.md5 is it true?

Yes, that's right. I'll try to explain it in more detail, but please remember what I wrote: the hash generator is not intended for end users, the Persian hash packet would have to be generated directly by the administrator of php-bb.ir.

Let's take a look at the contents of the current 3.3.12 checksum package from phpBB.de:

Code: Alles auswählen

filecheck_3.3.12.md5 333776
filecheck_3.3.12_diff.md5 14810
filecheck_exceptions.txt 160

filecheck_3.3.12.md5 contains the primary checksums of the original phpBB.com package.

In filecheck_3.3.12_diff.md5 are the secondary checksums of the national phpBB package, in our case those of the German language package. However, this secondary file differs from the primary file in one respect: This file does not contain all the checksums of the complete national package, but only the difference to the primary file. Both files are then merged during execution.

In filecheck_exceptions.txt, exceptions are defined that refer to folders. This means that certain files are not checked by FC and are not reported if their folder is missing from a phpBB installation. This means that optional components can be defined that do not necessarily have to be present.

For a Persian checksum package, the filecheck_exceptions.txt file should therefore look like this:

Code: Alles auswählen

ext/phpbb/viglink/language/fa/
language/fa/
styles/prosilver/theme/fa/

However, there is an exception, as I have seen. The Persian complete package includes the following additional extension: ext\meis2m\jalali. Is this extension mandatory for a Persian phpBB installation, or only optional?

edit: In the meantime, a colleague has informed me what this extension is all about. According to him, this extension must be included in the Persian phpBB core. In this case, the filecheck_exceptions.txt remains as I have shown it here.

[c64persian]

Hello

Please only quote the exact text you want to refer to directly. Full quotes are unnecessary and make the overview of a post less clear.

Hello

Thank you very much for the information you posted
I also had a request that may not belong here. If possible, enable the English language in the user control panel

[LukeWCS]

I also had a request that may not belong here. If possible, enable the English language in the user control panel

This is not possible at the moment.

Below is an example of creating a Persian checksum packet with FCHG.

I looked around the php-bb.ir forum and if I see it correctly, Meis@M is the administrator there. I also saw that you posted a topic for File Check there. So it would probably be easier for Meis@M if you linked him directly to this post here. If he has any questions, he can ask them directly here.

Example

1. Create a folder with the following structure:

Code: Alles auswählen

config/
    filecheck_exceptions.txt
    filecheck_hashgen_config.php
folder/
    fa/
        adm/
        assets/
        bin/
        ...
zip/
    phpBB-3.3.12.zip
filecheck_hashgen.php

The contents of the folders and files are explained below:

2. The filecheck_exceptions.txt must contain the following:

Code: Alles auswählen

ext/phpbb/viglink/language/fa/
language/fa/
styles/prosilver/theme/fa/

3. The filecheck_hashgen_config.php must contain the following:

Code: Alles auswählen

<?php
/**
*
* phpBB File Check Hash Generator - Creates checksum packages for phpBB File Check
*
* @copyright (c) 2023 LukeWCS <phpBB.de>
* @license GNU General Public License, version 2 (GPL-2.0-only)
*
*/

# phpcs:set VariableAnalysis.CodeAnalysis.VariableAnalysis validUnusedVariableNames config

/*
	The static configuration can be defined here, which does not change with new phpBB versions.
	The dynamic configuration can then be passed via CLI. All config variables have the same name
	as their associated CLI parameters.

	Example:

	config: 'source-1' => ''
	CLI   : --source-1=""
*/

$config = [
/*>
	Primary source (ZIP or folder)
<*/
	'source-1'			=> '',

/*>
	Secondary source (ZIP or folder)
<*/
	'source-2'			=> '',

/*>
	The folder where the finished hash package ZIP will be created.
<*/
	'export-dir'		=> '',

/*>
	The folder within a ZIP, i.e. "phpBB3/". That could possibly change in 4.0.
<*/
	'zip-root'			=> 'phpBB3/',

/*>
	The label of the primary hash package. Required for various displays, including error messages.
	This is also used by "phpBB File Check".
<*/
	'source-1-label'	=> 'phpBB.com',

/*>
	The label of the secondary hash package. Required for various displays, including error messages.
	This is also used by "phpBB File Check".
<*/
	'source-2-label'	=> 'php-bb.ir',

/*>
	Text file in which one RegEx expression can be entered per line.
	This file is only evaluated by "phpBB File Check" and is added to the hash package ZIP.
	The file name in the hash package ZIP is changed to "filecheck_ignore.txt".
<*/
	'ignore-file'		=> '',

/*>
	Text file in which one file/folder exception can be entered per line.
	This file is only evaluated by "phpBB File Check" and is added to the hash package ZIP.
	The file name in the hash package ZIP is changed to "filecheck_exceptions.txt".
<*/
	'exceptions-file'	=> 'config/filecheck_exceptions.txt',

/*>
	The filename of the hash package ZIP to create, i.e. "phpBB_FileCheck_MD5_{PHPBB_VERSION}".
	{PHPBB_VERSION} will be replaced with the phpBB version.
<*/
	'hash-zip-name'		=> 'phpBB_FileCheck_MD5_{PHPBB_VERSION}_fa',

/*>
	For the date display when checking the hash package ZIP.
<*/
	'timezone-id'		=> 'Asia/Tehran',
];

# phpcs:set VariableAnalysis.CodeAnalysis.VariableAnalysis validUnusedVariableNames

4. The fa folder consists of the Persian complete package and the Persian language package.

Actually, FCHG could also work directly with a Persian complete package, i.e. with a ZIP, but unfortunately that doesn't work for 2 reasons:

• In the Persian ZIP, the root path does not correspond to the standard phpBB3.
• The Persian complete package does not contain everything, so a second package is necessary.

For these two reasons, the folder required for FCHG must be created manually as shown here. This means that these files must be unpacked into the fa folder:

http://www.php-bb.ir/dl/phpBB3.3.12.zip
http://www.php-bb.ir/dl/persian_3_3_12.zip

The fa folder must therefore contain exactly the same content as would be the case with a new Persian phpBB installation.

5. phpBB-3.3.12.zip is the original phpBB.com package:

https://download.phpbb.com/pub/release/ ... 3.3.12.zip

The ZIP does not need to be unpacked, FCHG can work directly with this ZIP.

6. filecheck_hashgen.php can be found in the new version 1.0.3 here:

https://github.com/LukeWCS/phpbb-file-check-hash-gen

7. Now everything is prepared and we can run FCHG:

Code: Alles auswählen

php filecheck_hashgen.php --source-1="zip/phpBB-3.3.12.zip" --source-2="folder/fa"

8. If everything has been prepared correctly, the result should look like this:

Code: Alles auswählen

phpBB File Check Hash Generator v1.0.3
======================================

Version primary    : 3.3.12 (phpBB.com) ZIP
Version secondary  : 3.3.12 (php-bb.ir) FOLDER

Checksums primary  : 3861 (phpBB.com) -> filecheck_3.3.12.md5
Checksums secondary: 3982 (php-bb.ir)
Checksums diff     :  121 (php-bb.ir) -> filecheck_3.3.12_diff.md5

Hash package ZIP   : phpBB_FileCheck_MD5_3.3.12_fa.zip (112237 bytes)

Size      Comp.Size  Date       Time      File
-------------------------------------------------------------------
   333776    108439  2024-08-07 17:55:02  filecheck_3.3.12.md5
     8510      3353  2024-08-07 17:55:02  filecheck_3.3.12_diff.md5
       71        57  2024-08-07 17:55:02  filecheck_exceptions.txt
-------------------------------------------------------------------

Finished! Run time: 1.156 seconds

Using this pattern, a new checksum package can then be created for each new phpBB version.

9. Automatic download of the correct checksum package:

FC can automatically download the checksum package from the server from version 1.4.0 onwards. To do this, you must adapt the file filecheck_config.php accordingly. For this to work, a package archive must be available on php-bb.ir, similar to what is available on phpBB.de:

https://downloads.phpbb.de/pakete/deutsch/

This means that checksum packages must be created retrospectively. As far back as desired.