README.md



To learn more about this project, read the wiki.


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

Mise à jour lib custom
Exécuter composer require sl-projects/laravel-lib:dev-master.

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

Configuration des projets multiples
Comme le projet est dépendant de quelques paquets développés en interne, il est nécessaire de configurer PHPStorm pour
vous faciliter leur développement en simultané.

Ouvrez les préférences de PHPStorm (Ctrl + Alt + S)
Allez dans Version Control

Allez dans Directory Mappings

Cliquez sur + puis Directory

Sélectionnez le dossier du projet sous-jacent
Cliquez sur OK


Vous devriez voir apparaître les multiples projets Git dans l'onglet vcs de PHPStorm. À présent, vous devriez pouvoir
créer des branches sur les différents projets simultanément.


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é de CLI Interpreter

Cliquez sur + puis From Docker, Vagrant, VM, Remote...

Sélectionnez Docker Compose

Dans le champ Service, sélectionnez le container app

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 + puis PHPUnit 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