laravel blog

Blog Laravel 11.x

Le but de ce référentiel est de montrer les bonnes pratiques de développement sur Laravel ainsi que de présenter des cas d'utilisation des fonctionnalités du framework comme :

• Authentification
• API
  • Sanctuaire
  • Ressources API
  • Gestion des versions
• Lame
• Radiodiffusion
• Cache
• Vérification par e-mail
• Système de fichiers
• Aides
• Horizon
• Localisation
• Mail
• Migrations
• Politiques
• Fournisseurs
• Demandes
• Semis et usines
• Essai
• Propriété

Outre Laravel, ce projet utilise d'autres outils comme :

• Amorcer 5.x
• Pinte
• Police géniale
• Câblé
• Rédis
• spatie/laravel-medialibrary
• hotwired-laravel/turbo-laravel
• Beaucoup d'autres à découvrir.

Quelques captures d'écran

Vous pouvez retrouver quelques captures d'écran de l'application sur : https://imgur.com/a/Jbnwj

Installation

Pour créer votre environnement de développement, suivez ces instructions.

Configuration de votre environnement de développement sur votre machine locale :

$ git clone https://github.com/guillaumebriday/laravel-blog.git
$ cd laravel-blog
$ cp .env.example .env
$ php artisan key:generate
$ php artisan horizon:install
$ php artisan telescope:install
$ php artisan storage:link

Ouvrez maintenant http://laravel-blog.test.

Courrier

Vous pouvez utiliser Mailpit pour tester vos emails en développement.

Une fois installé, ouvrez http://localhost:8025.

Avant de commencer

Vous devez exécuter les migrations avec les graines :

$ php artisan migrate:fresh --seed

Cela créera un nouvel utilisateur que vous pourrez utiliser pour vous connecter :

 email : [email protected]
password : demodemo

Et puis, compilez les actifs :

$ yarn dev

Emploi de départ pour la newsletter :

$ php artisan tinker
> PrepareNewsletterSubscriptionEmail::dispatch ();

Commandes utiles

Démarrez Laravel Horizon :

$ php artisan horizon

Amorçage de la base de données :

$ php artisan db:seed

Tests en cours :

$ php artisan test

Exécution de Laravel Pint :

$ ./vendor/bin/pint --verbose --test

Génération de sauvegarde :

$ php artisan vendor:publish --provider= " SpatieBackupBackupServiceProvider "
$ php artisan backup:run

Générer de fausses données :

$ php artisan db:seed --class=DevDatabaseSeeder

Forfait Découverte

$ php artisan package:discover

Dans l'environnement de développement, reconstruisez la base de données :

$ php artisan migrate:fresh --seed

Accéder à l'API

Les clients peuvent accéder à l'API REST. Les requêtes API nécessitent une authentification via le jeton Bearer.

Générez un nouveau jeton :

curl --location --request POST ' laravel-blog.test/api/v1/authenticate?email=your_email&password=your_password ' 
     --header ' X-Requested-With: XMLHttpRequest '

Et maintenant, vous pouvez utiliser la clé meta.access_token comme jeton Bearer :

curl --location ' laravel-blog.test/api/v1/posts ' 
      --header ' X-Requested-With: XMLHttpRequest ' 
      --header ' Authorization: Bearer access_token '

Les API sont préfixées par api et le numéro de version de l'API comme ceci v1 .

N'oubliez pas de définir l'en-tête X-Requested-With sur XMLHttpRequest . Sinon, Laravel ne reconnaîtra pas l'appel comme une requête AJAX.

Pour lister toutes les routes disponibles pour l'API :

$ php artisan route:list --path=api

Contribuer

N'hésitez pas à contribuer au projet en adaptant ou en ajoutant des fonctionnalités ! Les rapports de bogues ou les demandes d'extraction sont les bienvenus.

Licence

Ce projet est publié sous licence MIT.