feat: use Doctrine DBAL to query a SQLite database

Author: COil

.env

@@ -23,3 +23,13 @@ APP_SECRET=
 # To test the production environment, run "make go-prod" or "castor symfony:go-prod"
 
 # To come back to the development environment, run "make go-dev" or "castor symfony:go-dev"
+
+###> doctrine/doctrine-bundle ###
+# Format described at https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
+# IMPORTANT: You MUST configure your server version, either here or in config/packages/doctrine.yaml
+#
+# DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
+# DATABASE_URL="mysql://app:!ChangeMe!@127.0.0.1:3306/app?serverVersion=8.0.32&charset=utf8mb4"
+# DATABASE_URL="mysql://app:!ChangeMe!@127.0.0.1:3306/app?serverVersion=10.11.2-MariaDB&charset=utf8mb4"
+DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
+###< doctrine/doctrine-bundle ###

Makefile

@@ -37,16 +37,21 @@ go-dev: ## Switch to the development environment
 warmup: ## Warmup the dev cache for the static analysis
 	@bin/console c:w --env=dev
 
-purge: ## Purge all Symfony cache and logs
+purge: ## Purge all Symfony variable data
 	@rm -rf ./var/cache/* ./var/logs/* ./var/coverage/*
 
+load-fixtures: ## Reset migrations and load the database fixtures
+	@rm -f ./var/data.db
+	@bin/console doctrine:migration:migrate --env=dev --no-interaction
+	@bin/console app:load-fixtures --env=dev --no-interaction
+
 
 ## —— Tests ✅ —————————————————————————————————————————————————————————————————
 test: ## Run all PHPUnit tests
 	@vendor/bin/phpunit
 
 coverage: ## Generate the HTML PHPUnit code coverage report (stored in var/coverage)
-coverage: purge
+coverage: purge load-fixtures
 	@XDEBUG_MODE=coverage php -d xdebug.enable=1 -d memory_limit=-1 vendor/bin/phpunit --coverage-html=var/coverage --coverage-clover=var/coverage/clover.xml
 	@php bin/coverage-checker.php var/coverage/clover.xml $(COVERAGE_THRESHOLD)
 

castor.php

@@ -96,10 +96,23 @@ function purge(): void
     success(exit_code('rm -rf ./var/cache/* ./var/logs/* ./var/coverage/*'));
 }
 
+#[AsTask(namespace: 'app', description: 'Load the database fixtures', aliases: ['load-fixtures'])]
+function loadFixures(): void
+{
+    title('app:load-fixtures');
+    io()->note('Resetting db...');
+    success(exit_code('rm -f ./var/data.db'));
+    io()->note('Running db migrations...');
+    success(exit_code('bin/console doctrine:migration:migrate --no-interaction'));
+    io()->note('Load fixtures...');
+    success(exit_code('bin/console app:load-fixtures --no-interaction'));
+}
+
 #[AsTask(name: 'all', namespace: 'test', description: 'Run all PHPUnit tests', aliases: ['test'])]
 function test_all(): int
 {
     title('test:all');
+    loadFixures();
     $ec = exit_code(__DIR__.'/vendor/bin/phpunit');
     io()->writeln('');
 
@@ -110,6 +123,7 @@ function test_all(): int
 function coverage(): int
 {
     title('test:coverage');
+    loadFixures();
     $ec = exit_code('php -d xdebug.enable=1 -d memory_limit=-1 vendor/bin/phpunit --coverage-html=var/coverage --coverage-clover=var/coverage/clover.xml',
         context: context()->withEnvironment(['XDEBUG_MODE' => 'coverage'])
     );
@@ -241,6 +255,7 @@ function ci(): void
 {
     title('ci:all');
     purge();
+    loadFixures();
     io()->section('Coverage');
     coverage();
     io()->section('Lints');

composer.json

@@ -22,6 +22,9 @@
         "ext-mbstring": "*",
         "ext-simplexml": "*",
         "ext-xml": "*",
+        "doctrine/dbal": "^4.0",
+        "doctrine/doctrine-bundle": "^2.13",
+        "doctrine/doctrine-migrations-bundle": "^3.3",
         "league/commonmark": "^2.4",
         "symfony/asset": "~7.2.0",
         "symfony/asset-mapper": "~7.2.0",