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:[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

@@ -37,9 +37,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 -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 tests with optional suite, filter and options (to debug use "make test options=--debug")
@@ -69,7 +74,7 @@ test-unit: testsuite=unit
 test-unit: test
 
 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,6 +96,18 @@ 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'));
+}
+
 const PHP_UNIT_CMD = '/vendor/bin/phpunit --testsuite=%s --filter=%s %s';
 const PHP_UNIT_SUITES = ['api', 'e2e', 'functional', 'integration', 'unit'];
 
@@ -111,6 +123,8 @@ function getParameters(): array
 function test_all(): int
 {
     title('test:all');
+    loadFixures();
+    $ec = exit_code(__DIR__.'/vendor/bin/phpunit');
     [$filter, $options] = getParameters();
     $ec = exit_code(__DIR__.sprintf(PHP_UNIT_CMD, implode(',', PHP_UNIT_SUITES), $filter, $options));
     io()->writeln('');
@@ -177,6 +191,7 @@ function test_unit(
 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'])
     );
@@ -308,6 +323,7 @@ function ci(): void
 {
     title('ci:all');
     purge();
+    loadFixures();
     io()->section('Coverage');
     coverage();
     io()->section('Lints');

composer.json

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