Outils de développement

Retour index
Documentation développeur

Tout environnement de développement peut être utilisé. Toutefois voici une liste d'outils fortement recommandés pour leur complétude, leur qualité et la productivité du développement qu'ils apportent. Ils sont utilisés par la plupart des développeurs principaux de Dolibarr. Notons que toutes ces solutions sont gratuites et OpenSource.

Pour tout développeur

Voici le socle de travail recommandé, toutefois tout outil respectant les standards Web, PHP, Mysql peuvent faire l'affaire.

Un serveur AMP

• Apache, Mysql et PHP

Sur Linux: Ces 3 produits sont disponibles dans toutes distributions.

Sur Windows: Installez WampServer 2 (base Mysql, Apache et PHP tout clé en main). Ce serveur WAMP offre le trio MySql+Apache+PHP, avec possibilité de basculer de version pour n'importe lequel de ces composants d'un simple clic).

Firefox et plugins

• Firefox 3.0 avec les plugins:
  • HTML Validator,
  • Firebug + Firecookie,
  • Phplangeditor et les Dictionnaires des langues si vous compter traduire
  • Cert Viewer Plus si vous comptez faire des tests en HTTPS,
  • FoxyProxy si vous voulez basculer rapidement votre navigateur vers des utilitaires Proxy (WebScarab)...
  • User agent switcher pour simuler des accès depuis un smartphone

A télécharger depuis le site http://www.firefox.com

SquirrelSQL

• SquirrelSQL pour l'administration de base

A télécharger depuis le site http://squirrel-sql.sf.net

Eclipse et plugins

Installation d'Eclipse

Je recommande la version 3.4 d'Eclipse disponible sur le site http://www.acceleo.org/pages/download-acceleo-2-6-0/en qui embarque la plupart des plugins intéressant. Une fois lancé, vous pouvez aller dans le centre de mise a jour, Help -> Software updates pour mettre à jour Eclipse avec la version 3.4.2 M20090211-1700.

Sinon toute version disponible sur le site Eclipse.

Installation du plugin Eclipse pour PHP: PDT.

Si vous avez installé la version Eclipse ci-dessus, il suffit d'utiliser la procédure Find And Install et ajouter l'URL de mise à jour: http://download.eclipse.org/tools/pdt/updates/

Installer la version 1.0.5 de PDT. La version 0.2.0 est buggué avec Eclipse 3.4.x.

Configurer Eclipse pour récupérer la version CVS

Une fois qu'Eclipse est installé, vous pouvez vous connecter au repository CVS pour y récupérer la dernière version de développement.

• Créer un nouveau projet : File >> New >> Projects puis sélectionner "Project from CVS" et "Next"
• Sélectionner "Create a new repository location" puis "Next"
• Remplir la fenêtre suivante comme ceci :
  • Host : cvs.savannah.nongnu.org
  • Repository path : /cvsroot/dolibarr
  • User : anonymous
  • Password : (laisser vide)
  • Connection type : pserver
  • Use default port
• Ensuite remplir le champ Use specified module name : dolibarr
• Choisir ensuite le nom que le projet aura sur votre machine :
  • Cocher Check out as a projet in the workspace
  • Project Name : dolibarr
  • Cocher Checkout subfolders
• Ensuite, laisser le chemin par défaut du workspace et "Next"
• Enfin, sélectionner la branche à charger
  • HEAD est la version de développement
  • Les version 2.6, 2.6, etc., se trouvent dans Branches
• Cliquer sur "Finish"

Les fichiers devraient être téléchargés sur votre disque dur.

Pour ensuite mettre à jour la version de votre machine, il faut passer en perspective "Team Synchronizing" pour utiliser la fonction "Synchronize CVS", ce qui aura pour effet de télécharger les dernières versions sur votre disque dur. Seuls les fichiers qui ont été modifiés sont téléchargés.

Optionnel

Si vous gérez d'autres projets sous SVN

• Installation du plugin SVN pour Eclipse: SubClipse.

