20100221 my phingtool - blog

2 035 vues

Publié le

0 commentaire
2 j’aime
Statistiques
Remarques
  • Soyez le premier à commenter

Aucun téléchargement
Vues
Nombre de vues
2 035
Sur SlideShare
0
Issues des intégrations
0
Intégrations
199
Actions
Partages
0
Téléchargements
0
Commentaires
0
J’aime
2
Intégrations 0
Aucune incorporation

Aucune remarque pour cette diapositive

20100221 my phingtool - blog

  1. 1. Capitaliser, (S’)Améliorer et Rationnaliserles développements PHP en interne<br />Olivier Hoareau – Février 2010<br />Merci de l’effort que vous fournirez si vous lisez ce document en entier ;)<br />
  2. 2. Quelques explications préalables (1/3)<br />Ce document a été écrit pour un client et anonymisé pour vous<br />Je développe actuellement un outil pour ce client grand compte qui doit gérer une multitude de projet de développement PHP, leur maintenance, la capitalisation et réutilisation du code<br />De nombreux concepts présentés ici ont déjà été implémenté dans certains outils connus (Symfony, Zend Framework, RoR…), d’autres sont issus de mes retours d’expériences, dont je remercie les auteurs<br />L’outil présenté existe (pas encore toutes ses fonctionnalités), est en cours de développement et n’est pas un mythe ;)<br />L’objectif de cet outils n’est absolument pas d’être un nième framework, mais un outil pour cadrer les pratiques de développement tout en laissant la possibilité d’utiliser d’autres frameworks (meta-framework ?)<br />
  3. 3. Quelques explications préalables (2/3)<br />Si des personnes sont intéressés par ce type d’outils, des contributions open source sont éventuellement envisageablesEnvoyer un email à olivier A T phppro D O T fr<br />Je mets à disposition ce document de présentation principalement pour avoir vos critiques (constructives idéalement ;)) vos retours d’expériences sur les sujets cités et vos questions<br />Les destinataires de ce document sont des internes (de ce client) qui gère les pratiques de développement en transverse et outillages associés, notamment pour PHP (mais pas que)*<br />Il est possible que beaucoup de points ne soient pas compréhensibles (car trop contextuels), je m’en excuse par avance et m’engage à vous donner toutes les explications aux questions que vous vous poseriez ;)<br />*lorsque dans le document je m’adresse à quelqu’un c’est donc à ces destinataires initiaux ;)<br />
  4. 4. Quelques explications préalables (3/3)<br />L’outil, basé sur phing (http://phing.info) , utilise massivement les task standard (Phing &gt;= 2.4.0) suivantes :<br />Taskdef<br />Import (pour le fractionnement et la réutilisation des targets)<br />Property<br />Phingcall<br />PropertyPrompt<br />La génération d’arborescence projet est basé sur une technique très simple :<br />Stocker un « modèle » d’arborescence avec des paramètres dans les fichiers ET dans les noms de fichiers/répertoires (%{nomVariable}), les variables étant ni plus ni moins que les propriétés disponibles dans le fichier de phing (build.xml / build.properties). Un semble preg_match_all et str_replace suffit pour générer une arborescence à partir du modèle et en ayant remplacer les variables dans le contenu et le nom des fichiers<br />Il est possible d’utiliser des fonctions pour formatter le texte de remplacement des variable<br />%{strtolower:name} / %{realpath:home.dir} / …<br />*lorsque dans le document je m’adresse à quelqu’un c’est donc à ces destinataires initiaux ;)<br />
  5. 5. Constats<br />PHP est utilisé chez nous (i.e. moi le client)<br />Plusieurs projets en interne sont motorisés par PHP<br />Il existe différentes « typologies » de projet PHP (dév spécifique, appli web Zend Framework, appli web Symfony, appli Drupal…)<br />Les règles de développement sont à unifier<br />Nous ne sommes pas dans une logique de réutilisation de code déjà développé par nos soins (voir en externe)<br />Les documents ne sont pas lus par tout le monde<br />Les équipes projets ont du mal à venir chercher l’info (i.e. dans les cellules d’architecture ou de compétences transverses)<br />
  6. 6. Objectifs<br />Instancier un projet de qualité professionnelle en quelques minutes sans connaître toutes les bonnes pratiques<br />Rationnaliser l’arborescence du code<br />Proposer des fonctionnalités d’intégration continueunifiées et complètes à tous les projets PHP (ne nécessitant pas des heures de configuration sur les outils comme Hudson, PHPUnderControl…)<br />Proposer un mécanisme de publication et de réutilisation de code en interne (ou externe) simple à l’emploi, standard et compatible avec nos contraintes de déploiement (qui peuvent être très spécifique…)<br />
  7. 7. Une solution possible :<br />Utiliser Phing (Open Source)<br />Savoir prendre en compte différentes arbo<br />Être Compatible Windows / Linux<br />Être Compatible Poste Bureautique / Serveur<br />Être Compatible PEAR (et channel PEAR)<br />Être Extensible et évolutif<br />Être 100 % PHP<br />Nom de code: MyPhingTool*<br />* Ce n’est pas le vrai nom de l’outil…<br />
  8. 8. MyPhingTool: Principe<br />Centraliser / Maintenir les bonnes pratiques<br />Installer facilement avec PEAR<br />Proposer un outil ligne de commande<br />Déployer simplement tous les outils du dév.<br />Même outil pour le développeur et la Plateforme d’Intégration Continue (PIC)<br />Générer une arbo projet en qq secondes<br />…<br />
  9. 9. Installation<br />$ pearchannel-discoverpear.&lt;myclient&gt;.fr<br />$ pear upgrade --alldepsmyclient/myphingtool<br />$ myphingtool –v<br />myphingtool v0.0.6, 2010-02-20 16:21:27<br />Chargement de la nature: myphingtool_nature_default v0.0.2 by Olivier Hoareau (released on 2010-02-21 15:03:05)<br />Phing 2.4.0<br />
  10. 10. Génération d’un projet<br />$ mkdir projet1<br />$ cd projet1<br />$ myphingtoolgenerate-project<br />Name: project1<br />Nature: zend-framework<br />Naturemodèle de projet prêt à l’emploi<br />
  11. 11. Exemple d’arbo générée<br />IDE (Eclipse/Netbeans…)-ready<br />
  12. 12. Fonctionnalités embarquable<br />Arborescence rationnalisée<br />Gestion des dépendances avec code capitalisé<br />Paramétrage Apache<br />Déploiement automatisé sur les serveurs (fichiers + bdd)<br />Déploiement outillage sur le poste du développeur<br />Génération de rapports qualité (T.U, Coverage…)<br />Vérification du respect des conventions de codage<br />Intégration de tout les outils qualité<br />Packaging compatible socle technique &lt;client-name-here&gt;<br />Projet compatible Eclipse (ou autre IDE)<br />Audit d’un code externe (sous réserve de compatibilité d’arbo)<br />…<br />
  13. 13. Le fichier myphingtool.ini<br />Format texte type « ini » (simple)<br />Minimal<br />Précise la « nature » du projet (généré)<br />Donne accès à des commandes phing spécifiques à la nature<br />Permet à tout moment de changer de nature (si l’arbo est compatible)<br />myphingtool.ini<br />nature=zend-framework<br />
  14. 14. Lister les commandes disponibles<br />$ myphingtool -l<br />Compatible phing<br />Liste des commandes disponibles variable en fonction de la nature du projet<br />
  15. 15. Les commandes* qui seront disponibles<br />help<br />tests-unit<br />tests-unit-with-coverage<br />checks-syntax<br />checks-conventions<br />packages-pear<br />Publishes-pear-package<br />generates-doc<br />builds-on-commit<br />builds-nightly<br />packages<br />deploys(-Dtarget=dev|int|test|preprod|prod)<br />publishes-metrics<br />cleans<br />installs-dependencies<br />adds-dependency<br />removes-dependency<br />upgrades-dependency<br />lists-dependencies<br />…<br />* Target Phing<br />Compatible phing<br />100% disponible sur le poste de dev + sur la PIC<br />
  16. 16. Pré-requis<br />PHP 5.2.0+<br />PEAR 1.9.0+<br />Accès internet (avec proxy éventuellement)<br />Les dépendances sont vérifiées à l’installation et sont « tirées » (sauf pour la version de PHP)<br />Il n’y a donc qu’un seul outil à installer en plus de PHP et PEAR (il tire toutes les autres dépendances)<br />Il est envisageable d’installer l’IDE (Eclipse…) et tout autre outil en dehors de PHP (donc Apache, MySQL…) avec cet outil, mais ce n’est pas prévu dans les développement en cours<br />
  17. 17. Qui peut / doit utiliser MyPhingTool ?<br />Les développeurs  gagner du temps<br />Les chefs de projet  contrôler / qualifier<br />La PIC  contrôle automatisé et déploiement<br />Les prestataires consultants  audit de code<br />…<br />
  18. 18. Compétences nécessaires pour la maintenance<br />PHP 5+<br />PEAR<br />Phing<br />PHPUnit<br />Outillage qualité (phploc, phpcpd…)<br />Connaissances des bonnes pratiques de développement PHP (apprentissage possible)<br />…<br />Il n’est pas nécessaire qu’une seule personne connaisse tout, la compétence peut être diffusé, mais doit être complète<br />
  19. 19. Démarche de capitalisation du code<br />Identifier le code à capitaliser<br />Générer un projet de nature « package-pear »<br />Intégrer le code récupéré / développé dans l’arbo vierge<br />Nettoyer le code pour qu’il soit propre<br />Réaliser les éventuels tests unitaires<br />Packager le code (« myphingtool packages-pear »)<br />Publier le code sur le channel PEAR interne (ou externe)<br />Communiquer sur le feeddev (si pas automatique)<br />Objectif: une multitude de « petits » paquets, plutôt que quelques grosses librairies<br />
  20. 20. Comment créer un « paquet » capitalisé<br />$ mkdir lib-paquet1<br />$ cd lib-paquet1<br />$ myphingtoolgenerate-project –Dname=lib-paquet1 –Dnature=package-pear<br />Puis copier / nettoyer / génériciser votre code dans le répertoire sources/<br />
  21. 21. Comment publier du code en tant que code capitalisé ?<br />Mettre à jour la version dans le fichier configs/phing/build.properties<br />$ myphingtool packages-pear<br />$ myphingtoolpublishes-pear-package<br />
  22. 22. Comment utiliser du code capitalisé dans un projet ?<br />$ myphingtooladds-dependency<br />Type:pear<br />Name: lib-paquet1<br />Channel:pear.&lt;myclient&gt;.fr<br />Version: 0.0.1<br />Required: true<br />$ myphingtoolinstalls-dependencies<br />Les différentes dépendances sont alors téléchargées et installées via PEAR dans le répertoire dependencies/library/ du projet (qui n’est pas subversionné !), ce répertoire étant ajouté automatiquement dans l’includepath<br />
  23. 23. Et les projets utilisant des frameworks ?<br />Comme :<br />Zend Framework, Symfony, Drupal, Joomla, Magento, …<br />Technique à mettre en œuvre :<br />« Pear-iser » le framework (générer un projet de nature package-pear et copier le code PHP dans sources/)<br />Publier le paquet PEAR du framework sur le channel interne (ou externe)<br />Utiliser MyPhingTool pour générer un projet vierge et ajouter la dépendance<br />Eventuellement créer une « nature » dédié à cette typologie de projet (&lt;= 0,5j de charge)<br />
  24. 24. Je suis chef de projet de dev PHP, pourquoi je choisirai cette solution ?<br />Une piste pour éviter de dépenser de l’énergie / charge sur des développements déjà réalisé en interne (ou ailleurs)<br />Suivre l’évolution du niveau de qualité du projet au fil de l’eau (je recevrais un email tous les matins avec des métriques qualité, voir des graphiques), je n’aurais pas besoin d’aller voir un outil même en ligne<br />Mes développeurs n’ont pas forcément besoin de connaître tous les outils (notamment de qualité)<br />Je pourrai avec mes développeurs augmenter progressivement le niveau de qualité attendu (enrichissement des règles de codage graduel)<br />J’aurai du support technique sur les sujets transverses (outillage, intégration continue, bonnes pratiques)<br />Mes développeurs ne feront pas n’importe quoi<br />Je pourrais auditer régulièrement *moi-même* l’application (point de contrôle générique)<br />…<br />
  25. 25. Je suis chef de projet, qu’est ce que ca me coûte pour la mise en place?<br />0€<br />Installer PHP et l’outil (quelques minutes)<br />Générer un projet à partir d’un modèle (quelques secondes)<br />Présenter le socle et les pratiques à mon équipe (1-2 heures avec un coach technique)*<br />* Chez ce client, une cellule transverse pourra potentiellementmettre à dispo un coach technique comme moi pour les projets<br />
  26. 26. Point de situation<br />Proof Of Concept réalisé et concluante<br />Développement à 60% mais déjà réalisé de façon éparpillée pour différents clients (à nettoyer, génériciser…)<br />Reste à faire:<br />Committer tout ça sur un SVN (a priori celui du client, peut être une partie OSS)<br />Créer un espace wiki (confluence)<br />Créer un espace bugtracker (Jira)<br />Saisir la TODO List dans le bugtracker<br />Développement de certaines « target »<br />Installation channel PEAR interne<br />Installation / Paramétrage PIC<br />Packaging des dépendances standard (ZF, ExtJS…)<br />Formation Equipe Capitalisation<br />Documentation étendue<br />Créer un feed RSS à destination de l’ensemble des développeurs PHP interne<br />…<br />
  27. 27. Comment s’organiser ?<br />Être « agile »<br />Laisser la possibilité à n’importe qui (interne ou prestataire) de contribuer<br />S’engager à terminer une tâche lorsque l’on se l’est attribué (via bugtracker par exemple) et ce dans le timing de l’itération<br />Créer une liste de diffusion pour les personnes intéressés pour « maintenir » et animer la cellule capitalisation<br />Utiliser le bugtracker pour gérer la Todo-list<br />Nommer un Product-Owner (permanent) responsable de la « roadmap » des « services » fournis par la cellule transverse<br />Rentrer dans une démarche itérative (itération de 2 semaines)<br />Faire des « electronic-standup-meeting » (eSum) en envoyant un email chaque jour ou l’on travail sur le sujet à la liste de diffusion<br />
  28. 28. Comment vous pouvez aider ?<br />En béta-testant sur vos projets<br />En dépilant les tâches dans bugtracker<br />En identifiant les projets candidats / Faisant la promo<br />En faisant des remarques / propositions d’amélioration<br />En participant à une présentation technique détaillée (par mes soins, à planifier)<br />En identifiant et recensant le code existant à capitaliser<br />En créant ensemble une cellule d’aide aux projets PHP fournissant du support sur cet outil et les pratiques associées<br />
  29. 29. Comment je peux vous aider ?<br />En vous faisant monter en compétences sur ces sujets<br />En planifiant avec vous la mise en place<br />En traitant les tâches de développement non prises<br />En suivant les itérations avec le productowner<br />En étant en support technique « à la demande » (best-effort)<br />En aidant les projets à démarrer avec MyPhingTool et les pratiques associées<br />En vous aidant à « capitaliser » du code identifié<br />En animant avec vous la cellule PHP (mailing list)<br />En formant vos prestataires au développement pro<br />…<br />
  30. 30. Pour aller plus loin…<br />Proposer des targetphing complémentaire comme par exemple « myphingtoolgenerates-audit-report »<br />Capitaliser le maximum de code développé sur le Projet XXX et le Projet YYYY, et … ?<br />Mettre en place une page web de génération de projet (formulaire nom, nature et téléchargement d’un zip tout prêt)  Facile<br />Publier myphingtool en Open Source<br />Ne pas publier les devs spécifiques<br />Présenter MyPhingTool au Forum PHP 2010 (Paris)<br />
  31. 31. Merci !des questions ?<br />

×