|
|
 |
Auto-documentation de code PHP avec Reflexion
Liens sponsorisés
Actualités
Voici une compilation des sources d'information sur ce sujet :
En PHP, il existe de nombreuses manières de documenter son code. La méthode la plus répandue est phpdoc. Avec PHP 5 et l'introduction de l'API de reflexion, il est possible d'utiliser PHP pour documenter automatiquement son propre code, sans avoir recourt à des outils d'analyse du code source.
Cet article couvre l'extension de la syntaxe phpdoc et l'accès aux informations via l'API de reflexion pour convertir le tout en XML.
Il arrive, sur des sites comme celui de Nexen.net par exemple, que l'on ait à afficher du code source PHP. La documentation en est émaillée, de même que la bibliothèque de scripts. Stoyan Stevanov vous présente les 2 méthodes disponibles pour cela : les fonctions internes de PHP, et le paquet PEAR Text_Highlighter.
La documentation utilisateur du framework php.MVC (portage de struts sous PHP) de John WILDENAUER est disponible en Français en téléchargement sur le site officiel.
L'apprentissage de cet outil professionnel n'est pas forcément aisé au départ. Espérons que cette documentation française puisse aider la communauté francophone des développeurs PHP à s'y intéresser et à l'utiliser.
Toute la documentation php, le langage web le plus populaire, est disponible sur manuel-php. Retrouvez tous les descriptifs des fonctions php directement en ligne. Site idéal pour tous les webmasters, les programmeurs php, quel que soit leur niveau
L'équipe de documentation de PHP est fière de présenté la dernière mouture de la documentation.
* Un nouveau système de livraison du document vers les mirroires.
* Le manuel permet...
Je vient de d'ajouter une fonction qui colorise le code PHP compris entre les balises [ code] et [/code].
Si
PHPLint est un analyseur de code PHP. Il passe en revue le code source de PHP, puis indique les différentes erreurs de documentation et de style qu'il a repéré. Il étudie le code source d'un point de vue sémantique, et remonte automatiquement des erreurs, telle que les fonctions qui ne servent à rien, les codes en trop, les branches conditionnelles inutiles, etc.
Vous pouvez essayer la version de démonstration en ligne, avec quelques exemples de code, ou bien télécharger deux versions locales. Je n'ai pas pu tester la version locale sur mon mac, mais peut-être aurez-vous plus de chance.
PHPLint fait la promotion d'un code PHP bien écrit, documenté et sécuritaire. En imposant des normes vérifiables, il pourra être un outil important pour industrialiser votre code.
David Coallier vient de porter le système de notes utilisé par la documentation PHP vers la documentation PEAR. Désormais, les paquets PEAR peuvent être commentés. Vous retrouverez ces...
David Coallier vient de porter le système de notes qui a fait le succès de la documentation PHP pour la documentation PEAR. Désormais, les paquets PEAR peuvent tous être commentés....
Flexy est un des moteurs de gabarits en vogue en ce moment, aux cotés de Smarty et Pat template. Comme Smarty, Flexy est un générateur de code : il compile le gabarit et du code PHP pour donner un script exécutable directement. Flexy est entretenu activement par Alan Knowles.
PHP Kitchen vous propose un complément à la documentation officielle de référence : un tutoriel pour écrire un module Flexy.
GhostDoc est un outil gratuit qui vaut le détour. Développé par Roland Weigelt, GhostDoc permet à la manière d'un outil de refactoring de synchroniser les commentaires avec tout changement de code source tout en définissant des règles (modèles) de documentation à l'échelle d'une entreprise. Le tout graphiquement sous Visual Studio 2003 et ... 2005. "GhostDoc is a free add-in for Visual Studio .Net 2003 that automatically generates XML documentation comments for C# either by using existing documentation inherited from base classes or implemented interfaces, or by deducing them from name and type of e.g. methods, properties or parameters." Découvrez l'outil et une vidéo présentée à la PDC dans le détail. L'essayer c'est l'adopter.
GhostDoc est un outil gratuit qui vaut le détour. Développé par Roland Weigelt, GhostDoc permet à la manière d'un outil de refactoring de synchroniser les commentaires avec tout changement de code source tout en définissant des règles (modèles) de documentation à l'échelle d'une entreprise. Le tout graphiquement sous Visual Studio 2003 et ... 2005. "GhostDoc is a free add-in for Visual Studio .Net 2003 that automatically generates XML documentation comments for C# either by using existing documentation inherited from base classes or implemented interfaces, or by deducing them from name and type of e.g. methods, properties or parameters." Découvrez l'outil et une vidéo présentée à la PDC dans le détail. L'essayer c'est l'adopter.
GhostDoc est un outil gratuit qui vaut le détour. Développé par Roland Weigelt, GhostDoc permet à la manière d'un outil de refactoring de synchroniser les commentaires avec tout changement de code source tout en définissant des règles (modèles) de documentation à l'échelle d'une entreprise. Le tout graphiquement sous Visual Studio 2003 et ... 2005. "GhostDoc is a free add-in for Visual Studio .Net 2003 that automatically generates XML documentation comments for C# either by using existing documentation inherited from base classes or implemented interfaces, or by deducing them from name and type of e.g. methods, properties or parameters." Découvrez l'outil et une vidéo présentée à la PDC dans le détail. L'essayer c'est l'adopter.
Pôle Documentation donne des conseils pour optimiser la recherche d'emploi dans la documentation et les métiers transversaux.
L'objectif est de former un réseau de chercheurs d'emploi et...
La Commission européenne estime que la fourniture du code source de Windows ne permettra pas aux développeurs d'améliorer l'interopérabilité de leurs logiciels avec ceux de Microsoft. Manque l'essentiel: la documentation pour accompagner ce code.
Sites de l'annuaire
Voici des sites figurant dans notre annuaire (inscription gratuite) :
- Documentation PHP : tout le manuel php
Toute la documentation php, le langage web le plus populaire, est disponible sur manuel-php. Retrouvez tous les descriptifs des fonctions php directement en ligne. Site idéal pour tous les webmasters, les programmeurs php, quel que soit leur niveau. Bonne programmation....
Catégorie : Programmation > Langage PHP
http://manuel-php.pcdebutant.com/
- CodeRoute : Code en ligne - site européen du code de la route
CodeRoute : Examen et formation sur le code de la route. Avec 1200 questions et 230 leçons animées conformes au nouveau code de la route. Réviser en condition réel. Annuaire des auto-écoles pour toute la France....
Catégorie : Ressources > Code de la route
http://www.coderoute.com/
- Jeux de reflexion en ligne
Nombreux jeux de reflexion en ligne gratuits dont le sudoku, master mind, solitaire...Des jeux de reflexion sont ajoutés très régulierement...Inscrivez vous et devenez le / la meilleur(e) joueur(se) de reflexion du site...
Catégorie : Jeux > Jeux de réflexion
http://www.jeux-de-reflexion.net/
- Code de la route gratuit
Permik propose un support gratuit pour la préparation du code de la route de la catégorie B en mettant à votre disposition un cours, des exercices ainsi que des examens. A l'aide du cours (organisés par thèmes) vous parviendrez à assimiler les connaissances fondamentales de la conduite automobile et ensuite, évaluer vos connaissances en faisant les exercices destinés à cet effet. Permik se positionne donc,comme un excellent moyen de voir ou de revoir les fondamentaux du code de la route....
Catégorie : Ressources > Code de la route
http://www.permik.net/
- Auto-école David d'Angers - Cours code de la route
Auto-école Angers (49). L'auto-école David d'Angers propose des cours de préparation à l'examen du code de la Route et aux permis de conduire auto et moto, A, B et au Brevet de Sécurité Routière. Nous vous proposons la conduite accompagnée à partir de 16 ans ainsi que des cours de perfectionnement de la conduite, des cours de circulation en ville et sur route....
Catégorie : Permis auto > Auto-écoles
http://www.auto-ecole-angers.com/
- Annuaire des auto-écoles MonAutoEcole
Monautoecole : annuaire des auto-écoles et écoles de conduite de France. Vous trouverez les sites internet des auto-écoles classés par région et département pour passer votre code et votre permis de conduire....
Catégorie : Permis auto > Auto-écoles
http://monautoecole.free.fr/
- Auto école Reims Demonceaux conduite
Auto-école sur Reims, avec des voitures c4, code corrigé et expliqué, permis auto, moto, bsr, conduite accompagnée etc. vous trouverez forcément votre bonheur. En tout cas jetez au moins un oeil sur le site internet. Quand on a une bonne auto école il faut que ça se sache En plus du 16 février au 27 mars, ils offrent une place pour les 24hrs du mans moto pour toute inscription au permis moto Le permis B comprend: * Frais de dossier et d'inscription * Livret d'apprentissage (contenu détaillé de la formation pratique) * Fournitures (livre de code, fascicule interrogation orale) * Cours et test de code du lundi au vendredi * Présentation à l'examen du code * Présentation à l'examen de conduite...
Catégorie : Permis auto > Auto-écoles
http://www.demonceaux-conduite.com/
- Code de la route - Test code de la route - Tests du code de la route en ligne
Code de la route : Testcodedelaroute vous propose de tester vos connaissances du code de la route, avec 1000 questions du code de la route en ligne. Découvrez notre package de 25 séries d'examen de 40 questions portant sur les sujets de l'examen 2009/2010, et révisez directement en ligne depuis le confort de votre domicile Vous y découvrirez tous les pièges subtils de l'examen du code de la route au niveau des panneaux de signalisation, croisements, dépassements, stationnement, et circulation....
Catégorie : Ressources > Code de la route
http://www.testcodedelaroute.fr/
- Japan Car Portail automobiles JapanCar
Forum auto toutes marques asiatiques : Honda Civic CRX Nissan Skyline Toyota Mazda Subaru Mitsubishi Hyundaï etc. JapanCar, aussi connu sous le nom de Jpcar, est le forum de référence pour les passionnés d'automobile sportive. Rejoignez nous et suivez l'actualité automobile mondiale, les nouveautés des différents salon auto, ou trouvez ici des conseils en mécanique et optimisation moteur pour vos auto, des bons plans pour acheter des pièces détachées automobiles, des petites annonces auto....
Catégorie : Automobile (loisirs) > Forums auto
http://www.japancar.fr/
- Annuaire des Auto Entrepreneurs - Neo Entrepreneur
Neo Entrepreneur est un site communautaire dédiés aux Auto Entrepreneurs de France. Depuis le 1er janvier 2009, ce statut vous permet de créer votre micro-entreprise en toute simplicité. L'annuaire classé par secteur d'activités vous permet de créer une fiche personnalisée à propos de votre nouvelle activité. Faites connaître votre activité avec l'annuaire et échangez avec les 200 000 Auto Entrepreneurs déclarés....
Catégorie : Création d'entreprise > Statut d'auto-entrepreneur
http://www.neo-entrepreneur.fr/
Autres actualités
- Les notes de documentation viennent à PEAR ...
David Coallier vient de porter le système de notes qui a fait le succès de la documentation PHP pour la documentation PEAR. Désormais, les paquets PEAR peuvent tous être commentés....[...]
- Utilisez-vous du code PHP 4 sur PHP 5? Résultat du sondage ...
Encore un sondage qui va dans le sens de PHP 5 : à la question 'faites-vous tourner du code PHP 4 sur PHP 5', 51% des personnes répondent 'oui, sans...[...]
- [News] GhostDoc accélère gratuitement la documentation de code source ...
- System.out.print est du code PHP ...
Ivo Jansch présente le code écrit par un candidat au recrutement qui ne connaissait pas PHP
?<?php
System.out.print($result);
?>
C'est une erreur? Mais le plus drôle, c[...]
- Dashboard Widget pour la documentation PHP ...
- Le mois de la fonction PHP démarre en Avril ...
PHP est connu pour sa richesse fonctionnelle : plus de 3000 fonctions disponibles dans la version de base, et probablement encore le double avec les extensions PECL optionnelles. La documentation...[...]
- Documentation utilisateur du framework php.MVC en français ...
- Utilisez-vous du code PHP 4 sur PHP 5? ...
onPHP5 lance un sondage : utilisez-vous des applications PHP 4 sur un serveur PHP 5?
Cette initiative va dans le sens de mon article sur les applications PHP : au...[...]
- Google Summer of Code : 17 projets pour PHP et MysQL ...
Cette année, le Google Summer of Code a retenu 7 projets pour PHP, et 10 pour MySQL. Les étudiants qui travailleront sur ces sujets ont été choisis et le travail...[...]
- Compiler PHP 6 ...
David Coallier rafraîchit la documentation d'Andrei Zmeivski, et publie les instructions pour compiler PHP 6 sur une machine Linux. Même si l'article prétent que c'est pour dé[...]
- Injection d'entêtes mail en PHP ...
[..]Ce code est largement ouvert au spamming email :-)
D'autant plus que les webmasters ont tendance à appeler ces fichiers mail.php, ou contact.php, ce qui est facilement trouvable sur google, ou...[...]
- Injections distantes via les fichiers locaux ...
Les injections de code PHP sont un fléau épidémique, et PHP 5.2.1 devrait le freiner considérablement à l'aide d'une nouvelle directive de PHP, allow_url_include : cette dernière permet d'autoriser le[...]
- Extension PHP pour FireFox : FirePHP ...
FirePHP vous donne une vue plus détaillée du fonctionnement de votre code PHP lorsque ce dernier génère la page courante, depuis le navigateur FireFox.
Installez simplement l'extension FirePHP, le pa[...]
- Premiers retours autour du moteur Falcon ...
Beaucoup de monde s'intéresse au nouveau moteur de MySQL. Parmi les bonnes nouvelles, le code source est maintenant disponible dans le serveur bitkeeper de MySQL, et la documentation est en...[...]
- Intranet-Extranet > Documentation 3D : Dassault Systèmes croque Seemage ...
Dassault Systèmes acquiert la société Seemage, spécialisée dans les solutions de documentation interactive en 3 dimensions. L...[...]
|
|
|
|
