Ein Paket vor dem Weitergeben prüfen
Diese Seite ist für Designer, die gleich ein .ezpkg veröffentlichen. Die empfangende Installation untersucht jeden
Upload, bevor sie etwas schreibt; ein Paket, das dort scheitert, scheitert für Ihre Nutzer. Prüfen Sie es zuerst.
Was eine Installation beim Upload prüft
- Der Name endet auf eine erlaubte Endung (
ezpkg,tar.gz,tgz), und die Datei beginnt mit der gzip-Signatur. - Sie liegt innerhalb von
MaxArchiveSize(standardmäßig 256 MiB),MaxEntries(50.000) undMaxUnpackedSize(2 GiB). - Jeder Eintrag ist eine einfache Datei oder ein Verzeichnis mit relativem Pfad: kein
.., kein absoluter Pfad, kein Backslash, kein Steuerzeichen, kein Link, kein Gerät. - Eine wohlgeformte
package.xml(oderpackage.json) liegt oben, mit<package>als Wurzel, einem gültigen Namen, Version und Paketierungsangaben und einem Anbieter, der einen Repository-Namen ergibt. - In keinem Repository gibt es schon ein Paket dieses Namens.
Dann muss jedes Dokument wohlgeformt sein und bei einem JSON-Paket dem Schema und seinen Prüfsummen entsprechen.
Schritt für Schritt
Öffnen Sie auf Ihrer Entwicklungsinstallation die Seite des Pakets und drücken Sie Prüfen. Sie zeigt, was geprüft wurde, oder jedes Problem.
Prüfen Sie auf der Kommandozeile die exportierte Datei selbst:
php ezpm.php validate var/tmp/mytheme_classes-1.0.0-1.ezpkgSehen Sie hinein:
tar tzvf var/tmp/mytheme_classes-1.0.0-1.ezpkg | head -30Jeder Pfad ist relativ und liegt unterhalb des Pakets; keine Einträge
l(Link) in der ersten Spalte.Entpacken Sie die Definition und prüfen Sie sie:
mkdir -p var/tmp/pkgcheck && tar xzf var/tmp/mytheme_classes-1.0.0-1.ezpkg -C var/tmp/pkgcheck xmllint --noout var/tmp/pkgcheck/package.xmlErwartet: keine Ausgabe von
xmllint.Importieren Sie es in eine Wegwerf-Installation (Ihr Paket auf einer Testseite installieren).
Wenn die Prüfung fehlschlägt
| Die Meldung nennt | Abhilfe |
|---|---|
| Einen Pfad außerhalb des Pakets oder einen Link | Erneut mit ezpm export aus dem Paketverzeichnis exportieren |
package.xml nicht wohlgeformt | xmllint darauf ausführen und die genannte Zeile korrigieren |
| „existiert bereits“ (auf der empfangenden Seite) | Der Nutzer entfernt zuerst das alte, oder Sie geben dem Paket einen neuen Namen |
Verwandte Seiten
- Pakete, Abschnitt 6: hochladen
- Klassische XML- und JSON-Pakete
- 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.