Add PostgreSQL database driver

.github/workflows/cs.yml

@@ -1,23 +1,25 @@
 name: CS
 
 on:
-  # Run on all relevant pushes (except to main) and on all relevant pull requests.
+  # Run on all relevant pushes and pull requests.
   push:
     paths:
       - '**.php'
+      - '.github/workflows/**'
+      - 'bin/verify-workflow-ci-gates.js'
       - 'composer.json'
       - 'composer.lock'
       - '.phpcs.xml.dist'
       - 'phpcs.xml.dist'
-      - '.github/workflows/cs.yml'
   pull_request:
     paths:
       - '**.php'
+      - '.github/workflows/**'
+      - 'bin/verify-workflow-ci-gates.js'
       - 'composer.json'
       - 'composer.lock'
       - '.phpcs.xml.dist'
       - 'phpcs.xml.dist'
-      - '.github/workflows/cs.yml'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 
@@ -55,6 +57,11 @@ jobs:
       - name: Validate Composer installation
         run: composer validate --no-check-all
 
+      - name: Verify workflow CI gates
+        env:
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+        run: composer run verify-workflow-ci-gates
+
       # Install dependencies and handle caching in one go.
       # @link https://github.com/marketplace/actions/install-composer-dependencies
       - name: Install Composer dependencies

.github/workflows/end-to-end-tests.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - trunk
   pull_request:
 
 # Disable permissions for all available scopes by default.
@@ -34,8 +35,12 @@ jobs:
         run: npx playwright install --with-deps
 
       - name: Run end-to-end tests
+        env:
+          WP_TEST_DB_BACKEND: sqlite
         run: composer run test-e2e
 
       - name: Stop Docker containers
         if: always()
+        env:
+          WP_TEST_DB_BACKEND: sqlite
         run: composer run wp-test-clean

.github/workflows/lexer-benchmark.yml

@@ -24,7 +24,8 @@ jobs:
     timeout-minutes: 15
     permissions:
       contents: read # Required to clone the repo.
-      pull-requests: write # Required to post/update the result comment.
+      issues: write # Required to post/update the result comment.
+      pull-requests: write # Required to inspect pull request metadata.
 
     steps:
       - name: Checkout repository
@@ -84,8 +85,10 @@ jobs:
             echo '```'
           } > "$RUNNER_TEMP/comment.md"
           echo "COMMENT_FILE=$RUNNER_TEMP/comment.md" >> "$GITHUB_ENV"
+          cat "$RUNNER_TEMP/comment.md" >> "$GITHUB_STEP_SUMMARY"
 
       - name: Post or update the PR comment
+        if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
         uses: actions/github-script@v7
         with:
           script: |

.github/workflows/phpunit-tests.yml

@@ -3,6 +3,7 @@ name: PHPUnit Tests
 on:
   push:
     branches:
+      - main
       - trunk
     paths:
       - '.github/workflows/phpunit-tests.yml'
@@ -30,9 +31,9 @@ permissions: {}
 jobs:
   test:
     # The pure-PHP parser is exercised across the full PHP/SQLite range; the
-    # native Rust parser extension is exercised on PHP 8.0+ (its minimum). Both
-    # run the same mysql-on-sqlite suite, just with a different parser engine.
-    name: PHP ${{ matrix.php }}${{ matrix.extension && ' + ext-wp-mysql-parser' || '' }} / SQLite ${{ matrix.sqlite }}
+    # native Rust parser extension is exercised on PHP 8.0+ (its minimum).
+    # PostgreSQL-specific tests run in one bounded adapter lane.
+    name: PHP ${{ matrix.php }}${{ matrix.extension && ' + ext-wp-mysql-parser' || '' }} / SQLite ${{ matrix.sqlite }} / ${{ matrix.testsuite }}
     runs-on: ubuntu-latest
     timeout-minutes: 30
     permissions:
@@ -43,22 +44,24 @@ jobs:
         include:
           # Pure-PHP parser, across the supported PHP versions, each pinned to a
           # representative SQLite version spanning the supported range.
-          - { php: '7.2', sqlite: '3.27.0', extension: false } # minimum with WP_SQLITE_UNSAFE_ENABLE_UNSUPPORTED_VERSIONS
-          - { php: '7.3', sqlite: '3.31.1', extension: false } # Ubuntu 20.04 LTS
-          - { php: '7.4', sqlite: '3.34.1', extension: false } # Debian 11 (Bullseye)
-          - { php: '8.0', sqlite: '3.37.0', extension: false } # minimum supported version (STRICT tables)
-          - { php: '8.1', sqlite: '3.40.1', extension: false } # Debian 12 (Bookworm)
-          - { php: '8.2', sqlite: '3.45.1', extension: false } # Ubuntu 24.04 LTS
-          - { php: '8.3', sqlite: '3.46.1', extension: false } # Debian 13 (Trixie)
-          - { php: '8.4', sqlite: '3.51.2', extension: false } # First 2026 release
-          - { php: '8.5', sqlite: 'latest', extension: false }
+          - { php: '7.2', sqlite: '3.27.0', extension: false, testsuite: default } # minimum with WP_SQLITE_UNSAFE_ENABLE_UNSUPPORTED_VERSIONS
+          - { php: '7.3', sqlite: '3.31.1', extension: false, testsuite: default } # Ubuntu 20.04 LTS
+          - { php: '7.4', sqlite: '3.34.1', extension: false, testsuite: default } # Debian 11 (Bullseye)
+          - { php: '8.0', sqlite: '3.37.0', extension: false, testsuite: default } # minimum supported version (STRICT tables)
+          - { php: '8.1', sqlite: '3.40.1', extension: false, testsuite: default } # Debian 12 (Bookworm)
+          - { php: '8.2', sqlite: '3.45.1', extension: false, testsuite: default } # Ubuntu 24.04 LTS
+          - { php: '8.3', sqlite: '3.46.1', extension: false, testsuite: default } # Debian 13 (Trixie)
+          - { php: '8.4', sqlite: '3.51.2', extension: false, testsuite: default } # First 2026 release
+          - { php: '8.5', sqlite: 'latest', extension: false, testsuite: default }
+          # PostgreSQL adapter tests run once in a bounded package lane.
+          - { php: '8.3', sqlite: '3.46.1', extension: false, testsuite: postgresql }
           # Native Rust parser extension (requires PHP 8.0+).
