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

Abhängigkeiten angeben

Wie ein Seitenpaket die Pakete nennt, die es braucht, das Element require mit type, name und min-version, warum die Liste flach und in Installationsreihenfolge sein muss, was der Setup-Assistent und der Schritt zum…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/site-packages/requirements/declaring-dependencies.md

On this page

This page is a translation. Read the English original

Abhängigkeiten angeben

Diese Seite ist für Entwickler, die ein Seitenpaket aus anderen Paketen bauen: Inhaltsklassen, Demo-Inhalte, Seitenstile, Erweiterungen. Ein Seitenpaket installiert selbst fast nichts; es nennt die Pakete, die die Arbeit machen, und der Setup-Assistent holt und installiert sie. Ein falscher oder fehlender Eintrag hier ist der häufigste Grund, warum eine neue Website nur halb installiert wird. Der allgemeine Mechanismus steht auf Abhängigkeiten und die Installationsreihenfolge; diese Seite behandelt, was Sie schreiben.

Inhalt

  1. Das Element requires
  2. Was der Code damit tut
  3. Regeln, die aus dem Code folgen
  4. Was die ausgelieferten Pakete angeben
  5. Die anderen Abschnitte zu Abhängigkeiten
  6. Fehler und was sie bedeuten
  7. Checkliste
  8. Verwandte Seiten

Das Element requires

<dependencies>
  <provides />
  <requires>
    <require type="ezpackage" name="sevenx_classes" min-version="5.1" />
    <require type="ezpackage" name="sevenx_multisite_democontent" min-version="5.1" />
  </requires>
  <obsoletes />
  <conflicts />
</dependencies>

Das ist das <dependencies> von sevenx_multisite. eZPackage::parseDependencyTree() behält jedes Attribut eines <require>, wie es ist.

AttributBedeutungErzwungen
typeezpackage für ein PaketJa: Der Schritt zum Anlegen der Websites installiert nur Anforderungen type="ezpackage"
nameDer <name> des verlangten PaketsJa: Es wird lokal und in index.xml unter diesem Namen nachgeschlagen
min-versionDie niedrigste annehmbare <number>-<release>Verglichen von eZPackageVersion::compareFull(); der Kickstart-Weg liest sie ohne Rückfall

Was der Code damit tut

  1. Schritt der Seitentypen (eZStepSiteTypes::downloadDependantPackages() in kernel/setup/steps/ezstep_site_types.php). Für jedes <require> des gewählten Seitenpakets: Wenn kein Paket dieses Namens importiert ist oder das importierte älter als min-version ist, wird das alte entfernt und das Paket von der url seines Eintrags in derselben index.xml heruntergeladen und dann importiert.
  2. Kickstart (init() desselben Schritts). Für ein bereits importiertes Seitenpaket prüft er jede Anforderung gegen min-version und bleibt auf dem Schritt, solange eine fehlt oder zu alt ist.
  3. Schritt zum Anlegen der Websites (kernel/setup/steps/ezstep_create_sites.php). In der Reihenfolge von <requires> holt er jedes verlangte Paket; die mit install_type="install" werden installiert, die anderen (Seitenstile) nur gelesen, zum Beispiel für die CSS-Dateien des Seitenstils.
  4. Installation (eZPackage::installUnaudited()). Ein Paket zu installieren installiert zuerst seine eigenen verlangten Pakete, wenn sie im Repository vorhanden sind.
  5. Die Paketseite zeigt Benötigt, mit >= und der min-version, und fehlt für ein Paket, das nicht da ist, sowie Benötigt von aus den Listen der anderen Pakete (kernel/classes/ezpackagecatalog.php).

Regeln, die aus dem Code folgen

Führen Sie jedes Paket direkt auf. Schritt 1 lädt nur die Anforderungen des gewählten Seitenpakets herunter, nicht die Anforderungen dieser Anforderungen. Ein Paket, das die Website braucht, erreicht die Installation nur, wenn das Seitenpaket es nennt oder wenn es vorher importiert wurde.

