Add dual Elasticsearch 8.x + 9.x support (rebased on v5.4.1)

Update PHP client constraint to ^8.17|^9.0 and CI workflow with matrix
testing for both ES 8.18.0 and 9.0.0. Docker images use official
docker.elastic.co registry. 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

@@ -2,6 +2,19 @@
 
 All notable changes to this `laravel-elasticsearch` package will be documented in this file.
 
+## v5.4.2 - 2026-02-24
+
+### Elasticsearch 9.x Compatibility
+
+- **PHP client constraint:** Updated to `^8.17|^9.0` to support both Elasticsearch 8.x and 9.x PHP clients
+- **CI matrix:** GitHub Actions now tests against both ES 8.18.0 and 9.0.0 (using official `docker.elastic.co` images)
+- **Docker:** Local development uses ES 9.0.0 with 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.4.1 - 2026-02-23
 
 ### Fixed

composer.json

@@ -24,7 +24,7 @@
     "illuminate/database": "^10.30|^11|^12",
     "illuminate/events": "^10.0|^11|^12",
     "illuminate/support": "^10.0|^11|^12",
-    "elasticsearch/elasticsearch": "^8.17",
+    "elasticsearch/elasticsearch": "^8.17|^9.0",
     "spatie/ignition": "^1.15",
     "pdphilip/omniterm": "^2"
   },

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',