Blog minimal

Minimal Blog est un blog simple conçu avec une interface minimaliste. Un utilisateur peut accéder à des catégories, lire des articles et interagir avec l'auteur via la section des commentaires. L'auteur du blog a un contrôle total sur chaque contenu via un tableau de bord d'administration sécurisé.

Ce projet a été créé afin de montrer certaines de mes compétences comme :

Intégration de base avec les éléments TailwindCSS
CRUD sur les catégories, articles, commentaires, newsletters
Sécurité (authentification, autorisation, électeurs)
Éléments douaniers (service slugifier, extension twig pour les dates, validateur, querybuilders...)
Paginateurs de doctrine
Messages asynchrones (e-mails de newsletter) avec Messenger et RabbitMQ via Docker
Couverture de tests (tests unitaires et fonctionnels) avec PHPUnit

Commencer

Conditions préalables

PHP 8.1 ou supérieur (Symfony 6.1)
Compositeur
Fil / NodeJS
Docker

Installer

Cloner ce projet
Installer les dépendances avec composer install et yarn install
Créez votre .env.local et ajoutez votre propre base de données DSN
Créez une base de données, appliquez les migrations et remplissez-la avec des appareils : bin/console doctrine:database:create bin/console doctrine:migrations:migrate bin/console doctrine:fixtures:load

Fonctionnement

Exécutez docker-compose up pour démarrer les images Docker (mailcatcher et serveur RabbitMQ)
Modifiez votre .env.local en mettant à jour RABBITMQ_DSN et MAILER_DSN , vous pouvez les trouver en exécutant : symfony var:export --multiline | grep 'MAILER_DSN|RABBITMQ_DSN'
Exécutez yarn run dev --watch pour lancer votre serveur local pour les ressources
Exécutez symfony serve pour lancer votre serveur Web php local
Fait ! Vérifiez votre serveur localhost : http://127.0.0.1:8000/

Consommer des messages asynchrones

Exécutez symfony open:local:rabbitmq et symfony open:local:webmail pour démarrer le serveur RabbitMQ et le web mailcatcher
Connectez-vous à RabbitMQ avec les informations d'identification : guest:guest
Pour envoyer des messages à RabbitMQ, connectez-vous en tant qu'administrateur ( [email protected]:admin ) puis allez dans le tableau de bord d'administration et cliquez sur "Newsletter", vous verrez un bouton "Envoyer", il enverra 1 message par abonné à la newsletter (par défaut 50).
Exécutez bin/console messenger:consume -vv async pour consommer les messages dans RabbitMQ, ils seront progressivement envoyés et affichés dans le mailcatcher.

Essai

Par défaut, tous les tests fonctionnent avec des luminaires, alors n'oubliez pas de les charger !

Mettez à jour votre .env.test et ajoutez votre base de données de test DSN
Créez une base de données, appliquez les migrations et remplissez-la avec des appareils : bin/console doctrine:database:create --env=test bin/console doctrine:migrations:migrate --env=test bin/console doctrine:fixtures:load --env=test
Exécutez bin/phpunit pour lancer la batterie de tests