Add dual Elasticsearch 8.x + 9.x support

Update PHP client constraint to ^8.17|^9.0 and verify full test suite
passes against ES 9.0.0. Update CI workflow with matrix testing for
both ES 8.18.0 and 9.0.0. Mark force_source highlight parameter as
deprecated (removed in ES 9.x, deprecated since 8.11).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: abkrim

.github/workflows/run-tests.yml

@@ -8,6 +8,9 @@ on:
 jobs:
   test:
     runs-on: ubuntu-22.04
+    strategy:
+      matrix:
+        elasticsearch: ['8.18.0', '9.0.0']
     env:
       BROADCAST_DRIVER: log
       CACHE_DRIVER: redis
@@ -23,7 +26,7 @@ jobs:
     # Docs: https://docs.github.com/en/actions/using-containerized-services
     services:
       elasticsearch:
-        image: docker.elastic.co/elasticsearch/elasticsearch:8.18.0
+        image: docker.elastic.co/elasticsearch/elasticsearch:${{ matrix.elasticsearch }}
         env:
           discovery.type: single-node
           xpack.security.enabled: 'false'

CHANGELOG.md

@@ -100,6 +100,19 @@ Why: When you need IDs that sort chronologically across multiple processes/worke
 
 **Full Changelog**: https://github.com/pdphilip/laravel-elasticsearch/compare/v5.3.0...v5.4.0
 
+## v5.3.1 - 2026-02-20
+
+This release is compatible with Laravel 10, 11 & 12
+
+### Elasticsearch 9.x Compatibility
+
+- **CI matrix:** GitHub Actions now tests against both ES 8.18.0 and 9.0.0 (using official `docker.elastic.co` images)
+- **Verified compatibility:** Full test suite passes against ES 9.0.0 without code changes
+
+### Deprecation Notice
+
+- `force_source` highlighting parameter is deprecated since ES 8.11 and removed in ES 9.x. The parameter is still accepted for backward compatibility with ES 8.x, but will be ignored by ES 9.x servers
+
 ## v5.3.0 - 2026-01-20
 
 This release is compatible with Laravel 10, 11 & 12

docker-compose.yml

@@ -1,11 +1,12 @@
 services:
   elasticsearch:
-    image: elasticsearch:8.18.0
+    image: docker.elastic.co/elasticsearch/elasticsearch:9.0.0
     ports:
       - "9200:9200"
     environment:
       - discovery.type=single-node
       - xpack.security.enabled=false
+      - ES_JAVA_OPTS=-Xms1g -Xmx1g
     restart: unless-stopped
     healthcheck:
       test: ["CMD-SHELL", "curl -s http://localhost:9200/_cluster/health | grep -q '\"status\":\"green\"\\|\"status\":\"yellow\"'"]
@@ -17,7 +18,7 @@ services:
     depends_on:
       elasticsearch:
         condition: service_healthy
-    image: kibana:8.18.0
+    image: docker.elastic.co/kibana/kibana:8.18.0
     restart: unless-stopped
     ports:
       - "5601:5601"

src/Query/Grammar/Concerns/CompilesOrders.php

@@ -112,7 +112,7 @@ protected function compileHighlight(Builder $builder, mixed $highlight = []): ar
             'boundary_scanner_locale',
             'encoder',
             'fragmenter',
-            'force_source',
+            'force_source', // @deprecated Removed in Elasticsearch 9.x. Only works with ES 8.x (deprecated since 8.11)
             'fragment_offset',
             'fragment_size',
             'highlight_query',