feat: use Doctrine DBAL to query a SQLite database

Author: COil

.env

@@ -23,3 +23,13 @@ APP_SECRET=3bUhVCRkHJfT2ZJTqBnvkclRFT1zy1ig
 # 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:[email protected]:3306/app?serverVersion=8.0.32&charset=utf8mb4"
+# DATABASE_URL="mysql://app:[email protected]:3306/app?serverVersion=10.11.2-MariaDB&charset=utf8mb4"
+DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
+###< doctrine/doctrine-bundle ###

Makefile

@@ -30,9 +30,14 @@ 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 -rf ./var/data.db
+	@bin/console d:m:m --env=dev --no-interaction
+	@bin/console a:l --env=dev --no-interaction
+
 
 ## —— Tests ✅ —————————————————————————————————————————————————————————————————
 test: ## Run all PHPUnit tests
@@ -41,7 +46,7 @@ test: ## Run all PHPUnit tests
 coverage: ## Generate the HTML PHPUnit code coverage report (stored in var/coverage)
 coverage: purge
 	@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 100
+	@php bin/coverage-checker.php var/coverage/clover.xml 84
 
 cov-report: var/coverage/index.html ## Open the PHPUnit code coverage report (var/coverage/index.html)
 	@open var/coverage/index.html

castor.php

@@ -89,6 +89,18 @@ function purge(): void
     success(exit_code('rm -rf ./var/cache/* ./var/logs/* ./var/coverage/*', quiet: false));
 }
 
+#[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', quiet: false));
+    io()->note('Running db migrations...');
+    success(exit_code('bin/console d:m:m --no-interaction', quiet: false));
+    io()->note('Load fixtures...');
+    success(exit_code('bin/console a:l --no-interaction', quiet: false));
+}
+
 #[AsTask(name: 'all', namespace: 'test', description: 'Run all PHPUnit tests', aliases: ['test'])]
 function test_all(): int
 {
@@ -113,7 +125,7 @@ function coverage(): int
         return $ec;
     }
 
-    return success(exit_code('php bin/coverage-checker.php var/coverage/clover.xml 100', quiet: false));
+    return success(exit_code('php bin/coverage-checker.php var/coverage/clover.xml 84', quiet: false));
 }
 
 #[AsTask(namespace: 'test', description: 'Open the PHPUnit code coverage report (var/coverage/index.html)', aliases: ['cov-report'])]
@@ -250,6 +262,7 @@ function ci(): void
 {
     title('ci:all');
     purge();
+    loadFixures();
     io()->section('Coverage');
     coverage();
     io()->section('Codings standards');

composer.json

@@ -21,6 +21,9 @@
         "ext-libxml": "*",
         "ext-simplexml": "*",
         "ext-xml": "*",
+        "doctrine/dbal": "^3",
+        "doctrine/doctrine-bundle": "^2.13",
+        "doctrine/doctrine-migrations-bundle": "^3.3",
         "league/commonmark": "^2.4",
         "symfony/asset": "~7.1.0",
         "symfony/asset-mapper": "~7.1.0",