Update-Bereitschaftsprüfung

Sie wählen die Zielversion, von der nächsten Hauptversion bis 24.0, und die nach dem Update vorgesehene PHP-Version. Sie klicken auf Prüfung starten. Das Modul liest Ihre Installation, ohne etwas zu verändern, und liefert einen Bericht.

Der Code Ihrer externen Module

Das ist der Hauptteil des Moduls. Der Code jedes externen Moduls wird Datei für Datei gelesen, ohne ausgeführt zu werden, und mit den Änderungen jeder Version auf dem Weg abgeglichen, nicht nur mit der Zielversion:

• entfernte Funktionen, Klassen, Methoden, Eigenschaften, Konstanten und Dateien des Kerns;
• überschriebene Methoden, die mit denen von Dolibarr inkompatibel geworden sind;
• Aufrufe mit weniger Argumenten, als Dolibarr jetzt verlangt;
• entfernte Spalten und Tabellen in den SQL-Abfragen des Moduls;
• Hooks und Trigger-Ereignisse, die nicht mehr aufgerufen werden;
• Funktionen, Konstanten und Syntax, die das vorgesehene PHP ablehnt.

Jeder Befund nennt die Datei, die Zeile, die Version, ab der es nicht mehr funktioniert, einen Grad an Gewissheit und, falls bekannt, den Ersatz. Jedes Modul erhält eine Abdeckungsquote: den Anteil der tatsächlich geprüften Aufrufe. Verschlüsselter Code (ionCube, SourceGuardian, Zend Guard) wird als nicht prüfbar gemeldet.

Die neun weiteren Prüfgruppen

Der Bericht

Er beginnt mit einer Antwort in einer Zeile — bereit, fast bereit oder noch nicht bereit —, dann folgen die höchste Version, die Sie ohne Änderungen erreichen, der Weg Schritt für Schritt und der Plan in der richtigen Reihenfolge. Er sagt auch, ob die installierte Version und die Zielversion noch Sicherheitskorrekturen erhalten, was zu sichern ist und welcher Schritt die meisten Daten neu schreibt.

Jeder Befund hat eine Stufe — ohne Problem, zu prüfen, blockierend oder nicht prüfbar — mit dem, was zu tun ist, und der Quelle der Regel.

Der Bericht lässt sich als HTML oder Markdown herunterladen. Die Option anonymisieren verbirgt Domain, Pfade, Firmennamen und Benutzernamen. Für jedes betroffene Modul erzeugt die Schaltfläche Bericht für den Herausgeber eine Datei zum Weiterleiten: Dateien, Zeilen, bekannte Korrektur, nichts über Ihr Unternehmen oder Ihren Server.

Was der Bericht nicht garantieren kann

Der Bericht sagt es selbst, unten auf der Seite: Er verringert bekannte Risiken, garantiert aber nicht den Erfolg des Updates. Er beweist nicht, dass ein externes Modul funktionieren wird — das kann nur ein Test auf einer Kopie —, sieht weder Fehler der Zielversion noch das Verhalten der Migrationsskripte gegenüber Ihren Daten voraus und prüft nicht, ob sich eine Sicherung wiederherstellen lässt.

Die Codeanalyse ist zeitlich begrenzt: insgesamt 60 Sekunden, höchstens 30 Sekunden pro Modul. Dateien über 2 MB sowie die Ordner vendor, node_modules und includes der Module werden nicht gelesen, und der Bericht meldet das. Die Zielversionen enden bei 24.0: Die Referenzdaten des Moduls haben den Stand vom 25. September 2026.

Das Werkzeug liegt unter StartAdmin-ToolsUpdate-Bereitschaftsprüfung. Die folgenden Bildschirmfotos wurden mit der französischen Oberfläche aufgenommen.

