Site vitrine Rann Graphic Design
Installation
Docker est nécessaire pour lancer l'environnement de dev.
Lancer la commande docker-compose up -d
pour lancer les containers. Le container principal installe automatiquement
les dépendances du projet, mais il est nécessaire de lancer les commandes suivantes s'il s'agit d'une première
installation :
cp .env.example .env
php artisan key:generate
php artisan migrate
NOTE POUR OUINEDAUSE : Il faut lancer composer avec composer install --ignore-platform-reqs
pour éviter les erreurs d'incompatibilité.
Information Font Awesome
L'utilisation de Font Awesome sur les vues Blade est possible via l'utilisation du composant spécialement créé pour l'occasion. Il est possible de l'utiliser de la manière suivante :
<x-font-awesome icon="bars" type="solid"/>
Pour des raisons d'optimisation, les icônes sont enregistrées dans un fichier de configuration généré à partir du fichier manifest de Font Awesome, converti en tableau PHP.
En raison de l'énorme taille du fichier, l'IDE n'est pas en mesure de l'indéxer correctement, et d'ailleurs il est déconseillé de le faire. Les manipulations de ce fichier sont très lourdes et ne doivent être faites qu'en cas de nécessité absolue.
Actuellement, la version de Font Awesome utilisée est la 6.6.0 (Pro) et seuls les styles solid, regular et brands sont disponibles.
IDE
Actuellement, le projet est configuré pour fonctionner avec PHPStorm. Il est possible de l'utiliser avec d'autres IDE, mais il faudra adapter la configuration.
PHPStorm
Les fichiers de configuration pour PHPStorm sont déjà présents dans le projet. Tout est versionné, ne soyez pas surpris et ne tentez pas de supprimer ces fichiers.
Vous pouvez commit les modifications apportées à ces fichiers par l'IDE.
Laravel Idea
Il est recommandé d'installer le plugin, il est gratuit pour les étudiants.
Configuration
Interpréteur PHP
Il est nécessaire de renseigner le container Docker comme interpréteur PHP. Pour cela, suivez les étapes suivantes :
- Ouvrez les préférences de PHPStorm (Ctrl + Alt + S)
- Allez dans
PHP
- Cliquez sur
...
à côté deCLI Interpreter
- Cliquez sur
+
puisFrom Docker, Vagrant, VM, Remote...
- Sélectionnez
Docker Compose
- Dans le champ
Service
, sélectionnez le containerapp
- Cliquez sur
OK
Note : Pour le lifecycle, préférez l'attachement à un container existant.
Configuration de PHPUnit
Comme nous utilisons l'interpréteur PHP du container Docker, il est nécessaire de configurer PHPUnit pour qu'il utilise le container Docker. Normalement, c'est automatique, mais si ce n'est pas le cas, suivez les étapes suivantes :
- Ouvrez les préférences de PHPStorm (Ctrl + Alt + S)
- Allez dans
PHP
- Cliquez sur
Test Frameworks
- Cliquez sur
+
puisPHPUnit by Remote Interpreter
- Sélectionnez l'interpréteur PHP
app
que nous avons précédemment configuré - Cliquez sur
OK
Note : Au cas où PHPStorm ne trouve pas Composer, il est possible de le spécifier manuellement. Son chemin est
vendor/autoload.php
.
Identifiants SSH
- Utilisateur :
root
- Mot de passe :
password