Minimal Blog

Minimal Blog is a simple blog designed with a minimalist interface. A user can move into categories, read articles and interact with the author through comment section. The author of the blog has complete control on every content via a secure admin dashboard.

This project was created in order to show some of my skills like :

Basic integration with TailwindCSS elements
CRUD on categories, posts, comments, newsletters
Security (authentification, authorization, voters)
Customs elements (slugifier service, twig extension for dates, validator, querybuilders...)
Doctrine paginators
Async messages (newsletter emails) with Messenger and RabbitMQ via Docker
Test covering (unit and functionnal tests) with PHPUnit

Get Started

Prerequisites

PHP 8.1 or higher (Symfony 6.1)
Composer
Yarn / NodeJS
Docker

Install

Clone this project
Install dependencies with composer install and yarn install
Create your .env.local and add your own database DSN
Create database, apply migrations, and fill it with fixtures : bin/console doctrine:database:create bin/console doctrine:migrations:migrate bin/console doctrine:fixtures:load

Working

Run docker-compose up to start Docker images (mailcatcher and RabbitMQ server)
Edit your .env.local by updating RABBITMQ_DSN and MAILER_DSN, you can find them by running : symfony var:export --multiline | grep 'MAILER_DSN|RABBITMQ_DSN'
Run yarn run dev --watch to launch your local server for assets
Run symfony serve to launch your local php web server
Done ! Check your localhost server : http://127.0.0.1:8000/

Consume asynchronous messages

Run symfony open:local:rabbitmq and symfony open:local:webmail to start RabbitMQ server and the web mailcatcher
Login to RabbitMQ with credentials : guest:guest
To send messages to RabbitMQ, log in as admin ([email protected]:admin) then go in the Admin Dashboard and click on "Newsletter", you'll see a "Send" button, it will send 1 message per subscriber to the newsletter (default 50).
Run bin/console messenger:consume -vv async to consume messages in RabbitMQ, they will progressively being sent and displayed in the mailcatcher.

Testing

By default, all tests work with fixtures, so don't forget to load them !

Update your .env.test and add your test database DSN
Create database, apply migrations, and fill it with fixtures : bin/console doctrine:database:create --env=test bin/console doctrine:migrations:migrate --env=test bin/console doctrine:fixtures:load --env=test
Run bin/phpunit to launch the battery of tests