added Docker Compose setup for database testing

Author: dg

.github/workflows/tests.yml

@@ -17,78 +17,18 @@ jobs:
 
         name: PHP ${{ matrix.php }} tests
 
-        services:
-            mysql57:
-                image: mysql:5.7
-                env:
-                    MYSQL_DATABASE: nette_test
-                    MYSQL_ROOT_PASSWORD: root
-                ports:
-                    - 3306:3306
-                options: >-
-                    --health-cmd "mysqladmin ping -ppass"
-                    --health-interval 10s
-                    --health-start-period 10s
-                    --health-timeout 5s
-                    --health-retries 10
-
-            mysql80:
-                image: mysql:8.0
-                ports:
-                    - 3307:3306
-                options: >-
-                    --health-cmd="mysqladmin ping -ppass"
-                    --health-interval=10s
-                    --health-timeout=5s
-                    --health-retries=5
-                    -e MYSQL_ROOT_PASSWORD=root
-                    -e MYSQL_DATABASE=nette_test
-
-            postgres96:
-                image: postgres:9.6
-                env:
-                    POSTGRES_USER: postgres
-                    POSTGRES_PASSWORD: postgres
-                    POSTGRES_DB: nette_test
-                ports:
-                    - 5432:5432
-                options: >-
-                    --health-cmd pg_isready
-                    --health-interval 10s
-                    --health-timeout 5s
-                    --health-retries 5
+        steps:
+            - uses: actions/checkout@v6
 
-            postgres13:
-                image: postgres:13
-                env:
-                    POSTGRES_USER: postgres
-                    POSTGRES_PASSWORD: postgres
-                    POSTGRES_DB: nette_test
-                ports:
-                    - 5433:5432
-                options: >-
-                    --health-cmd pg_isready
-                    --health-interval 10s
-                    --health-timeout 5s
-                    --health-retries 5
+            - name: Start database containers
+              run: docker compose up -d --wait --quiet-pull
 
-            mssql:
-                image: mcr.microsoft.com/mssql/server:latest
-                env:
-                    ACCEPT_EULA: Y
-                    SA_PASSWORD: YourStrong!Passw0rd
-                    MSSQL_PID: Developer
-                ports:
-                    - 1433:1433
-                options: >-
-                    --name=mssql
-                    --health-cmd "/opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P 'YourStrong!Passw0rd' -Q 'SELECT 1' -N -C"
-                    --health-interval 10s
-                    --health-timeout 5s
-                    --health-retries 5
+            - name: Create MS SQL Database
+              run: |
+                docker compose exec -T mssql /opt/mssql-tools18/bin/sqlcmd \
+                  -S localhost -U SA -P 'YourStrong!Passw0rd' \
+                  -Q 'CREATE DATABASE nette_test' -N -C
 
-        steps:
-            - uses: actions/checkout@v4
             - uses: shivammathur/setup-php@v2
               with:
                   php-version: ${{ matrix.php }}
@@ -97,10 +37,7 @@ jobs:
                   coverage: none
 
             - name: Create databases.ini
-              run: cp ./tests/databases.github.ini ./tests/Database/databases.ini
-
-            - name: Create MS SQL Database
-              run: docker exec -i mssql /opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P 'YourStrong!Passw0rd' -Q 'CREATE DATABASE nette_test' -N -C
+              run: cp ./tests/databases.docker.ini ./tests/Database/databases.ini
 
             - run: composer install --no-progress --prefer-dist
             - run: composer tester
@@ -115,7 +52,7 @@ jobs:
         name: Lowest Dependencies
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v4
+            - uses: actions/checkout@v6
             - uses: shivammathur/setup-php@v2
               with:
                   php-version: 8.1

docker-compose.yml

@@ -0,0 +1,56 @@
+services:
+    mysql:
+        image: mysql:8.0
+        ports:
+            - "3307:3306"
+        environment:
+            MYSQL_ROOT_PASSWORD: root
+            MYSQL_DATABASE: nette_test
+        healthcheck:
+            test: mysqladmin ping -proot
+            interval: 10s
+            timeout: 5s
+            retries: 5
+
+    postgres96:
+        image: postgres:9.6
+        ports:
+            - "5433:5432"
+        environment:
+            POSTGRES_USER: postgres
+            POSTGRES_PASSWORD: postgres
+            POSTGRES_DB: nette_test
+        healthcheck:
+            test: pg_isready
+            interval: 10s
+            timeout: 5s
+            retries: 5
+
+    postgres13:
+        image: postgres:13
+        ports:
+            - "5434:5432"
+        environment:
+            POSTGRES_USER: postgres
+            POSTGRES_PASSWORD: postgres
+            POSTGRES_DB: nette_test
+        healthcheck:
+            test: pg_isready
+            interval: 10s
+            timeout: 5s
+            retries: 5
+
+    mssql:
+        image: mcr.microsoft.com/mssql/server:2022-latest
+        ports:
+            - "1434:1433"
+        environment:
+            ACCEPT_EULA: "Y"
+            SA_PASSWORD: "YourStrong!Passw0rd"
+            MSSQL_PID: Developer
+        healthcheck:
+            test: /opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P 'YourStrong!Passw0rd' -Q 'SELECT 1' -N -C
+            interval: 10s
+            start_period: 30s
+            timeout: 5s
+            retries: 5

readme.md

@@ -43,6 +43,24 @@ composer require nette/database
 It requires PHP version 8.1 and supports PHP up to 8.5.
 
 
+Running Tests
+-------------
+
+Run tests against SQLite (no setup needed):
+
+```
+composer run tester
+```
+
+To test against MySQL, PostgreSQL, etc., start the Docker containers and copy the configuration:
+
+```
+docker compose up -d
+cp tests/databases.docker.ini tests/Database/databases.ini
+composer run tester
+```
+
+
 Usage
 -----
 

tests/databases.github.ini tests/databases.docker.initests/databases.github.ini renamed to tests/databases.docker.ini

@@ -1,31 +1,24 @@
-[mysql 5.7]
-dsn = "mysql:host=127.0.0.1;port=3306;dbname=nette_test"
-username = root
-password = root
-options[convertBoolean] = yes
-options[newDateTime] = yes
-
-[mysql 8.0]
+[mysql]
 dsn = "mysql:host=127.0.0.1;port=3307;dbname=nette_test"
 username = root
 password = root
 options[convertBoolean] = yes
 options[newDateTime] = yes
 
 [postgresql 9.6]
-dsn = "pgsql:host=127.0.0.1;port=5432;dbname=nette_test"
+dsn = "pgsql:host=127.0.0.1;port=5433;dbname=nette_test"
 username = postgres
 password = postgres
 options[newDateTime] = yes
 
 [postgresql 13]
-dsn = "pgsql:host=127.0.0.1;port=5433;dbname=nette_test"
+dsn = "pgsql:host=127.0.0.1;port=5434;dbname=nette_test"
 username = postgres
 password = postgres
 options[newDateTime] = yes
 
 [sqlsrv]
-dsn = "sqlsrv:Server=localhost,1433;Database=nette_test"
+dsn = "sqlsrv:Server=localhost,1434;Database=nette_test"
 username = SA
 password = "YourStrong!Passw0rd"
 options[newDateTime] = yes