Use different SQLite versions in CI

Author: JanJakes

.github/workflows/phpunit-tests-run.yml

@@ -17,6 +17,11 @@ on:
         required: false
         type: 'string'
         default: 'phpunit.xml.dist'
+      sqlite:
+        description: 'SQLite version to install (e.g., 3.24.0). Leave empty for latest version.'
+        required: false
+        type: 'string'
+        default: 'latest'
 env:
   LOCAL_PHP: ${{ inputs.php }}-fpm
   PHPUNIT_CONFIG: ${{ inputs.phpunit-config }}
@@ -31,12 +36,42 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Set up SQLite
+        run: |
+          VERSION='${{ inputs.sqlite }}'
+          if [ "$VERSION" = 'latest' ]; then
+            TAG='release'
+          else
+            TAG="version-${VERSION}"
+          fi
+          wget -O sqlite.tar.gz "https://sqlite.org/src/tarball/sqlite.tar.gz?r=${TAG}"
+          tar xzf sqlite.tar.gz
+          cd sqlite
+          ./configure --prefix=/usr/local CFLAGS="-DSQLITE_ENABLE_COLUMN_METADATA -DSQLITE_ENABLE_FTS5 -DSQLITE_USE_URI" LDFLAGS="-lm"
+          make -j$(nproc)
+          sudo make install
+          sudo ldconfig
+
       - name: Set up PHP
         uses: shivammathur/setup-php@v2
         with:
           php-version: '${{ inputs.php }}'
           tools: phpunit-polyfills
 
+      - name: Verify SQLite version in PHP
+        run: |
+          EXPECTED='${{ inputs.sqlite }}'
+          if [ "$EXPECTED" = 'latest' ]; then
+            EXPECTED=$(cat sqlite/VERSION)
+          fi
+          PDO=$(php -r "echo (new PDO('sqlite::memory'))->query('SELECT SQLITE_VERSION();')->fetch()[0];")
+          echo "Expected SQLite version: $EXPECTED"
+          echo "PHP PDO SQLite version:  $PDO"
+          if [ "$EXPECTED" != "$PDO" ]; then
+            echo "Error: Expected SQLite version $EXPECTED, but PHP PDO uses $PDO"
+            exit 1
+          fi
+
       - name: Install Composer dependencies
         uses: ramsey/composer-install@v3
         with:

.github/workflows/phpunit-tests.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
   test:
-    name: PHP ${{ matrix.php }}
+    name: PHP ${{ matrix.php }} / SQLite ${{ matrix.sqlite }}
     uses: ./.github/workflows/phpunit-tests-run.yml
     permissions:
       contents: read
@@ -18,8 +18,21 @@ jobs:
       matrix:
         os: [ ubuntu-latest ]
         php: [ '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4', '8.5' ]
+        include:
+          # Add specific SQLite versions for specific PHP versions here:
+          - php: '7.2'
+            sqlite: '3.27.0' # minimum version with WP_SQLITE_UNSAFE_ENABLE_UNSUPPORTED_VERSIONS
+          - php: '7.3'
+            sqlite: '3.34.1' # Debian 11 (Bullseye), common with PHP < 8.1
+          - php: '7.4'
+            sqlite: '3.37.0' # minimum supported version (STRICT table support)
+          - php: '8.0'
+            sqlite: '3.40.1' # Debian 12 (Bookworm)
+          - php: '8.1'
+            sqlite: '3.46.1' # Debian 13 (Trixie), Ubuntu >= 24.10
 
     with:
       os: ${{ matrix.os }}
       php: ${{ matrix.php }}
+      sqlite: ${{ matrix.sqlite || 'latest' }}
       phpunit-config: ${{ 'phpunit.xml.dist' }}

tests/bootstrap.php

@@ -8,6 +8,12 @@
 require_once __DIR__ . '/../wp-includes/sqlite/class-wp-sqlite-pdo-user-defined-functions.php';
 require_once __DIR__ . '/../wp-includes/sqlite/class-wp-sqlite-translator.php';
 
+// When on an older SQLite version, enable unsafe back compatibility.
+$sqlite_version = ( new PDO( 'sqlite::memory:' ) )->query( 'SELECT SQLITE_VERSION();' )->fetch()[0];
+if ( version_compare( $sqlite_version, WP_PDO_MySQL_On_SQLite::MINIMUM_SQLITE_VERSION, '<' ) ) {
+	define( 'WP_SQLITE_UNSAFE_ENABLE_UNSUPPORTED_VERSIONS', true );
+}
+
 // Configure the test environment.
 error_reporting( E_ALL );
 define( 'FQDB', ':memory:' );