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

Ein Paket importieren

Ein Archiv .ezpkg unter Setup > Pakete > Neues Paket importieren hochladen - was geprüft wird, bevor irgendetwas geschrieben wird, in welchem Repository das Paket landet, was danach geschieht, die Grenzen für Uploads…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/site-packages/admin-gui/importing-a-package.md

On this page

This page is a translation. Read the English original

Ein Paket importieren

Diese Seite ist für Administratoren, die ein Paketarchiv von ihrem Computer in eine Installation bringen: ein von einem Paketserver heruntergeladenes Paket, eines, das ein Kollege geschickt hat, oder eines, das von einer anderen Website exportiert wurde. Importieren legt das Paket ins lokale Paket-Repository; es installiert es nicht.

Paket importieren: eine .ezpkg-Datei hochladen
Paket importieren: eine .ezpkg-Datei hochladen

Inhalt

  1. Vor dem Hochladen
  2. Hochladen
  3. Was geprüft wird
  4. Wo das Paket landet und was folgt
  5. Die Grenzen
  6. Wenn der Import abgewiesen wird

Vor dem Hochladen

  • Sie brauchen die Richtlinie package/import; ohne sie sagt die Schaltfläche „Sie dürfen keine Pakete importieren (package/import).“
  • Ein Seitenpaket wird nicht von hier aus genutzt: Der Setup-Assistent, der Kickstarter und exp:install installieren Seitenpakete, wenn eine Website angelegt wird. Laden Sie ein Seitenpaket hier nur hoch, um es anzusehen, zu vergleichen oder für eine Offline-Installation aufzubewahren.
  • Pakete auf einem Paketserver kann ezupdate direkt abrufen (Pakete mit ezupdate abrufen).

Hochladen

  1. Setup > Pakete, dann Neues Paket importieren (/package/upload).
  2. Wählen Sie die Datei unter Paketdatei: „Ein .ezpkg-, .tar.gz- oder .tgz-Archiv von höchstens %size. Der Server nimmt Uploads von höchstens %server an.“
  3. Drücken Sie Importiere Paket. Abbrechen führt zur Liste zurück.

Was geprüft wird

Bevor irgendetwas entpackt wird, liest eZPackageUploadInspector das Inhaltsverzeichnis des Archivs und seine package.xml; die Seite führt die Regeln unter Was zuerst geprüft wird auf:

RegelText auf der Seite
mit gzip komprimiertes tar mit erlaubtem Namen„Die Datei ist ein gzip-komprimiertes tar-Archiv mit einem der erlaubten Namen.“
Größengrenze„Es ist nicht zu groß.“
Einträge und entpackte Größe„Es hat höchstens %entries Einträge, die zu höchstens %size entpackt werden.“
sichere Einträgejeder Eintrag ist eine einfache Datei oder ein Verzeichnis im Paket: kein .., kein absoluter Pfad, kein Link, kein Gerät
Definition und Name„Es hat eine wohlgeformte package.xml mit einem gültigen Paketnamen, und es gibt noch kein Paket dieses Namens: Ein vorhandenes Paket wird nie überschrieben.“

Dann läuft die eigene Validierung des Pakets auf einer entpackten Kopie in einem Arbeitsverzeichnis (das wieder entfernt wird): jedes Dokument wohlgeformt und bei einem JSON-Paket das Schema und die Prüfsummen von package.json. Ein Paket, das scheitert, wird mit der Liste dessen abgewiesen, was gescheitert ist (die Meldung sagt, dass es die Validierung nicht bestanden hat und nicht importiert wurde).

Dieselben Prüfungen des Archivs laufen in eZPackage::import(), sodass ezpm import, das Abrufen von ezupdate und das eigene Hochladen im Setup-Assistenten dieselben Archive abweisen.

Wo das Paket landet und was folgt

Das Paket wird in das Repository entpackt, das sein <vendor> nennt, in einen Verzeichnisnamen umgewandelt: Ein Paket von 7x geht nach var/storage/packages/7x/, ein Paket ohne Hersteller nach local/. Dann:

PaketNächste Seite
hat Installationselemente (install_type="install") und Sie dürfen es installierendie Installationsseite (/package/install/<name>) mit dem Ergebnis der Validierung
alles andere, einschließlich Seitenpaketen (install_type="import")die Seite des Pakets

Nichts wird installiert, bis Sie dort Paket installieren drücken (Installieren und Deinstallieren).

Die Grenzen

# settings/override/package.ini.append.php (the values shown are the defaults)
[UploadSettings]
MaxArchiveSize=268435456
MaxUnpackedSize=2147483648
MaxEntries=50000
AllowedSuffixes[]
AllowedSuffixes[]=ezpkg
AllowedSuffixes[]=tar.gz
AllowedSuffixes[]=tgz

Das sind 256 MiB pro Archiv, 2 GiB entpackt und 50000 Einträge. upload_max_filesize und post_max_size von PHP gelten zuerst; die Seite zeigt die Grenze des Servers. Für ein Archiv darüber kopieren Sie es auf den Server und nutzen php ezpm.php import <file>, das dieselben Prüfungen ausführt.

Wenn der Import abgewiesen wird

MeldungBedeutetWas zu tun ist
„Es wurde keine Datei hochgeladen, oder sie war größer, als der Server annimmt (%size).“die Upload-Grenze von PHPdie Grenzen von PHP erhöhen oder ezpm import nutzen
„Paket %packagename existier bereits, kann Paket nicht importieren“ein Paket dieses Namens liegt in irgendeinem Repositoryzuerst das alte entfernen (Die Paketliste und die Paketseite) oder stattdessen damit vergleichen
„Der Paketname %packagename ist ungültig, konnte das Paket nicht importieren“der Name enthält andere Zeichen als a-z, 0-9 und _<name> in package.xml korrigieren und neu bauen
ein Eintrag zeigt aus dem Paket hinaus oder ist ein Link oder ein Gerätdas Archiv enthält unsichere Pfade oder Linksdas Archiv aus dem Paketordner neu bauen
die Paketdefinition ist nicht wohlgeformtpackage.xml ist kaputtxmllint --noout package.xml
das Paket hat die Validierung nicht bestanden und wurde nicht importiertein Dokument oder eine Prüfsumme ist gescheitertdie Liste unter der Meldung nennt jedes Problem

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