J4.x:Setting Up Your Local Environment/fr

Didacticiel
Comment paramétrer un environnement local pour Joomla 4

Joomla! 

4.x

Avec Joomla 4, nous avons changé le processus de développement, il n'est plus possible de cloner le dépôt et d'avoir une installation Joomla utilisable. Nous suivons ici les meilleures pratiques et avons mis en place un processus de construction pour le CMS.

Guide d'installation rapide

La configuration de environnement de développement dépend de votre système d'exploitation. Nous ne pouvons pas écrire de documentation pour tous les systèmes d'exploitation donc vous devriez pouvoir trouver des manuels sur votre moteur de recherche préféré.

Outils nécessaires

1. PHP - fondamentalement le même que celui dont vous avez besoin pour exécuter un site Joomla, mais vous avez besoin de la version PHP CLI (interface en ligne de commande) (voir la page Configuration d'un serveur LAMPP pour le développement PHP).
2. Composer - pour gérer les dépendances PHP de Joomla - pour obtenir de l'aide à l'installation de Composer, lisez la documentation sur https://getcomposer.org/doc/00-intro.md
3. Node.js - pour compiler les fichiers JavaScript et SASS de Joomla - pour obtenir de l'aide pour installer Node.js, veuillez suivre les instructions disponibles sur https://nodejs.org/en/
4. Git - pour la gestion des versions

Etapes pour paramétrer votre environnement local

1. Cloner le dépôt
2. exécutez composer install depuis la racine du dépôt git (vous pouvez ajouter --ignore-platform-reqs si vous n'avez pas le PHP-LDAP installé localement et que vous n'en avez pas besoin).
3. exécutez npm install depuis la racine du dépot git.

Guide d'installation un peu plus détaillé

Joomla n'est pas différent de beaucoup d'autres outils web de nos jours. Il a une grande partie PHP et il a de plus en plus de code JavaScript. Alors que le codage PHP n'a pas besoin d'autant de préparation, JavaScript a besoin de beaucoup d'outils. La raison principale est que personne n'écrit le code d'une manière que chaque navigateur comprend, de sorte que le code doit être transposé, par exemple de ES6 à une version compatible de JavaScript. La même chose est vraie pour le CSS, pour Joomla nous utilisons SASS et ceci sera converti en CSS natif pour que n'importe quel navigateur le comprenne. Comme la mise en place d'un environnement de développement est un peu plus compliquée, mais l'outillage rend le codage plus pratique. Grâce aux observateurs et à la recharge automatique de votre navigateur, vous pouvez voir votre changement en temps réel.

PHP

Il devrait suffire d'exécuter composer install car cela installera les dépendances PHP indiquées dans le fichier composer.lock. Vous pouvez le faire autant de fois que vous le souhaitez, il n'installera de nouveaux paquets que lorsque le fichier composer.lock sera modifié. N'exécutez pas composer update car cela mettra à jour tous les paquets vers des versions plus récentes et mettra à jour le fichier composer.lock.

Note: You may need to run composer install with the --ignore-platform-reqs option to ignore platform requirements specified in Composer, i.e. if you do not have PHP's LDAP extension installed.

Scripts Node/npm

Node.js comes with a package manager called NPM (in some way the same as Composer). NPM has a run command and we have prepared some scripts to make your life easier. You have to run the commands for the root of the repository.

npm run build:css

It will compile SASS files to CSS and also create the minified files.

npm run build:js

It will compile and transpile the JavaScript files to the correct format and create minified files

npm run watch:css

This is the same as the build:css command but will watch for changes and automatically build updated files.

npm run watch:js

This is the same as the build:js command but will watch for changes and automatically build updated files.

npm run lint:js

This will make a syntax check on JavaScript files.

test d'exécution npm

Ceci lancera d'autres suites de test JavaScript.