Pour cela, utiliser la procédure Find And Install et ajouter l'URL de mise à jour:

http://subclipse.tigris.org/install.html

ou bien

• Installation du plugin SVN pour Eclipse: Subversive

http://community.polarion.com/projects/subversive/download/eclipse/2.0/ganymede-site/ - [required] Subversive SVN Connectors
http://community.polarion.com/projects/subversive/download/integrations/ganymede-site/ - [optional] Subversive Integrations

Si vous désirez faire des scripts en Perl

• Installation du plugin Eclipse pour Perl: EPIC

Pour cela, utiliser la procédure Find And Install et ajouter l'URL de mise à jour: http://e-p-i-c.sourceforge.net/updates

Si vous désirez développer des modules avec le générateur UML2Dolibarr

Une méthode pour générer un module fonctionnel depuis l'UML est en cours de mise au point. Plus d'informations sur la page UML2Dolibarr - Générer un module par MDA. Pour l'utiliser, vous devez installer les composants suivants (si vous avez installé la version d'Eclipse recommandé plus haut, tout ceci est déjà fait):

• Installation de TopCased 1.4 ou +: http://www.topcased.org

• Installation d'acceleo 2.2.1 ou +

Pour cela, utiliser la procédure Find And Install et ajouter l'URL de mise à jour: http://www.acceleo.org/update/

• Installation d'UML2Dolibarr

Pour cela, récupérer les projets par la commande:

svn checkout svn://svn.forge.objectweb.org/svnroot/acceleo/trunk/modules/community/uml21/dolibarr/trunk/

et les importer dans Eclipse.

Si vous êtes sous Windows

• Notepad++ (pour ceux qui ne supportent pas java ou utilisent un vieux coucou trop faible pour Eclipse).

• WinMerge (pour la comparaison de fichiers ou répertoires)

• CygWin (pour la commande patch et la commande en ligne cvs si vous préferez les lignes de commandes)

Si vous désirez faire du debuggage et tunning avec XDebug

• Installer xdebug

Sous Ubuntu: Installer le package php-xdebug

Sous Wampserver/Windows, téléchargé le fichier php_debug_xxx.dll sur http://www.xdebug.org et le placer dans le répertoire ext de php de WampServer.

• Modifier le fichier php.ini (ou xdebug.ini) pour ajouter les paramètres:

[xdebug]
xdebug.remote_enable=on
xdebug.remote_handle=dbgp
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.profiler_enable=1
xdebug.show_local_vars=off
xdebug.profiler_output_dir=c:/temp
xdebug.profiler_append=0

• Ensuite pour analyser les fichiers de profiling générés par XDebug, vous pouvez installer KCacheGrind (Linux) ou WinCacheGrind (Windows).

Pour développer ou utiliser les tests PHPUnit

• Télécharge l'archive de la version sur http://pear.phpunit.de/get/ et dézipper le contenu dans un répertoire inclus dans le peramètre include_path de votre fichier de configuration php.ini.
• Préparer le script phpunit:
  • Renommer le script phpunit.php script en phpunit.
  • Remplacer la chaine @php_bin@ dans ce fichier avec le chamin complet de la ligne de commande de l'interpréteur PHP (en général /usr/bin/php).
  • Copier le fichier dans un répertoire qui se trouve dans votre PATH et donnez lui les permissions de s'exécuter (chmod +x phpunit).
• Préparer le script PHPUnit/Util/PHP.php:
  • Remplacer la chaine @php_bin@ dans ce fichier avec le chamin complet de la ligne de commande de l'interpréteur PHP (en général /usr/bin/php).

Configuration

Si vous êtes un développeur officiel avec accès CVS en écriture, ajouter dans la configuration CVS de votre Eclipse, une entrée CVS.

• :ext:yourlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr pour la version principale de Dolibarr
• :ext:yourlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarrmod pour les modules externes

Sinon il vous faut récupérer les sources depuis le tarball disponible sur le site web Dolibarr ( http://www.dolibarr.fr ) dans l'espace téléchargement