Outils de développement - Revision history

Eric.seigne: stubs

2026-04-20T13:35:29Z

stubs

← Older revision		Revision as of 13:35, 20 April 2026
Line 89:		Line 89:
	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...		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...

	Tout ceci se passe par la récupération des stubs depuis https://packagist.org/packages/caprel/dolibarr-stubs.		Tout ceci se passe par la récupération des stubs depuis https://packagist.org/packages/caprel/dolibarr-stubs-all.

	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		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
Line 122:		Line 122:
	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.		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.

	'''ATTENTION : SUR MACOS, UN COMMIT INCLUANT DES FICHIERS DE LANGUE EMPÊCHERA LE FONCTIONNEMENT DE PRE-COMMIT'''		'''ATTENTION<span> </span>: SUR MACOS, UN COMMIT INCLUANT DES FICHIERS DE LANGUE EMPÊCHERA LE FONCTIONNEMENT DE PRE-COMMIT'''

	=[[File:Computer.png]] Optionnel=		=[[File:Computer.png]] Optionnel=
	Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.		Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.
	Voir la page [[Outils de développement - Composants optionnels]].		Voir la page [[Outils de développement - Composants optionnels]].

Bfaliere: /* Git Hooks */

2026-01-15T11:21:29Z

Git Hooks

← Older revision		Revision as of 11:21, 15 January 2026
Line 122:		Line 122:
	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.		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.

	'''~~<big>~~ATTENTION : SUR MACOS, UN COMMIT INCLUANT DES FICHIERS DE LANGUE EMPÊCHERA LE FONCTIONNEMENT DE PRE-COMMIT~~</big>~~'''		'''ATTENTION : SUR MACOS, UN COMMIT INCLUANT DES FICHIERS DE LANGUE EMPÊCHERA LE FONCTIONNEMENT DE PRE-COMMIT'''

	=[[File:Computer.png]] Optionnel=		=[[File:Computer.png]] Optionnel=
	Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.		Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.
	Voir la page [[Outils de développement - Composants optionnels]].		Voir la page [[Outils de développement - Composants optionnels]].

Bfaliere: Warning pre-commit et macos pour les fichiers de langue.

2026-01-15T11:20:58Z

Warning pre-commit et macos pour les fichiers de langue.

← Older revision		Revision as of 11:20, 15 January 2026
Line 121:		Line 121:

	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.		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.

			'''<big>ATTENTION : SUR MACOS, UN COMMIT INCLUANT DES FICHIERS DE LANGUE EMPÊCHERA LE FONCTIONNEMENT DE PRE-COMMIT</big>'''

	=[[File:Computer.png]] Optionnel=		=[[File:Computer.png]] Optionnel=
	Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.		Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.
	Voir la page [[Outils de développement - Composants optionnels]].		Voir la page [[Outils de développement - Composants optionnels]].

Eldy: /* Chrome ou Firefox et plugins */

2025-04-02T09:44:35Z

Chrome ou Firefox et plugins

← Older revision		Revision as of 09:44, 2 April 2025
Line 27:		Line 27:
	==Chrome ou Firefox et plugins==		==Chrome ou Firefox et plugins==

	*Chrome		*Chrome + plugins de votre choix

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

	*Firefox ~~avec les~~ plugins:		*Firefox + plugins de votre choix
	**Firebug + Firecookie + FirePHP,
	**HTML Validator,
	**User agent switcher pour simuler des accès depuis un smartphone
	**Selenium IDE
	**Cert Viewer Plus si vous comptez faire des tests en HTTPS,
	**QuickProxy si vous voulez basculer rapidement votre ~~navigateur vers des utilitaires Proxy (WebScarab)...~~

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

Bfaliere: /* Modules complémentaires */

2025-02-24T16:28:25Z

Modules complémentaires

← Older revision		Revision as of 16:28, 24 February 2025
Line 86:		Line 86:
	*phpdoc-comment		*phpdoc-comment
	*PHPUnit		*PHPUnit
	*PHP CS Fixer		*[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/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/mhutchie/git-graph Git Graph]

Bfaliere: Ajout de liens vers les modules

2025-02-24T15:49:21Z

Ajout de liens vers les modules

