Den Code für ein Bundle beschaffen #

Diese Seite richtet sich an alle, die den Build eines Bundles schreiben. Die Installationsanleitung dokumentiert drei Wege, den Code zu beschaffen (3.2 Drei Wege zum Code); jeder passt zu einer anderen Art von Bundle.

Inhalt #

1. Die drei Wege
2. Welcher Weg für welches Bundle
3. Build-Befehle
4. Das Ergebnis prüfen
5. Häufige Fehler

Die drei Wege #

Welcher Weg für welches Bundle #

Build-Befehle #

Ein festgelegtes Release, Archive, keine Testwerkzeuge (Weg B):

composer create-project se7enxweb/exponential:v6.0.14 exponential --no-dev

create-project "behandelt die heruntergeladene composer.json als Wurzelpaket, daher gelten ihre config.allow-plugins ... und ihr post-install-cmd-Skript: Am Ende werden die Klassenzuordnungen erzeugt (php bin/php/ezpgenerateautoloads.php). Auf einem Produktionsserver ergänzen Sie --no-dev, das die Testwerkzeuge weglässt" (3.2 B).

Ihr eigenes Projekt (Weg C):

mkdir exponential
cd exponential
composer config allow-plugins.se7enxweb/exponential-legacy-installer true
composer require se7enxweb/exponential
php bin/php/ezpgenerateautoloads.php

Das Paket hat den Typ ezpublish-legacy; das Installer-Plugin legt es im Wurzelverzeichnis des Projekts ab. "Wenn Sie [dem Plugin zu vertrauen] verneinen, landet der Kernel in vendor/se7enxweb/exponential/ und die Erweiterungen ebenfalls in vendor/, wo nichts sie findet." Composer führt nur die Skripte Ihres Wurzelpakets aus, erzeugen Sie die Klassenzuordnungen also selbst.

Hinweis Welches PHP eine Version braucht, entscheidet, ob Composer sie überhaupt installiert: v6.0.8 bis v6.0.14 verlangen PHP ^8.1; die Linie 6.0.15 (main) akzeptiert PHP 8.0. "Kein veröffentlichter Tag akzeptiert PHP 8.0" (3.1). Bauen Sie mit dem PHP, das Ihr Bundle ausliefert.

Das Ergebnis prüfen #

php bin/php/console --version
ls vendor/autoload.php
composer show se7enxweb/exponential

Der erste Befehl nennt die Version (zum Beispiel console (Exponential) 6.0.15stable). "Fehlt vendor/autoload.php, hat Composer nicht fertig gearbeitet; führen Sie composer install erneut aus und lesen Sie die Ausgabe ab dem ersten Fehler" (Das Ergebnis prüfen).

Prüfen Sie danach, was dem PHP Ihres Bundles fehlt:

php bin/php/console exp:velocity ext check

Der Befehl "listet jede Erweiterung auf, die die Installation braucht, markiert, was fehlt, und gibt den Installationsbefehl aus" (Container: Docker und Podman).

Häufige Fehler #

• Aus main bauen und es Release nennen. main bewegt sich; halten Sie den Commit fest oder bauen Sie aus einem Tag (Versionen, Tags und Pinning).
• composer update in einem Build ausführen. Es löst jedes Mal neue Versionen auf. Bauen Sie mit composer install aus Ihrer Lock-Datei (Lock-Dateien und reproduzierbare Builds).
• Als root bauen und Dateien im Besitz von root ausliefern. Korrigieren Sie die Besitzrechte vor dem Paketieren (Dateirechte und Besitz von var/).
• Versehentlich .git-Verzeichnisse ausliefern. Weg A und --keep-vcs behalten sie; entscheiden Sie, ob Ihre Empfänger sie haben wollen.

Verwandte Seiten #

• Kapitel 3: Den Code beschaffen
• Bundles auf Composer-Basis
• Composer und Git auf Servern
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.