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
- Das Dateimanifest
- checkmanifest.php
- Die Prüfung in der Administration
- Erweiterungen mit eigenem Manifest
- Prüfsummen dessen, was Sie herunterladen und ausliefern
- 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:
| Befehl | Tut |
|---|---|
php bin/php/checkmanifest.php --all | jeder 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 --extensions | prüft außerdem die share/filelist.md5, die jede Erweiterung mitbringen kann |
php bin/php/checkmanifest.php --all --csv | die Befunde als CSV, "dieselben Spalten wie der Download der Upgrade-Prüfung" |
php bin/php/checkmanifest.php --staged | die für den nächsten Commit vorgemerkten Dateien (für die Entwicklung) |
php bin/php/checkmanifest.php --fix | schreibt 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
--fixpasst 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
| Element | Quelle der Prüfsumme |
|---|---|
| Release-Dateien von Velocity | SHA256SUMS im Release (Velocity-Pakete) |
| FrankenPHP-Binärdatei | exp:velocity install prüft einen festgelegten SHA-256 (FrankenPHP) |
| Seitenpakete | Ihre eigene Aufzeichnung jeder .ezpkg; Pakete können sich auf dem öffentlichen Server an Ort und Stelle ändern |
| Die Artefakte Ihres Bundles | verö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:
- eine Einstellung oder ein Override-Template in Ihrer eigenen Erweiterung;
- ein zweites Erweiterungsverzeichnis für Ihren Code (Zusätzliche Erweiterungsverzeichnisse);
- 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
- Eine Kundeninstallation überprüfen
- Ein Bundle testen
- Checkliste für die Bundle-Veröffentlichung
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
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.