Outils de développement: Difference between revisions

← Older edit

Outils de développement (view source)

Revision as of 13:35, 20 April 2026

2,375 bytes added , 6 months ago

stubs

VisualWikitext

Eric.seigne

417

edits

@@ Line 1: / Line 1: @@
-{{TemplateDocDev}}
+<!-- BEGIN interlang links -->
+<!-- Do NOT edit this section
+     Links below are automatically managed by PolyglotBot
+     You can edit links on the English source page : Environment_and_development_tools -->
+[[en:Environment_and_development_tools]]
+[[es:Herramientas_de_Desarrollo]]
+[[zh:开发环境与工具]]
+<!-- END interlang links -->
+{{TemplateDocDevFr}}
 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 tous ==
+=[[File:Eclipsephp.jpg]] Pour tout développeur=
 Voici le socle de travail recommandé, toutefois tout outil respectant les standards Web, PHP, Mysql peuvent faire l'affaire.
-* Firefox 3.0 avec les plugins: Tamper Data, HTMLValidator, Phplangeditor, Firebug + Firecookie.
+==Un serveur AMP==
+*Apache, MariaDB et PHP
+Sur Linux: Ces 3 produits sont disponibles dans toutes distributions.
+Sur Windows: Installez [http://www.wampserver.com/WampServer] (base MariaDB, Apache et PHP tout clé en main). Ce serveur WAMP offre le trio MariaDB + Apache + PHP, avec possibilité de basculer de version pour n'importe lequel de ces composants d'un simple clic).
+==Chrome ou Firefox et plugins==
+*Chrome + plugins de votre choix
+A télécharger depuis le site http://www.chrome.com
+*Firefox + plugins de votre choix
 A télécharger depuis le site http://www.firefox.com
-* SquirrelSql pour l'administration de base
+==Un outil d'accès aux bases de données==
-A télécharger depuis le site http://squirrelsql.sf.net
+Exemple:
+*SquirrelSQL pour l'administration de base - A télécharger depuis le site http://squirrel-sql.sf.net
+*DBeaver - https://dbeaver.io/
+==IDE (Eclipse, VSCode) et plugins==
+===Eclipse===
+====Installation d'Eclipse====
+Nous recommandons la version suivante d'Eclipse:
+{{DownloadEclipse}}
+Sinon toute version disponible sur le site [http://www.eclipse.org Eclipse] fait l'affaire.
+Une fois Eclipse installé, il est recommandé de modifier/vérifier les paramètres suivants:
+{{EclipseStandardSetup}}
+====Installation du plugin Eclipse pour PHP: PDT.====
+Avec certaines installations d'Eclipse, PDT peut etre installé depuis Help -> Install new software et choisir PDT.
+Si PDT n'est pas présent, si vous avez installé la version Eclipse ci-dessus, il suffit d'utiliser la procédure Help -> Install new software -> Add -> pour installer le package complémentaire:
+{{DownloadEclipsePDT}}
-* Installation d'Eclipse 3.2 ou 3.3
+Une fois PDT installé, il faut aussi le configurer dans Eclipse comme défini dans le chapitre [[Outils_de_développement_-_Composants_optionnels#Depuis_Eclipse]].
-A télécharger depuis le site http://www.eclipse.org
-* Installation du plugin Eclipse pour PHP: PDT.
+====Configurer Eclipse pour récupérer les sources====
-Pour cela, utiliser la procédure Find And Install et ajouter l'URL de mise à jour: http://download.eclipse.org/tools/pdt/updates/
+Une fois qu'Eclipse est installé, vous pouvez vous connecter au repository GIT pour y récupérer les dernières versions de développement.
-== Optionnel ==
+Pour cela, voir la page [[FAQ Récupérer, mettre à jours les sources GIT du projet]].
-=== Si vous gérez d'autres projets sous SVN ===
+===Codium===
-* Installation du plugin pour Eclipse pour SVN: SubClipse.
-Pour cela, utiliser la procédure Find And Install et ajouter l'URL de mise a jour: http://subclipse.tigris.org/install.html
-=== Si vous désirez faire des scripts en Perl ===
+Codium est la version Libre de VSCode, la documentation suivante s'appliquera donc probablement à vscode.
-* Installation du plugin Eclipse pour Perl: EPIC
-Pour cela, utiliser la procédure Find And Install et ajouter l'URL de mise a jour: http://e-p-i-c.sf.net/updates
-=== Si vous désirez développer des modules avec le générateur UML2Dolibarr ===
+====Modules complémentaires====
-* Vérifier dans Eclipse - Help - Software update - Manage Configuration que votre Eclipse contient les composants
+Voici la liste des modules complémentaire conseillés:
-- Si Eclipse 3.2:
-# EMF 2.2.2
-# UML2 2.0.3
-- Si Eclipse 3.3:
-# EMF 2.3.0
-# UML2 2.1.1
-Si non, les installer via la procédure '''Find And Install''' et choisir EMF et UML2 End-User.
+*[https://open-vsx.org/extension/bmewburn/vscode-intelephense-client PHP Intelephense]
+*phpdoc-comment
+*PHPUnit
+*[https://open-vsx.org/extension/junstyle/php-cs-fixer PHP CS Fixer]
+*[https://open-vsx.org/extension/EditorConfig/EditorConfig EditorConfig for VSCode] pour que la configuration du projet définie dans le fichier .editorconfig soit utilisée automatiquement
+*[https://open-vsx.org/extension/mhutchie/git-graph Git Graph]
+*[https://open-vsx.org/extension/xdebug/php-debug PHP Debug] pour utiliser XDebug directement dans Codium
-* Installation de TopCased 1.4
+====Stubs ou extraits de codes====
-Pour cela, utiliser la procédure '''Find And Install''' et ajouter l'URL de mise a jour:
-http://topcased-mm.gforge.enseeiht.fr/release/update-site3.3/
-* Installation d'acceleo 2.2.1
+Si vous développez des modules complémentaires pour dolibarr vous apprécierez d'avoir les définitions des fonctions et autres objets de dolibarr sans avoir à sourcer l'arborescence complète de dolibarr...
-Pour cela, utiliser la procédure '''Find And Install''' et ajouter l'URL de mise a jour:
-http://www.acceleo.org/update/
-* Installation d'UML2Dolibarr
+Tout ceci se passe par la récupération des stubs depuis https://packagist.org/packages/caprel/dolibarr-stubs-all.
-Pour cela, récupérer les projets par la commande:
-<pre>
-svn checkout svn://svn.forge.objectweb.org/svnroot/acceleo/trunk/modules/community/uml21/dolibarr/trunk/
-</pre>
-et les importer dans Eclipse.
-=== Si vous désirez faire du debuggage avec XDebug ===
+Une fois le stub téléchargé / ou installé en suivant la doc pensez à ajouter le fichier dolibarr-stubs dans la liste des stubs de votre codium, éditez le fichier ~/.config/VSCodium/User/settings.json
+ "intelephense.stubs": [
+  "apache",
+  "intl",
+  "standard",
+  "/media/erics/stockage/tmp/dolibarr/stubs",
+ ],
+ "intelephense.environment.includePaths": [
+  "/media/erics/stockage/tmp/dolibarr/stubs",
+ ],
+<br />
-* Installer xdebug (package php-xdebug sous Ubuntu)
+===VSCode===
-* Modifier le fichier php.ini (ou xdebug.ini) pour ajouter les paramètres
+===={{DownloadVSCode}}====
-- xdebug.remote_enable=1
-- xdebug.profiler_enable=1
+==Git Hooks==
-- xdebug.show_local_vars=1
+===Installer le hook git Pre-commit===
-=== Et si vous êtes sous Windows ===
+Vous pouvez utiliser des hooks git pour vérifier la syntaxe du fichier que vous validez et annuler (ou mieux corriger automatiquement) la validation si quelque chose ne va pas.
-* WampServer 2 (pour le base Mysql, Apache et PHP tout clé en main). Ce serveur WAMP offre le trio MySql+Apache+PHP installé en clé en main, avec possibilité de basculer de version pour n'importe lequel des ces composants d'un simple clic). Un must !
+Les instructions pour installer un tel hook de pré-validation sont disponibles sur ce fichier :
-* Notepad++ (pour ceux qui ne supportent pas java ou utilisent un vieux coucou trop faible pour Eclipse).
+https://github.com/Dolibarr/dolibarr/tree/develop/dev/setup/pre-commit
-* 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)
+De tels hooks fonctionneront lors d'une utilisation en ligne de commande, mais peuvent également fonctionner lors d'une validation à l'aide de votre IDE commun (il a été validé avec Eclipse et VSC).
-== Configuration ==
+Une fois installé, le hook démarrera lors de votre prochain commit pour reformater votre code, afin que votre code corresponde toujours aux règles de syntaxe de codage. Si tout le monde active ce hook, tout le monde utilisera la même règle de syntaxe de codage, il est donc fortement recommandé de l'activer si vous le pouvez. Si quelque chose ne va pas dans la syntaxe, la validation sera immédiatement annulée. S'il peut être corrigé automatiquement, phpcbf, installé lors de l'installation du hook de pré-validation, le corrigera donc il vous suffira de réessayer le commit une seconde fois pour le valider.
-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'''
+'''ATTENTION<span> </span>: SUR MACOS, UN COMMIT INCLUANT DES FICHIERS DE LANGUE EMPÊCHERA LE FONCTIONNEMENT DE PRE-COMMIT'''
-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
+=[[File:Computer.png]] Optionnel=
+Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.
+Voir la page [[Outils de développement - Composants optionnels]].