Der Bericht einer Testinstanz auf 18.0.9 mit Ziel 24.0: „Pas encore prêt : 1 action(s) avant de monter“ (Noch nicht bereit: 1 Maßnahme(n) vor dem Update). Das fiktive Modul DemoFutur funktioniert ab 20.0 nicht mehr, also ist der Weg bis 19.0.4 ohne Änderungen möglich. Darunter: die Zeile zur Sicherheit — 18.0 erhält keine Korrekturen mehr —, der Weg von 18.0 bis 24.0 und der Plan: beim Herausgeber eine kompatible Version besorgen, dann auf 18.0.10 wechseln und Schritt für Schritt aktualisieren.

Die Startmaske: die Zielversion 24.0 (24.0.1), das nach dem Update vorgesehene PHP und das Feld „Intégrité des fichiers du cœur“ (Integrität der Kerndateien).

Der Block „Vos modules“ (Ihre Module). Bei DemoFutur eine in 20.0 entfernte Klasse und eine in 23.0 entfernte Funktion, mit Datei, Zeile und Ersatz, „code analysé à 100 % (2 appels vérifiés sur 2)“ (Code zu 100 % analysiert, 2 von 2 Aufrufen geprüft) und die Schaltfläche „Rapport pour l’éditeur“ (Bericht für den Herausgeber). DemoCasse, inaktiv und inkompatibel, ist zu löschen.

• Nur für Administratoren. Das Menü und jede Seite prüfen, ob der Benutzer Dolibarr-Administrator ist; jeder andere Benutzer erhält „Zugriff verweigert“. Das Modul hat kein eigenes Recht.
• Rein lesend. Die Prüfung schreibt nichts, weder in die Datenbank noch auf die Festplatte. Bei den Tests wurde vor und nach einer Prüfung ein vollständiger Fingerabdruck der Datenbank und der Dateien erstellt: Er war identisch.
• Anti-CSRF-Token bei jeder Aktion: Prüfung, Downloads, Bericht für den Herausgeber.
• Kein Geheimnis wird angezeigt oder exportiert. Für conf.php meldet das Modul nur, ob ein Schlüssel vorhanden ist, nie seinen Wert.
• Kein Befehl wird ausgeführt. Reparaturen, etwa das Vereinheitlichen der Tabellenkodierung, werden genannt, nie ausgeführt.
• Nur eine mögliche Verbindung. Das Feld „Integrität der Kerndateien“ ist nur dann vorab angekreuzt, wenn die offizielle Signatur Ihrer Version bereits in install/ liegt: Der Vergleich läuft dann ohne Netzwerk. Andernfalls bleibt es leer, und erst das Ankreuzen erlaubt den Download der Signatur von dolibarr.org. Ohne Häkchen verbindet sich das Modul mit nichts.

• Der Ordner dolixmaj, im Klartext, unter der Lizenz GPL v3 oder später: die Seite des Werkzeugs, eine Info-Seite ohne Einstellungen, die Klassen für Prüfung und Codeanalyse sowie die Dolibarr-Referenzdaten 16.0 bis 24.0.2 (data/).
• Die in langs/ vorhandenen Übersetzungen: Französisch (fr_FR), Englisch (en_US) und Deutsch (de_DE).
• Eine README.md und ein ChangeLog.md.
• Mindestens Dolibarr 16.0, mindestens PHP 7.0, MySQL/MariaDB und PostgreSQL. Installiert und ausgeführt auf 16.0.5, 17.0.4, 18.0.9, 18.0.10, 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.0, 24.0.1 und 24.0.2.

• Es wird keine Tabelle angelegt und keine Einstellung gespeichert. Nur die Aktivierung des Moduls speichert, wie bei jedem Modul, seinen Status und seinen Menüeintrag.
• Auf dem Server wird nichts aufbewahrt: Der Bericht wird bei jeder Anfrage neu berechnet, Downloads werden direkt erzeugt.
• Heruntergeladene Berichte bleiben auf Ihrem Rechner. Anonymisiert enthalten sie weder Domain noch Pfade, Firmennamen oder Benutzernamen.
• Beim Deaktivieren verschwindet der Menüeintrag. In der Datenbank ist nichts aufzuräumen.