feat(database): Add the database component

.github/workflows/codecoverage.yml

@@ -1,8 +1,39 @@
 name: Code Coverage
-on: [ push, pull_request ]
+
+on: [ pull_request ]
+
 jobs:
   run:
     runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
+      mysql_secondary:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test_port
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3307:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -15,8 +46,45 @@ jobs:
       - name: Install dependencies
         run: composer self-update && composer install && composer dump-autoload
 
+      - name: Start MySQL socket container
+        run: |
+          mkdir -p /tmp/mysql_socket
+          chmod 777 /tmp/mysql_socket
+          docker run -d \
+            --name mysql_socket \
+            -e MYSQL_ROOT_PASSWORD=secret \
+            -e MYSQL_DATABASE=engine_test_socket \
+            -e MYSQL_USER=engine \
+            -e MYSQL_PASSWORD=secret \
+            -v /tmp/mysql_socket:/var/run/mysqld \
+            mysql:8.4
+          for i in $(seq 1 30); do
+            docker exec mysql_socket mysqladmin ping -u root -psecret -h 127.0.0.1 --silent 2>/dev/null && break
+            sleep 2
+          done
+          for i in $(seq 1 10); do
+            [ -S /tmp/mysql_socket/mysqld.sock ] && break
+            sleep 1
+          done
+          [ -S /tmp/mysql_socket/mysqld.sock ] || { echo "ERROR: socket file not found"; docker logs mysql_socket; exit 1; }
+          docker exec mysql_socket mysql -u root -psecret -h 127.0.0.1 -e "
+            CREATE USER IF NOT EXISTS 'engine'@'localhost' IDENTIFIED BY 'secret';
+            GRANT ALL PRIVILEGES ON \`engine_test_socket\`.* TO 'engine'@'localhost';
+            FLUSH PRIVILEGES;
+          "
+
       - name: Run tests and collect coverage
         run: vendor/bin/phpunit --coverage-clover coverage.xml --log-junit junit.xml
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: 3306
+          DB_DATABASE: engine_test
+          DB_USERNAME: engine
+          DB_PASSWORD: secret
+          DB_PORT_SECONDARY: 3307
+          DB_DATABASE_SECONDARY: engine_test_port
+          DB_SOCKET: /tmp/mysql_socket/mysqld.sock
+          DB_DATABASE_SOCKET: engine_test_socket
 
       - name: Upload coverage to Codecov
         if: ${{ !cancelled() }}

.github/workflows/integration.yml

@@ -0,0 +1,138 @@
+name: Integration Tests
+
+on: [ pull_request ]
+
+jobs:
+  connection:
+    name: Connection (MySQL 8.4)
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
+      mysql_secondary:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test_port
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3307:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up php 8.5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+
+      - name: Install dependencies
+        run: composer self-update && composer install && composer dump-autoload
+
+      - name: Start MySQL socket container
+        run: |
+          mkdir -p /tmp/mysql_socket
+          chmod 777 /tmp/mysql_socket
+          docker run -d \
+            --name mysql_socket \
+            -e MYSQL_ROOT_PASSWORD=secret \
+            -e MYSQL_DATABASE=engine_test_socket \
+            -e MYSQL_USER=engine \
+            -e MYSQL_PASSWORD=secret \
+            -v /tmp/mysql_socket:/var/run/mysqld \
+            mysql:8.4
+          for i in $(seq 1 30); do
+            docker exec mysql_socket mysqladmin ping -u root -psecret -h 127.0.0.1 --silent 2>/dev/null && break
+            sleep 2
+          done
+          for i in $(seq 1 10); do
+            [ -S /tmp/mysql_socket/mysqld.sock ] && break
+            sleep 1
+          done
+          [ -S /tmp/mysql_socket/mysqld.sock ] || { echo "ERROR: socket file not found"; docker logs mysql_socket; exit 1; }
+          docker exec mysql_socket mysql -u root -psecret -h 127.0.0.1 -e "
+            CREATE USER IF NOT EXISTS 'engine'@'localhost' IDENTIFIED BY 'secret';
+            GRANT ALL PRIVILEGES ON \`engine_test_socket\`.* TO 'engine'@'localhost';
+            FLUSH PRIVILEGES;
+          "
+
+      - name: Run connection integration tests
+        run: vendor/bin/phpunit --testsuite Integration --group connection-factory
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: 3306
+          DB_DATABASE: engine_test
+          DB_USERNAME: engine
+          DB_PASSWORD: secret
+          DB_PORT_SECONDARY: 3307
+          DB_DATABASE_SECONDARY: engine_test_port
+          DB_SOCKET: /tmp/mysql_socket/mysqld.sock
+          DB_DATABASE_SOCKET: engine_test_socket
+
+  query-builder:
+    name: Query Builder (${{ matrix.image }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        include:
+          - image: mysql:8.0
+            health_cmd: mysqladmin ping
+          - image: mysql:8.4
+            health_cmd: mysqladmin ping
+          - image: mariadb:10.11
+            health_cmd: mysqladmin ping
+          - image: mariadb:11.4
+            health_cmd: healthcheck.sh --connect --innodb_initialized
+    services:
+      database:
+        image: ${{ matrix.image }}
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="${{ matrix.health_cmd }}"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up php 8.5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+
+      - name: Install dependencies
+        run: composer self-update && composer install && composer dump-autoload
+
+      - name: Run query builder integration tests
+        run: vendor/bin/phpunit --testsuite Integration --group query-builder
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: 3306
+          DB_DATABASE: engine_test
+          DB_USERNAME: engine
+          DB_PASSWORD: secret

.github/workflows/mutation-testing.yml

@@ -5,6 +5,35 @@ on: [ pull_request ]
 jobs:
   run:
     runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
+      mysql_secondary:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: secret
+          MYSQL_DATABASE: engine_test_port
+          MYSQL_USER: engine
+          MYSQL_PASSWORD: secret
+        ports:
+          - 3307:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=5s
+          --health-timeout=5s
+          --health-retries=10
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -18,5 +47,42 @@ jobs:
       - name: Install dependencies
         run: composer self-update && composer install && composer dump-autoload
 
+      - name: Start MySQL socket container
+        run: |
+          mkdir -p /tmp/mysql_socket
+          chmod 777 /tmp/mysql_socket
+          docker run -d \
+            --name mysql_socket \
+            -e MYSQL_ROOT_PASSWORD=secret \
+            -e MYSQL_DATABASE=engine_test_socket \
+            -e MYSQL_USER=engine \
+            -e MYSQL_PASSWORD=secret \
+            -v /tmp/mysql_socket:/var/run/mysqld \
+            mysql:8.4
+          for i in $(seq 1 30); do
+            docker exec mysql_socket mysqladmin ping -u root -psecret -h 127.0.0.1 --silent 2>/dev/null && break
+            sleep 2
+          done
+          for i in $(seq 1 10); do
+            [ -S /tmp/mysql_socket/mysqld.sock ] && break
+            sleep 1
+          done
+          [ -S /tmp/mysql_socket/mysqld.sock ] || { echo "ERROR: socket file not found"; docker logs mysql_socket; exit 1; }
+          docker exec mysql_socket mysql -u root -psecret -h 127.0.0.1 -e "
+            CREATE USER IF NOT EXISTS 'engine'@'localhost' IDENTIFIED BY 'secret';
+            GRANT ALL PRIVILEGES ON \`engine_test_socket\`.* TO 'engine'@'localhost';
+            FLUSH PRIVILEGES;
+          "
+
       - name: Run mutation testing
         run: composer mutation
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: 3306
+          DB_DATABASE: engine_test
+          DB_USERNAME: engine
+          DB_PASSWORD: secret
+          DB_PORT_SECONDARY: 3307
+          DB_DATABASE_SECONDARY: engine_test_port
+          DB_SOCKET: /tmp/mysql_socket/mysqld.sock
+          DB_DATABASE_SOCKET: engine_test_socket

.gitignore

@@ -1,5 +1,6 @@
 /vendor
 /composer.lock
 /build
+/tmp
 .phpunit.result.cache
 .php-cs-fixer.cache

composer.json

@@ -43,6 +43,7 @@
   "scripts"     : {
     "test"    : "@php vendor/bin/phpunit",
     "mutation": "@php vendor/bin/infection --threads=max --no-progress",
-    "analyze" : "@php vendor/bin/phpstan analyse src --memory-limit=2G"
+    "analyze" : "@php vendor/bin/phpstan analyse src --memory-limit=2G",
+    "tidy"    : "@php vendor/bin/php-cs-fixer fix"
   }
 }

docker-compose.yml

@@ -0,0 +1,45 @@
+services:
+  mysql:
+    image: mysql:8.4
+    environment:
+      MYSQL_ROOT_PASSWORD: secret
+      MYSQL_DATABASE: engine_test
+      MYSQL_USER: engine
+      MYSQL_PASSWORD: secret
+    ports:
+      - "3306:3306"
+    healthcheck:
+      test: [ "CMD", "mysqladmin", "ping", "-h", "localhost" ]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  mysql_secondary:
+    image: mysql:8.4
+    environment:
+      MYSQL_ROOT_PASSWORD: secret
+      MYSQL_DATABASE: engine_test_port
+      MYSQL_USER: engine
+      MYSQL_PASSWORD: secret
+    ports:
+      - "3307:3306"
+    healthcheck:
+      test: [ "CMD", "mysqladmin", "ping", "-h", "localhost" ]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+  mysql_socket:
+    image: mysql:8.4
+    environment:
+      MYSQL_ROOT_PASSWORD: secret
+      MYSQL_DATABASE: engine_test_socket
+      MYSQL_USER: engine
+      MYSQL_PASSWORD: secret
+    volumes:
+      - ./tmp/mysql_socket:/var/run/mysqld
+    healthcheck:
+      test: [ "CMD", "mysqladmin", "ping", "-S", "/var/run/mysqld/mysqld.sock" ]
+      interval: 5s
+      timeout: 5s
+      retries: 10