#Table of contents

• Installer Laravel
  • Launch install with Laravel Installer
  • Laravel est installé 🎉
  • Vérifier que l'installation est OK
• Installation de FilamentPHP
  • Créer le premier utilisateur
  • Vérification de l'installation
• Changer le nom de l'application

Dans cette petite série, nous allons apprendre les bases de Laravel à travers une petite application LinKeeper.

Son but est de garder vos liens et de les partager avec le monde entier.

Alors, de quoi avons-nous besoin ?

Nous devons apporter des solutions à ces use cases :

• un utilisateur peut s'identifier, se connecter, se déconnecter et gérer son compte
• un utilisateur peut voir la liste des liens qui lui sont associés
• un utilisateur peut ajouter, modifier ou supprimer un lien
• un utilisateur peut avoir un lien partageable pour partager ses liens avec le monde entier
• un lien a un nom, un statut (publié ou non) et évidemment une url. Nous ajouterons peut-être d'autres options plus tard.

Le but ici est de découvrir les concepts de base de Laravel et FilamentPHP.

Dans cette série, j'utiliserai Laravel 11 et FilamentPHP 3.

Commençons par le plus basique : l'installation.

#Installer Laravel

Comme pour chaque projet Laravel, il faut commencer par installer Laravel.

Si vous avez le Laravel installer il suffit de taper la commande suivante dans votre terminal favori laravel new linkeeper

Si vous préférez composer, utilisez simplement cette commande à la place composer create-project laravel/laravel linkeeper

Suivez ces étapes, qui consistent à conserver les choix par défaut et à cliquer trois fois sur entrée 😉 .

#Launch install with Laravel Installer

#Laravel est installé 🎉

Comme nous avons choisi sqlite comme base de données, il n'y a pas d'autre configuration nécessaire, sauf APP_NAME, APP_TIMEZONE si vous le souhaitez.

Pour plus de simplicité, j'ai laissé les paramètres de langue avec la valeur par défaut. N'hésitez pas à les modifier si vous le souhaitez.

#Vérifier que l'installation est OK

Personnellement, je travaille sur Mac avec Herd. Je peux checker http://linkeeper.test sur mon navigateur.

Tout semble ok !

Si vous avez besoin de travailler avec https, c'est parfaitement possible avec Herd en un seul clic.

Allez dans les paramètres de Herd, choisissez l'onglet 'Sites' et cherchez votre url actuelle. Ici : linkeeper.test.

Cherchez le cadenas et cliquez dessus pour activer le https.

Facile, non ?

#Installation de FilamentPHP

Maintenant, nous devons installer FilamentPHP. Sincèrement, vous n'avez pas besoin de moi pour ces étapes, il vous suffit de regarder les incroyables documentations de Laravel et Filament.

Mais, si vous êtes déjà là, continuons à avancer ensemble 🤣.

Donc, il suffit de copier / coller le tutoriel 'Get Started' :

composer require filament/filament:"^3.2" -W
 
php artisan filament:install --panels

Laissez le choix par défaut lorsque Filament demande un identifiant :

Et voilà! Filament est installé.

#Créer le premier utilisateur

Nous avons besoin d'un utilisateur pour pouvoir commencer à jouer avec Filament.

php artisan make:filament-user

Ici aussi laissez vous guider et répondez aux question concernant votre nom, votre email et votre mot de passe.

#Vérification de l'installation

Cliquons sur le lien fourni pour nous assurer que tout est en ordre.

Entrez vos informations d'identification et si tout va bien, vous verrez quelque chose comme ça :

#Changer le nom de l'application

Comme vous pouvez le voir dans le coin supérieur gauche, le nom de l'application est "Laravel", changeons le pour "LinKeeper".

Ouvrez votre projet dans votre IDE favori ou si vous préférez pour ce changement mineur, tapez simplement nano .env dans votre terminal.

Vous devez juste changer la clé APP_NAME :

Si le nom souhaité contient des espaces, vous devez utiliser les guillemets pour votre nom.

ctrl + x pour quitter, dites 'yes' lorsque nano vous demande si vous voulez sauvegarder votre fichier et confirmez le nom du fichier (.env) en appuyant sur la touche retour.

Votre fichier .env est maintenant sauvegardé, vous pouvez recharger votre page et vous verrez que le nom de l'application a changé dans le coin supérieur gauche.

C'est la fin de cette première partie. Dans le prochain épisode, nous verrons comment commencer à jouer avec le filament et les modèles.

N'hésitez pas à commenter si vous avez des questions ou si vous voyez une erreur.