Minimaler Blog

Minimal Blog ist ein einfacher Blog mit minimalistischer Benutzeroberfläche. Ein Benutzer kann in Kategorien wechseln, Artikel lesen und über den Kommentarbereich mit dem Autor interagieren. Der Autor des Blogs hat über ein sicheres Admin-Dashboard die vollständige Kontrolle über jeden Inhalt.

Dieses Projekt wurde erstellt, um einige meiner Fähigkeiten zu zeigen, wie zum Beispiel:

Grundlegende Integration mit TailwindCSS-Elementen
CRUD für Kategorien, Beiträge, Kommentare, Newsletter
Sicherheit (Authentifizierung, Autorisierung, Wähler)
Zollelemente (Slugifier-Service, Twig-Erweiterung für Datumsangaben, Validator, Querybuilder...)
Doktrin-Paginatoren
Asynchrone Nachrichten (Newsletter-E-Mails) mit Messenger und RabbitMQ über Docker
Testabdeckung (Unit- und Funktionstests) mit PHPUnit

Legen Sie los

Voraussetzungen

PHP 8.1 oder höher (Symfony 6.1)
Komponist
Garn / NodeJS
Docker

Installieren

Klonen Sie dieses Projekt
Installieren Sie Abhängigkeiten mit composer install und yarn install
Erstellen Sie Ihre .env.local und fügen Sie Ihren eigenen Datenbank-DSN hinzu
Erstellen Sie eine Datenbank, wenden Sie Migrationen an und füllen Sie sie mit Fixtures: bin/console doctrine:database:create bin/console doctrine:migrations:migrate bin/console doctrine:fixtures:load

Arbeiten

Führen Sie docker-compose up aus, um Docker-Images zu starten (Mailcatcher und RabbitMQ-Server).
Bearbeiten Sie Ihre .env.local , indem Sie RABBITMQ_DSN und MAILER_DSN aktualisieren. Sie können sie finden, indem Sie Folgendes ausführen: symfony var:export --multiline | grep 'MAILER_DSN|RABBITMQ_DSN'
Führen Sie yarn run dev --watch aus, um Ihren lokalen Server für Assets zu starten
Führen Sie symfony serve aus, um Ihren lokalen PHP-Webserver zu starten
Erledigt ! Überprüfen Sie Ihren Localhost-Server: http://127.0.0.1:8000/

Asynchrone Nachrichten konsumieren

Führen Sie symfony open:local:rabbitmq und symfony open:local:webmail um den RabbitMQ-Server und den Web-Mailcatcher zu starten
Melden Sie sich bei RabbitMQ mit den Anmeldeinformationen an: guest:guest
Um Nachrichten an RabbitMQ zu senden, melden Sie sich als Administrator an ( [email protected]:admin ), gehen Sie dann zum Admin-Dashboard und klicken Sie auf „Newsletter“. Dort wird eine Schaltfläche „Senden“ angezeigt. Pro Abonnent wird eine Nachricht gesendet den Newsletter (Standard 50).
Führen Sie bin/console messenger:consume -vv async aus, um Nachrichten in RabbitMQ zu konsumieren. Sie werden nach und nach gesendet und im Mailcatcher angezeigt.

Testen

Standardmäßig funktionieren alle Tests mit Fixtures, vergessen Sie also nicht, diese zu laden!

Aktualisieren Sie Ihren .env.test und fügen Sie Ihren Testdatenbank-DSN hinzu
Erstellen Sie eine Datenbank, wenden Sie Migrationen an und füllen Sie sie mit Fixtures: bin/console doctrine:database:create --env=test bin/console doctrine:migrations:migrate --env=test bin/console doctrine:fixtures:load --env=test
Führen Sie bin/phpunit aus, um die Testbatterie zu starten