← Older revision		Revision as of 15:49, 24 February 2025
Line 83:		Line 83:
	Voici la liste des modules complémentaire conseillés:		Voici la liste des modules complémentaire conseillés:

	*PHP Intelephense		*[https://open-vsx.org/extension/bmewburn/vscode-intelephense-client PHP Intelephense]
	*phpdoc-comment		*phpdoc-comment
	*PHPUnit		*PHPUnit
	*PHP CS Fixer		*PHP CS Fixer
	*EditorConfig for VSCode pour que la configuration du projet définie dans le fichier .editorconfig soit utilisée automatiquement		*[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
	*Git Graph		*[https://open-vsx.org/extension/mhutchie/git-graph Git Graph]
	*PHP Debug pour utiliser XDebug directement dans Codium		*[https://open-vsx.org/extension/xdebug/php-debug PHP Debug] pour utiliser XDebug directement dans Codium

	====Stubs ou extraits de codes====		====Stubs ou extraits de codes====

Bfaliere: Ajout de modules complémentaires dans la liste pour Codium.

2025-02-24T15:45:40Z

Ajout de modules complémentaires dans la liste pour Codium.

← Older revision		Revision as of 15:45, 24 February 2025
Line 87:		Line 87:
	*PHPUnit		*PHPUnit
	*PHP CS Fixer		*PHP CS Fixer
			*EditorConfig for VSCode pour que la configuration du projet définie dans le fichier .editorconfig soit utilisée automatiquement
			*Git Graph
			*PHP Debug pour utiliser XDebug directement dans Codium

	====Stubs ou extraits de codes====		====Stubs ou extraits de codes====

Eldy: /* Installer le hook git Pre-commit */

2025-02-15T02:33:38Z

Installer le hook git Pre-commit

← Older revision		Revision as of 02:33, 15 February 2025
Line 120:		Line 120:
	https://github.com/Dolibarr/dolibarr/tree/develop/dev/setup/pre-commit		https://github.com/Dolibarr/dolibarr/tree/develop/dev/setup/pre-commit

	~~En résumé pour Debian/Ubuntu:~~
	~~<syntaxhighlight lang="bash">~~
	~~sudo apt install php-codesniffer~~
	~~sudo apt install python3~~
	~~sudo apt install pip~~
	~~sudo pip install --user pre-commit --break-system-packages~~
	~~</syntaxhighlight>~~

	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).		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).

Eldy: /* Installer le hook git Pre-commit */

2025-02-14T22:17:54Z

Installer le hook git Pre-commit

← Older revision		Revision as of 22:17, 14 February 2025
Line 119:		Line 119:

	https://github.com/Dolibarr/dolibarr/tree/develop/dev/setup/pre-commit		https://github.com/Dolibarr/dolibarr/tree/develop/dev/setup/pre-commit

			En résumé pour Debian/Ubuntu:
			<syntaxhighlight lang="bash">
			sudo apt install php-codesniffer
			sudo apt install python3
			sudo apt install pip
			sudo pip install --user pre-commit --break-system-packages
			</syntaxhighlight>

	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).		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).

Eldy: /* Installer le hook git Pre-commit */

2024-06-30T10:31:27Z

Installer le hook git Pre-commit

← Older revision		Revision as of 10:31, 30 June 2024
Line 113:		Line 113:

	===Installer le hook git Pre-commit===		===Installer le hook git Pre-commit===
	L'utilisation de ce hook git est essentiel pour vérifier la syntaxe des fichiers qui sont commité et pouvoir annuler celui-ci si la syntaxe est mauvaise. Si phpcs et phpcbf sont installés, les erreurs de formatage de code peuvent être modifiées automatiquement. Voici comment faire:

	~~Dans votre dépôt GIT local, copiez le fichier '''./dev/setup/git/~~hooks~~/pre-commit''' dans le dossier '''.~~git~~/hooks'''~~ (à la ~~racine de votre dépôt git local) et rendez-le exécutable~~.		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.

	~~Ensuite, il est nécessaire d'éditer le fichier '''pre~~-~~commit''' présent dans '''.git/hooks''' du projet Dolibarr pour modifier la variable DIRPHPCS afin d'ajouter le chemin des outils phpcs et phpcbf (le laisser vide si les outils~~ sont ~~déjà~~ disponibles ~~dans la variable PATH).~~		Les instructions pour installer un tel hook de pré-validation sont disponibles sur ce fichier :

	~~Ce type~~ de ~~hook est utilisé lorsqu~~'~~on utilise~~ l'~~invité~~ de ~~commande mais aussi lorsque qu'un commit est créé avec un~~ IDE commun (~~exemple~~ Eclipse et ~~Virtual Studio Code~~). Une fois installé, le hook démarrera lors de votre prochain commit pour reformater votre code, ~~pour~~ 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.		https://github.com/Dolibarr/dolibarr/tree/develop/dev/setup/pre-commit

			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).

			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.

	=[[File:Computer.png]] Optionnel=		=[[File:Computer.png]] Optionnel=
	Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.		Vous pouvez aussi installer des composants optionnels pour avoir le support de technologies suplémentaires.
	Voir la page [[Outils de développement - Composants optionnels]].		Voir la page [[Outils de développement - Composants optionnels]].