Reihenfolge ist Installationsreihenfolge. Schritt 3 installiert in der geschriebenen Reihenfolge. Setzen Sie die Inhaltsklassen vor die Inhalte, die sie nutzen, und Erweiterungen vor Inhalte, die ihre Datentypen brauchen.

Jede Anforderung muss auf demselben Paketserver liegen. Eine Anforderung, die nicht importiert ist und keinen Eintrag in der vom Assistenten gelesenen index.xml hat, lässt sich nicht herunterladen (die URL ist unbekannt).

Schreiben Sie min-version in der Form, die das verlangte Paket nutzt. Eine min-version, die höher ist als die Version, die das Paket wirklich hat, lässt den Assistenten es bei jedem Lauf entfernen und erneut herunterladen und blockiert einen Kickstart. Weil die ausgelieferten Pakete Releases wie 15-stable nutzen, erfüllen sie ein min-version="6.0" nicht; siehe Versionsnummern.

Was die ausgelieferten Pakete angeben

In den Quell-Repositorys am 18.10.2026 geprüft. Nur die fünf Seitenpakete haben Anforderungen; keines der Pakete, die sie verlangen, hat welche.

SeitenpaketVerlangt, in Reihenfolgemin-version
sevenx_multisite, sevenx_multisite_cleansevenx_classes, dann das passende Paket sevenx_multisite_democontent5.1
cjw_multisitesevenx_classes, cjw_multisite_democontent5.1
sevenx_siteezwt_extension, ezstarrating_extension, ezgmaplocation_extension, ezpaypal_extension, sevenx_extension, sevenx_classes, sevenx_banners, sevenx_democontent, sevenx_design_cleangray, sevenx_design_gray, sevenx_design_blue5.1, außer 1.0 für ezstarrating_extension, ezgmaplocation_extension und ezpaypal_extension
sevenx_site_clean10 Pakete nach demselben Muster5.1 und 1.0

Alle stehen in der index.xml von 6.0.15. cjw_multisite liegt in einem eigenen Quell-Repository, verlangt aber sevenx_classes aus dem von 7x: Anforderungen gehen frei über Repositorys hinweg, solange der Index beide aufführt.

Die anderen Abschnitte zu Abhängigkeiten

<provides>, <obsoletes> und <conflicts> werden in derselben Form gelesen und geschrieben. Weder der Setup-Assistent noch die Installation handeln nach <obsoletes> oder <conflicts>. <provides> füllen die Paket-Ersteller (zum Beispiel ein Eintrag ezcontentclass pro Klasse), und die Paketseite liest es, um die Klassen aufzulisten, die ein Paket mitbringt. Die ausgelieferten Seitenpakete lassen alle drei leer.

Fehler und was sie bedeuten

MeldungWoUrsache
„Der Download des Pakets '...' ist gescheitert. Sie können das Paket manuell uploaden.“Schritt der SeitentypenDie Anforderung hat keine url in index.xml
„Der Download des Pakets '...' ist nach N Versuchen fehlgeschlagen: ...“Schritt der SeitentypenDie url hat nicht geantwortet; siehe Wenn der Paketserver nicht erreichbar ist
EZSW-050 (Could not fetch required package: '...')Schritt zum Anlegen der WebsitesDie Anforderung liegt nicht im Repository
EZSW-051 (Unable to install package '...')Schritt zum Anlegen der WebsitesDie Installation der Anforderung ist gescheitert

Checkliste

  • To do: Jedes Paket, das die Website braucht, ist ein <require type="ezpackage"> des Seitenpakets selbst.
  • To do: Die Reihenfolge ist zuerst Klassen und Erweiterungen, dann Inhalte, dann Seitenstile.
  • To do: Jeder name ist genau so geschrieben wie der <name> dieses Pakets.
  • To do: Jede min-version wird von der Version erfüllt, die das Paket wirklich hat.
  • To do: Jedes verlangte Paket steht in derselben index.xml, mit funktionierender url.
  • To do: Eine frische Installation in einer Sandbox endet ohne EZSW-050 oder EZSW-051.

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