phing

Merci d'utiliser PHING !

PHing n'est pas une marque GNU ; il s'agit d'un système de construction de projets PHP ou d'un outil de construction basé sur Apache Ant. Vous pouvez faire tout ce que vous pourriez faire avec un système de construction traditionnel comme GNU make, et son utilisation de fichiers de construction XML simples et de classes de « tâches » PHP extensibles en font un cadre de construction facile à utiliser et très flexible.

Les fonctionnalités incluent l'exécution de tests unitaires PHPUnit (y compris les résultats des tests et les rapports de couverture), les transformations de fichiers (par exemple, le remplacement de jetons, la transformation XSLT, les transformations de modèles), les opérations du système de fichiers, la prise en charge interactive des builds, l'exécution SQL, les opérations SCM (Git, Subversion et Mercurial), génération de documentation (PhpDocumentor, ApiGen) et bien plus encore.

Si vous vous retrouvez à écrire des scripts personnalisés pour gérer le packaging, le déploiement ou les tests de vos applications, nous vous suggérons de consulter Phing. Pré-emballé avec de nombreux modules opérationnels (tâches) prêts à l'emploi et un modèle OO facile à utiliser pour étendre ou ajouter vos propres tâches personnalisées.

Pour plus d'informations et de documentation, vous pouvez visiter notre site officiel à https://www.phing.info/.

Phing 3

Phing 3 est une mise à jour importante avec quelques changements importants par rapport à Phing 2. Pour plus de détails, veuillez vous référer au fichier UPGRADING.md.

Versions PHP prises en charge

Phing 3.x est compatible avec PHP 7.4 et supérieur.

Installation

1. Compositeur

La méthode préférée pour installer Phing consiste à utiliser Composer. Ajoutez phing/phing à la section require-dev ou require du fichier de configuration composer.json de votre projet et exécutez « composer install » :

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

2. Phar

Téléchargez les archives Phar. L'archive peut ensuite être exécutée en exécutant :

     $ php phing-latest.phar

3. Docker (expérimental)

L'image officielle de Phing Docker peut être trouvée sur Docker Hub.

Pour exécuter Phing dans un conteneur et exécuter build.xml situé dans /home/user , exécutez ce qui suit :

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

4. Action Phing GitHub

L'action officielle GitHub phingofficial/phing-github-action est disponible sur GitHub Marketplace.

Pour exécuter une Phing Build en tant qu'action, vous devez configurer un fichier de workflow .github/workflow/phing.yml et coller l'extrait suivant :

 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 pour plus d'informations et de documentation.

Documentation

La documentation de Phing est disponible sur https://www.phing.info/#docs.

Pour la source de la documentation, rendez-vous sur https://github.com/phingofficial/guide.

Contact

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

Dons

Développer et maintenir Phing a coûté de nombreuses heures au fil des ans. Si vous souhaitez montrer votre appréciation, vous pouvez utiliser l'une des méthodes suivantes pour faire un don au responsable du projet, Michiel Rook :

• Devenez mécène sur Patreon
• Phing plat
• Envoyer de l'argent via PayPal
• Choisissez quelque chose dans la liste de souhaits Amazon

Merci!

Aidez-nous à repérer et à corriger les bugs

Nous apprécions grandement que les utilisateurs signalent des problèmes ou soumettent des demandes de fonctionnalités. Cependant, il y a quelques directives que vous devez respecter avant de soumettre un nouveau numéro :

• Assurez-vous que le problème n'a pas déjà été soumis, en effectuant une recherche dans la liste des problèmes (fermés).
• Les questions d'assistance et d'installation doivent être posées sur Twitter, Slack ou IRC, et non classées comme problèmes.
• Donnez une bonne description du problème, cela inclut également les étapes nécessaires pour reproduire le problème !
• Si vous avez une solution, dites-le-nous ! Il n'est pas nécessaire que ce soit du code. Nous apprécions tous les extraits, réflexions, idées, etc. qui peuvent nous aider à résoudre le problème.

Les problèmes peuvent être signalés sur GitHub.

Demandes de tirage

La meilleure façon de soumettre du code à Phing est de faire une Pull Request sur GitHub. S'il vous plaît, aidez-nous à fusionner votre contribution rapidement et à garder vos demandes d'extraction propres et concises : écrasez les validations et n'introduisez pas de modifications inutiles (espaces).

Le code source de Phing est formaté selon la norme PSR-2.

Exécuter les tests (unitaires)

Si vous souhaitez contribuer au code de Phing, assurez-vous d'exécuter les tests avant de soumettre votre pull request. Pour réussir tous les tests Phing, les conditions suivantes doivent être remplies :

• PEAR installé, canal "pear.phing.info" découvert
• Packages "python-docutils" et "subversion" installés
• Paramètre php.ini "phar.readonly" défini sur "Off"

Ensuite, effectuez les étapes suivantes (sur un clone/fork de Phing) :

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

Licence

Ce logiciel est sous licence selon les termes que vous pouvez trouver dans le fichier nommé « LICENSE » dans ce répertoire.

Fier d'utiliser :

Contribuer

Nous aimons les contributions !

Merci à toutes les personnes qui ont déjà contribué !

Développer