Einstellungen des Paketservers #

Diese Seite ist für Administratoren und Entwickler, die eine Installation auf einen Paketserver richten oder abstimmen, wie sie herunterlädt. Sie führt jeden Schlüssel von settings/package.ini [RepositorySettings] in 6.0.15 mit seinem Standard auf, sagt, welcher Code ihn liest, und ergänzt die zwei Einstellungen aus site.ini, die dazugehören.

Inhalt #

1. Die Schlüssel auf einen Blick
2. RemotePackagesIndexURL
3. RemotePackagesIndexURLBase
4. Weitere Paketserver
5. Vendor und RepositoryDirectory
6. Die Einstellungen für das Herunterladen
7. Einstellungen in site.ini, die dazugehören
8. Die Einstellungen überschreiben
9. Verwandte Seiten

Die Schlüssel auf einen Blick #

# settings/package.ini (6.0.15)
[RepositorySettings]
RepositoryDirectory=packages
RemotePackagesIndexURL=https://exponential.packages.exponential.earth/exponential/6.0/6.0.15
RemotePackagesIndexURLBase=https://exponential.packages.exponential.earth/exponential
AdditionalRemotePackagesIndexURLs[]
RemotePackagesIndexSources[]
RemotePackagesIndexSources[]=ezupdate.ini;PackageServerSettings;Servers
Vendor=7x
DownloadAttempts=3
DownloadRetryDelays[]
DownloadRetryDelays[]=2
DownloadRetryDelays[]=5
DownloadRetryDelays[]=10
DownloadTimeout=300
DownloadConnectTimeout=30

RemotePackagesIndexURL #

Die Adresse eines Release-Ordners, ohne index.xml. eZStepSiteTypes hängt /index.xml an (oder index.xml, wenn der Wert auf / endet). Die Adressen der Pakete selbst kommen aus den Attributen url in diesem Index, sodass sie auf einem anderen Host liegen dürfen.

Jedes Release von Exponential ändert diesen Wert in seiner package.ini auf seinen eigenen Ordner; die Geschichte des Schlüssels steht in Geschichte des Paketservers. Die URL darf für den Setup-Assistenten https:// oder http:// nutzen; ezupdate akzeptiert nur https://.

Derselbe Wert wird, nur lesbar, als erster Server auf der Seite Package servers von ezupdate gezeigt und ist der Standard von exp:ezwebininstall, wenn dessen Option --url nicht angegeben ist (kernel/private/classes/commands/ezwebininstall.php).

RemotePackagesIndexURLBase #

Genutzt, wenn RemotePackagesIndexURL leer ist. Der Konstruktor von eZStepSiteTypes baut dann:

<RemotePackagesIndexURLBase>/<major>.<minor>/<version>/index.xml

mit <major>.<minor>/<version> aus ExponentialSDK::packageServerPath(): 6.0/6.0.15 für dieses Release, mit angehängtem Release-Zustand nur für ein Release, das nicht stabil ist (6.0/6.0.16alpha1).

Hinweis In 6.0.15 behoben. Vorher rief der Rückfall ExponentialSDK::version() mit seinen Standards auf, die den Release-Zustand anhängen: Das Ergebnis war 6.0/6.0.15stable/, ein Ordner, den der Server nicht hat (er antwortete mit 404). Ab 6.0.15 baut der Setup-Assistent 6.0/6.0.15/, den Ordner, den der Paketserver hat, und ebenso ezupdate (eZUpdatePackageServers::builtinIndexURL()) ab seinem Release, das mit 6.0.15 ausgeliefert wird. RemotePackagesIndexURL auf den gewünschten Release-Ordner zu setzen, bleibt die klarste Wahl.

Der Schritt Site Paket verlinkt außerdem das vollständige Archiv aller Pakete mit diesem Wert.

Weitere Paketserver #

Ab 6.0.15 lesen der Setup-Assistent, der Kickstarter und exp:install (alle drei lesen den Index über eZStepSiteTypes::retrieveRemotePackagesList()) mehr als einen Server:

[RepositorySettings]
# folders with an index.xml, read after RemotePackagesIndexURL
AdditionalRemotePackagesIndexURLs[]
AdditionalRemotePackagesIndexURLs[]=https://packages.example.com/exponential/6.0/6.0.15
# lists of servers kept in other settings files: <file>.ini;<block>;<setting>, an array of <name>=<URL>
RemotePackagesIndexSources[]
RemotePackagesIndexSources[]=ezupdate.ini;PackageServerSettings;Servers

