Skip to content

v3.1.0

Choose a tag to compare

View all tags
@pdphilip pdphilip released this 05 Apr 23:47
· 7 commits to main since this release
v3.1.0
ff8d816

Future-proofing note: After GitHub incorrectly shadow-banned my account (since reinstated with no
explanation beyond "it shouldn't happen again"), all packages are now mirrored to GitLab. GitHub
remains the home for issues, PRs, and community collaboration, but Packagist downloads exclusively
from GitLab to ensure uninterrupted access to releases regardless of GitHub's actions.

This release is compatible with Laravel 11, 12 & 13

Added

  • Laravel 13 support (including 13.3 HasCollection compatibility)
  • Query String Queries — searchQueryString(), orSearchQueryString(), searchNotQueryString(),
    orSearchNotQueryString() with full QueryStringOptions support -
    Docs
  • Track Total Hits — withTrackTotalHits(bool|int|null) to override the default 10k hit count cap
  • Docs
  • Create or Fail — createOrFail() throws BulkInsertQueryException (409) on duplicate IDs
    instead of upserting - Docs
  • Set Refresh Flag — withRefresh(true|false|'wait_for') to control index refresh behavior on
    writes - Docs
  • Create Only — createOnly() and withOpType('create') for dedupe insert semantics with
    per-document _op_type support
  • Time-Ordered IDs — GeneratesTimeOrderedIds trait for sortable, chronologically-ordered
    20-character IDs - Docs
  • QueryStringOptions and SimpleQueryStringOptions classes
  • Composer test scripts: composer test:l11, composer test:l12, composer test:l13, composer test:all

Fixed

  • QueryException crash on Undefined array key "error" when OpenSearch returns responses without
    the expected error.type structure
  • BulkInsertQueryException crash on op_type=create — bulk response uses create key, not
    index; now uses array_key_first() with proper 409 status code inference
  • Field mapping resolution — getFieldsMapping() now uses _mapping API instead of
    _mapping/field/* (OpenSearch PHP client returns empty for wildcard field queries)
  • hasColumns() — iterates individual field checks instead of comma-separated query (same
    OpenSearch PHP client limitation)
  • Geo bounding box test (wrong field name + double .get() call)

Changed

  • Dropped Laravel 10 support (EOL)
  • PHP minimum bumped from 8.2 to 8.3
  • Compat layer refactored: consolidated Laravel/v11/ and Laravel/v12/ directories into 4
    self-contained traits in Laravel/Compatibility/ using inline version checks with spread operators
  • newCollection() override on base Model to prevent L13.3 HasCollection abstract class
    instantiation
  • opensearch-project/opensearch-php updated to ^2.6
  • PHPStan baseline regenerated (36 entries, down from 61 — opensearch-php class casing fix)

Full Changelog: v3.0.3...v3.1.0

Assets 2
Loading