Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Integritätsprüfungen für ein Bundle

Wie ein Bündler nachweist, dass die Exponential-Dateien in einem Bundle die veröffentlichten sind - das Dateimanifest share/filelist.md5, bin/php/checkmanifest.php und seine Optionen, die Dateikonsistenzprüfung der…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/bundlers/integrity-checks.md

On this page

This page is a translation. Read the English original

Integritätsprüfungen für ein Bundle

Diese Seite richtet sich an Bündler, die zeigen und prüfen möchten, dass das Exponential in ihrem Bundle unverändert ist, und an Supportteams, die wissen müssen, ob eine Website im Einsatz es noch ist.

Inhalt

  1. Das Dateimanifest
  2. checkmanifest.php
  3. Die Prüfung in der Administration
  4. Erweiterungen mit eigenem Manifest
  5. Prüfsummen dessen, was Sie herunterladen und ausliefern
  6. Beabsichtigte Änderungen

Das Dateimanifest

share/filelist.md5 führt "md5 path" für jede Datei der Distribution auf; "die System-Upgrade-Prüfung der Administrationsoberfläche vergleicht die Dateien damit, sodass ein veralteter Eintrag dort als geänderte Datei erscheint" (bin/php/checkmanifest.php, Kopf). Die eingebaute Hilfe verwendet es in einer Installation ohne .git auch als Dateiliste (Mitzuliefernde Dokumentation).

checkmanifest.php

Das Skript "braucht keinen Kernel und keine Datenbank", es läuft also in jedem Build-Schritt:

BefehlTut
php bin/php/checkmanifest.php --alljeder Eintrag existiert und hat seine Prüfsumme; Git-Dateien, die im Manifest fehlen, Zeilen außer der Reihe und fehlerhafte Zeilen sind Warnungen
php bin/php/checkmanifest.php --all --extensionsprüft außerdem die share/filelist.md5, die jede Erweiterung mitbringen kann
php bin/php/checkmanifest.php --all --csvdie Befunde als CSV, "dieselben Spalten wie der Download der Upgrade-Prüfung"
php bin/php/checkmanifest.php --stageddie für den nächsten Commit vorgemerkten Dateien (für die Entwicklung)
php bin/php/checkmanifest.php --fixschreibt veraltete Prüfsummen neu, ergänzt fehlende Dateien, entfernt gelöschte

"Exit-Code 0, wenn alles übereinstimmt, sonst 1." Führen Sie --all auf dem gebauten Bundle aus und halten Sie das Ergebnis im Build-Protokoll fest (Lock-Dateien und reproduzierbare Builds).

Hinweis --fix passt das Manifest an Ihre Dateien an. Bei einem Bundle würde das Ihre Änderungen vor der Upgrade-Prüfung des Empfängers verbergen. Verwenden Sie es nur in einem Repository, das Sie pflegen, nie, um ein verändertes Bundle "bestehen" zu lassen.

Die Prüfung in der Administration

Setup > System Upgrade > Überprüfe Dateikonsistenz in der Administration vergleicht die Installation mit dem Manifest und listet jede Zeile, die nicht mehr übereinstimmt, als geänderte Datei auf (Metadaten von Erweiterungen: Dateimanifest). Empfänger und Supportmitarbeiter können sie jederzeit ausführen; der CSV-Download hat dieselben Spalten wie --csv.

Erweiterungen mit eigenem Manifest

Einige Erweiterungen liefern eine eigene share/filelist.md5 aus (zum Beispiel cjw_newsletter). Eine solche Erweiterung frischt ihr Manifest "im selben Release wie jede Dateiänderung" auf, sonst listet die Prüfung ihre Dateien als geändert. Prüfen Sie sie mit --all --extensions. Wenn Sie Erweiterungen mit einem Manifest veröffentlichen, halten Sie es aktuell (Erweiterungs-Bundles).

Prüfsummen dessen, was Sie herunterladen und ausliefern

ElementQuelle der Prüfsumme
Release-Dateien von VelocitySHA256SUMS im Release (Velocity-Pakete)
FrankenPHP-Binärdateiexp:velocity install prüft einen festgelegten SHA-256 (FrankenPHP)
SeitenpaketeIhre eigene Aufzeichnung jeder .ezpkg; Pakete können sich auf dem öffentlichen Server an Ort und Stelle ändern
Die Artefakte Ihres Bundlesveröffentlichen Sie mit jedem Release eine eigene SHA256SUMS

Beabsichtigte Änderungen

Ein Bundle, das Kernel-Dateien ändert, zeigt diese Dateien für immer als geändert an. Ziehen Sie vor:

  1. eine Einstellung oder ein Override-Template in Ihrer eigenen Erweiterung;
  2. ein zweites Erweiterungsverzeichnis für Ihren Code (Zusätzliche Erweiterungsverzeichnisse);
  3. die Änderung beim Projekt einzureichen (Korrekturen zurückgeben).

Ist eine Kernel-Änderung unvermeidlich, führen Sie sie in Ihren Release-Hinweisen auf, damit die Dateikonsistenzprüfung eines Empfängers nachvollziehbar bleibt.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x