-          - { php: '8.0', sqlite: '3.37.0', extension: true }
-          - { php: '8.1', sqlite: '3.40.1', extension: true }
-          - { php: '8.2', sqlite: '3.45.1', extension: true }
-          - { php: '8.3', sqlite: '3.46.1', extension: true }
-          - { php: '8.4', sqlite: '3.51.2', extension: true }
-          - { php: '8.5', sqlite: 'latest', extension: true }
+          - { php: '8.0', sqlite: '3.37.0', extension: true, testsuite: default }
+          - { php: '8.1', sqlite: '3.40.1', extension: true, testsuite: default }
+          - { php: '8.2', sqlite: '3.45.1', extension: true, testsuite: default }
+          - { php: '8.3', sqlite: '3.46.1', extension: true, testsuite: default }
+          - { php: '8.4', sqlite: '3.51.2', extension: true, testsuite: default }
+          - { php: '8.5', sqlite: 'latest', extension: true, testsuite: default }
 
     steps:
       - name: Checkout repository
@@ -179,10 +182,15 @@ jobs:
         if: matrix.extension
         env:
           WP_SQLITE_REQUIRE_NATIVE_PARSER_EXTENSION: '1'
-        run: php -d extension="$GITHUB_WORKSPACE/packages/php-ext-wp-mysql-parser/target/release/libwp_mysql_parser.so" ./vendor/bin/phpunit -c ./phpunit.xml.dist
+        run: php -d extension="$GITHUB_WORKSPACE/packages/php-ext-wp-mysql-parser/target/release/libwp_mysql_parser.so" ./vendor/bin/phpunit -c ./phpunit.xml.dist --testsuite default
         working-directory: packages/mysql-on-sqlite
 
       - name: Run PHPUnit suite
-        if: ${{ ! matrix.extension }}
-        run: php ./vendor/bin/phpunit -c ./phpunit.xml.dist
+        if: ${{ ! matrix.extension && matrix.testsuite == 'default' }}
+        run: php ./vendor/bin/phpunit -c ./phpunit.xml.dist --testsuite default
+        working-directory: packages/mysql-on-sqlite
+
+      - name: Run PostgreSQL PHPUnit suite
+        if: ${{ matrix.testsuite == 'postgresql' }}
+        run: php ./vendor/bin/phpunit -c ./phpunit.xml.dist --testsuite postgresql
         working-directory: packages/mysql-on-sqlite

.github/workflows/wp-tests-end-to-end.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - trunk
   pull_request:
 
 # Disable permissions for all available scopes by default.
@@ -12,11 +13,17 @@ permissions: {}
 
 jobs:
   test:
-    name: WordPress End-to-end Tests
+    name: WordPress End-to-end Tests / ${{ matrix.backend }}
     runs-on: ubuntu-latest
-    timeout-minutes: 20
+    timeout-minutes: 60
     permissions:
       contents: read # Required to clone the repo.
+    strategy:
+      fail-fast: false
+      matrix:
+        backend:
+          - sqlite
+          - postgresql
 
     steps:
       - name: Checkout repository
@@ -34,8 +41,34 @@ jobs:
         run: npx playwright install --with-deps
 
       - name: Run WordPress end-to-end tests
+        env:
+          WP_TEST_DB_BACKEND: ${{ matrix.backend }}
+          WP_POSTGRESQL_E2E_REQUEST_DIAGNOSTICS: ${{ matrix.backend == 'postgresql' && '1' || '0' }}
         run: composer run wp-test-e2e
 
+      - name: Dump WordPress Docker logs
+        if: failure()
+        env:
+          WP_TEST_DB_BACKEND: ${{ matrix.backend }}
+          LOCAL_DB_TYPE: mysql
+          LOCAL_PHP_MEMCACHED: 'false'
+          COMPOSE_IGNORE_ORPHANS: 'true'
+        run: npm --prefix wordpress run env:logs || true
+
+      - name: Upload Playwright artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: wp-e2e-${{ matrix.backend }}-artifacts
+          path: |
+            wordpress/artifacts
+            wordpress/src/wp-content/debug.log
+          if-no-files-found: ignore
+
       - name: Stop Docker containers
         if: always()
+        env:
+          WP_TEST_DB_BACKEND: ${{ matrix.backend }}
+          LOCAL_DB_TYPE: mysql
+          LOCAL_PHP_MEMCACHED: 'false'
         run: composer run wp-test-clean

.github/workflows/wp-tests-phpunit-native-extension-setup.sh

@@ -14,6 +14,11 @@ if [ ! -f "$COMPOSE_OVERRIDE" ]; then
 	exit 1
 fi
 
+if ! grep -Fq 'DB_ENGINE: sqlite' "$COMPOSE_OVERRIDE" || ! grep -Fq 'DATABASE_ENGINE: sqlite' "$COMPOSE_OVERRIDE"; then
+	echo "Stale $COMPOSE_OVERRIDE. Run WP_TEST_DB_BACKEND=sqlite composer run wp-setup before this helper." >&2
+	exit 1
+fi
+
 add_volume_to_service() {
 	local service="$1"
 	local volume="$2"