Blog des plugins Symfony de SPYRIT

La ligne de commande

Afin de créer un fichier, vous pouvez executer la commande :

./symfony plugin:build-package

Sous windows :

symfony plugin:build-package

(je rappele que l'appel au php-cli est optionnel, vous n'avez donc pas l'obligation de mettre php symfony ...)

Le task dispose également d'un alias pour ceux qui ne se sont pas encore fait à la structure des namespaces :

symfony plugin-build-package

Paramètre obligatoire

Cette ligne de commande contient un argument obligatoire, vous l'aviez probablement deviné, c'est le nom du plugin.

Par défaut et je vous conseille de respecter cette structure, ca simplifie la vie, c'est le nom du plugin dans le fichier package-NOM_DU_PLUGIN.xml

Options complémentaires

• --skelton-path="THE PATH" ou -p"The path" : si vous voulez utiliser un autre fichier que package-NOM_DU_PLUGIN.xml
• --plugin_version="X.Y.Z" ou -v"X.Y.Z" : La version du plugin, la norme PEAR requiert un numéro de verion sur 3 chiffres X.Y.Z
• --stability="stable" ou -s"stable" : La stabilité de votre plugin (stable ou beta)
• --changelog="Note de changelog" ou -c"Note de changelog" : Si vous souhaiter remplir automatiquement la balise <changelog> du fichier xml
• --license_uri="url" ou -uri"URL" : Permet de changer l'url de la license associer à votre package par défaut http://www.symfony-project.com/license
• --license_name="Nom de la license" ou -l"Nom de la license": Si vous souhaitez changez de nom pour la license par défaut MIT

Recommandations d'usage

Afin de vous simplifier la vie, voila la ligne de commande que je vous conseil :

./symfony plugin:build-package -v"X.Y.Z" -s"beta" -c"Your notes for the version" PLUGIN_NAME

Si vous avez créer votre ficher XML avec le bon numéro de version, et que vous aviez oublié un fichier par exemple (mais sans rien avoir mis sur le repository), ou encore que vous n'avez pas directement générer le tgz, vous pouvez executer

./symfony plugin:build-package PLUGIN_NAME