• Der Hauptserver (RemotePackagesIndexURL oder seine Offline-Kopie) kommt zuerst. Ein Paket, das ein früherer Index aufführt, wird behalten, wie es ist; ein weiterer Server fügt nur die Pakete hinzu, die die früheren nicht haben.
• Die Standardquelle ist die Liste der Seite Package servers von ezupdate (Paketserver in ezupdate), geführt in settings/override/ezupdate.ini.append.php. Leeren Sie RemotePackagesIndexSources[] in einer Überschreibung, um nur die in package.ini genannten Server zu lesen.
• Nur Adressen http:// und https:// werden gelesen, jede einmal. Ein weiterer Server, der sich nicht lesen lässt, wird mit einer Warnung in der Debug-Ausgabe übersprungen; der Schritt zeigt einen Fehler nur für den Hauptserver.
• Eine Anforderung wird von dem Server heruntergeladen, der sie aufführt, sodass ein Seitenpaket auf einem Server Pakete eines anderen verlangen darf.

Vendor und RepositoryDirectory #

Pakete werden in var/<StorageDir>/<RepositoryDirectory>/<vendor>/<name>/ gespeichert, was mit den Standards var/storage/packages/7x/<name>/ ist. Ein importiertes Paket geht in den Ordner, den sein eigener <vendor> nennt; auf der Installation erstellte Pakete gehen nach local/. Vendor nennt das System-Repository, in dem der Setup-Assistent nach einer Offline-index.xml sucht (var/storage/packages/7x/index.xml). Siehe Das lokale Paket-Repository und Offline-Installationen und Spiegel.

Die Einstellungen für das Herunterladen #

In 6.0.15 hinzugefügt (Changelog, Eintrag vom 6. Oktober 2026 zum Paketdownload des Setups). Sie gelten für den Index und für jedes Paket, das das Setup herunterlädt.

• DownloadAttempts: mindestens 1. Ein Versuch scheitert bei einem Übertragungsfehler, einem HTTP-Status außer 200, einer leeren oder abgeschnittenen Datei oder einer .ezpkg, die keine gzip-Daten ist; ein gescheiterter Versuch hinterlässt keine Datei.
• DownloadRetryDelays[]: Die Wartezeit vor Versuch 2 ist der erste Wert, vor Versuch 3 der zweite und so weiter; der letzte Wert gilt für alle späteren Versuche. Mit den Standards (3 Versuche) sind die Wartezeiten 2 und 5 Sekunden; die 10 wird genutzt, wenn Sie DownloadAttempts erhöhen.
• DownloadTimeout: die Grenze für die ganze Übertragung, mit curl und ohne.
• DownloadConnectTimeout: die Grenze für das Öffnen der Verbindung, mit curl.

Ein leerer Wert bedeutet den eingebauten Standard (dieselben Zahlen). Fehlschläge, die durch Warten nicht besser werden, etwa ein Cache-Ordner, der sich nicht beschreiben lässt, werden nicht wiederholt. Was Sie sehen, wenn alle Versuche scheitern: Wenn der Paketserver nicht erreichbar ist.

Einstellungen in site.ini, die dazugehören #

[ProxySettings]
ProxyServer=
User=
Password=

[FileSettings]
StorageDir=storage

ProxyServer (mit User und Password, wenn der Proxy sie braucht) wird für die Downloads des Setups über curl genutzt und von ezupdate. StorageDir ist Teil des Repository-Pfads oben.

Die Einstellungen überschreiben #

Setzen Sie Änderungen in settings/override/package.ini.append.php, nie in settings/package.ini selbst, das ein Update des Kernels ersetzt:

<?php /* #?ini charset="utf-8"?

[RepositorySettings]
RemotePackagesIndexURL=https://packages.example.com/6.0/6.0.15
DownloadAttempts=5

*/ ?>

Der Setup-Assistent läuft, bevor irgendein Siteaccess existiert, sodass eine Überschreibung in einem Siteaccess auf ihn keine Wirkung hat; nutzen Sie settings/override/. Leeren Sie nach der Änderung den INI-Cache (php bin/php/ezcache.php --clear-tag=ini). Wie Sie eine Website auf Ihren eigenen Server richten, einschließlich der Liste von ezupdate und kickstart.ini, steht in Eine Website auf Ihren Paketserver richten.

Verwandte Seiten #

• Seitenpakete: hier beginnen
• Der Paketserver
• Das Format index.xml
• Offline-Installationen und Spiegel
• Paketserver in ezupdate
• Eine Installationsmethode wählen, 4.3 Seitenpakete
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.