phing

Vielen Dank, dass Sie PHING nutzen!

PH ing I s Not G NU make; Es handelt sich um ein PHP-Projekt-Build-System oder Build-Tool, das auf Apache Ant basiert. Sie können damit alles tun, was Sie mit einem herkömmlichen Build-System wie GNU Make tun könnten, und die Verwendung einfacher XML-Build-Dateien und erweiterbarer PHP-„Task“-Klassen machen es zu einem benutzerfreundlichen und äußerst flexiblen Build-Framework.

Zu den Funktionen gehören das Ausführen von PHPUnit-Komponententests (einschließlich Testergebnis- und Abdeckungsberichten), Dateitransformationen (z. B. Token-Ersetzung, XSLT-Transformation, Vorlagentransformationen), Dateisystemoperationen, interaktive Build-Unterstützung, SQL-Ausführung, SCM-Operationen (Git, Subversion und Mercurial), Dokumentationserstellung (PhpDocumentor, ApiGen) und vieles mehr.

Wenn Sie benutzerdefinierte Skripts schreiben, um das Packen, Bereitstellen oder Testen Ihrer Anwendungen zu übernehmen, empfehlen wir Ihnen, einen Blick auf Phing zu werfen. Vorgefertigt mit zahlreichen sofort einsatzbereiten Betriebsmodulen (Aufgaben) und einem benutzerfreundlichen OO-Modell zum Erweitern oder Hinzufügen eigener benutzerdefinierter Aufgaben.

Weitere Informationen und Dokumentation finden Sie auf unserer offiziellen Website unter https://www.phing.info/.

Phing 3

Phing 3 ist ein bedeutendes Update mit einigen wichtigen Änderungen im Vergleich zu Phing 2. Einzelheiten finden Sie in der Datei UPGRADING.md.

Unterstützte PHP-Versionen

Phing 3.x ist mit PHP 7.4 und höher kompatibel.

Installation

1. Komponist

Die bevorzugte Methode zur Installation von Phing ist Composer. Fügen Sie phing/phing zum Abschnitt „require-dev“ oder „require“ der Konfigurationsdatei composer.json “ Ihres Projekts hinzu und führen Sie „composer install“ aus:

     {
         "require-dev": {
             "phing/phing": "3.0.x-dev"
         }
     }

2. Phar

Laden Sie das Phar-Archiv herunter. Das Archiv kann dann ausgeführt werden, indem Folgendes ausgeführt wird:

     $ php phing-latest.phar

3. Docker (experimentell)

Das offizielle Phing Docker-Image finden Sie auf Docker Hub.

Führen Sie Folgendes aus, um Phing in einem Container auszuführen und build.xml in /home/user auszuführen:

     $ docker run --rm -v /home/user:/opt phing/phing:3.0 -f /opt/build.xml

4. Phing-GitHub-Aktion

Die offizielle GitHub-Aktion phingofficial/phing-github-action ist auf dem GitHub Marketplace verfügbar.

Um einen Phing-Build als Aktion auszuführen , müssen Sie eine .github/workflow/phing.yml Workflow-Datei einrichten und den folgenden Ausschnitt einfügen:

 name: CI
 on: [ push ]
 jobs:
   build-test:
     runs-on: ubuntu-latest

     steps:
       - uses: actions/checkout@v2
       - name: Phing Build
         uses: phingofficial/[email protected]
         with:
           version: 3.0.0-alpha4
           user-properties: prop=FooBar
           targets: foo
           verbose: true

README für weitere Informationen und Dokumentation.

Dokumentation

Die Dokumentation von Phing finden Sie unter https://www.phing.info/#docs.

Die Quelle der Dokumentation finden Sie unter https://github.com/phingofficial/guide.

Kontakt

• Twitter: @phingofficial
• Website: https://www.phing.info
• Slack: https://phing.slack.com/
• IRC: Freenode, #phing
• GitHub: https://www.github.com/phingofficial/phing

Spenden

Die Entwicklung und Wartung von Phing hat im Laufe der Jahre viele Stunden gekostet. Wenn Sie Ihre Wertschätzung zeigen möchten, können Sie eine der folgenden Methoden nutzen, um dem Projektbetreuer Michiel Rook etwas zu spenden:

• Werden Sie Patreon-Patron
• Flattr Phing
• Senden Sie Geld über PayPal
• Wählen Sie etwas aus der Amazon-Wunschliste

Danke schön!

Helfen Sie uns, Fehler zu erkennen und zu beheben

Wir freuen uns sehr, wenn Benutzer Probleme melden oder Funktionswünsche einbringen. Es gibt jedoch einige Richtlinien, die Sie beachten sollten, bevor Sie ein neues Problem einreichen:

• Stellen Sie sicher, dass das Problem noch nicht eingereicht wurde, indem Sie die Liste der (geschlossenen) Probleme durchsuchen.
• Support- und Installationsfragen sollten auf Twitter, Slack oder IRC gestellt und nicht als Probleme eingereicht werden.
• Beschreiben Sie das Problem gut, dazu gehören auch die notwendigen Schritte zur Reproduktion des Problems!
• Wenn Sie eine Lösung haben – sagen Sie es uns bitte! Das muss kein Code sein. Wir freuen uns über alle Schnipsel, Gedanken, Ideen usw., die uns bei der Lösung des Problems helfen können.

Probleme können auf GitHub gemeldet werden.

Pull-Anfragen

Der beste Weg, Code an Phing zu übermitteln, besteht darin, eine Pull-Anfrage auf GitHub zu stellen. Bitte helfen Sie uns, Ihren Beitrag schnell zusammenzuführen und Ihre Pull-Anfragen sauber und prägnant zu halten: Unterdrücken Sie Commits und führen Sie keine unnötigen (Leerzeichen-)Änderungen ein.

Der Quellcode von Phing ist gemäß dem PSR-2-Standard formatiert.

Ausführen der (Einheits-)Tests

Wenn Sie Code zu Phing beitragen möchten, stellen Sie bitte sicher, dass Sie die Tests ausführen, bevor Sie Ihre Pull-Anfrage senden. Um alle Phing-Tests erfolgreich durchzuführen, müssen die folgenden Bedingungen erfüllt sein:

• PEAR installiert, Kanal „pear.phing.info“ entdeckt
• Pakete „python-docutils“ und „subversion“ installiert
• php.ini-Einstellung „phar.readonly“ auf „Aus“ gesetzt

Führen Sie dann die folgenden Schritte aus (auf einem Klon/Fork von Phing):

     $ composer install
     $ cd tests
     $ ../bin/phing

Lizenzierung

Diese Software ist unter den Bedingungen lizenziert, die Sie in der Datei „LICENSE“ in diesem Verzeichnis finden.

Stolz zu verwenden:

Mitwirken

Wir lieben Beiträge!

Vielen Dank an alle, die bereits dazu beigetragen haben!

Expandieren