PHPackages                             zing/laravel-scout-opensearch - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. zing/laravel-scout-opensearch

ActiveLibrary[Search &amp; Filtering](/categories/search)

zing/laravel-scout-opensearch
=============================

Laravel Scout custom engine for OpenSearch

3.5.1(2mo ago)33340.2k—6.8%10[2 issues](https://github.com/zingimmick/laravel-scout-opensearch/issues)MITPHPPHP ^8.0CI passing

Since Aug 11Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/zingimmick/laravel-scout-opensearch)[ Packagist](https://packagist.org/packages/zing/laravel-scout-opensearch)[ Docs](https://github.com/zingimmick/laravel-scout-opensearch)[ Fund](https://www.paypal.com/paypalme/zingimmick)[ RSS](/packages/zing-laravel-scout-opensearch/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (27)Used By (0)

Laravel Scout OpenSearch
========================

[](#laravel-scout-opensearch)

[![Build Status](https://github.com/zingimmick/laravel-scout-opensearch/actions/workflows/tests.yml/badge.svg)](https://github.com/zingimmick/laravel-scout-opensearch/actions)[![Code Coverage](https://camo.githubusercontent.com/04f7407d5970e4a68b71824b1fbf2df7aa659a991e266e2b5c0c5f9dd9871541/68747470733a2f2f636f6465636f762e696f2f67682f7a696e67696d6d69636b2f6c61726176656c2d73636f75742d6f70656e7365617263682f6272616e63682f332e782f67726170682f62616467652e737667)](https://codecov.io/gh/zingimmick/laravel-scout-opensearch)[![Latest Stable Version](https://camo.githubusercontent.com/831cb572e72b5f8c0dbfddddceda08d5e03c2bf3ca87eeb27d648d45d190bc5a/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f6c61726176656c2d73636f75742d6f70656e7365617263682f762f737461626c652e737667)](https://packagist.org/packages/zing/laravel-scout-opensearch)[![Total Downloads](https://camo.githubusercontent.com/c66495a74945347e9dbc3a82b5d9de99cdfeb75473973897e2f6ed64b76e99d6/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f6c61726176656c2d73636f75742d6f70656e7365617263682f646f776e6c6f616473)](https://packagist.org/packages/zing/laravel-scout-opensearch)[![Latest Unstable Version](https://camo.githubusercontent.com/6e64d3d47008ee9a9db0a5d1bf9e1364088290c8ca490788a48e7385c98835a4/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f6c61726176656c2d73636f75742d6f70656e7365617263682f762f756e737461626c652e737667)](https://packagist.org/packages/zing/laravel-scout-opensearch)[![License](https://camo.githubusercontent.com/8d09bb9881601269b917af54ed39c0c5781bfa3b906b57cb24bb54caf7bc32a8/68747470733a2f2f706f7365722e707567782e6f72672f7a696e672f6c61726176656c2d73636f75742d6f70656e7365617263682f6c6963656e7365)](https://packagist.org/packages/zing/laravel-scout-opensearch)

> **Requires [PHP 8.0+](https://php.net/releases/)**

Require Laravel Scout OpenSearch using [Composer](https://getcomposer.org):

```
composer require zing/laravel-scout-opensearch
```

Configuration
-------------

[](#configuration)

```
return [
    // ...
    'opensearch' => [
        'hosts' => [env('OPENSEARCH_HOST', 'localhost:9200')],
        'basicAuthentication' => [env('OPENSEARCH_USERNAME', 'admin'), env('OPENSEARCH_PASSWORD', 'admin')],
        'retries' => env('OPENSEARCH_RETRYS', 2),
    ],
];
```

Set app name and table name for model

```
class SearchableModel extends Model
{
    use Searchable;

    public function searchableAs(): string
    {
        return 'searchable_models_index';
    }

    /**
     * @return array{id: mixed}
     */
    public function toSearchableArray(): array
    {
        return [
            'id' => $this->getScoutKey(),
        ];
    }
}
```

### Configuration for Amazon OpenSearch Service

[](#configuration-for-amazon-opensearch-service)

```
return [
    // ...
    'opensearch' => [
        'hosts' => [env('OPENSEARCH_HOST', 'localhost:9200')],
        'basicAuthentication' => [env('OPENSEARCH_USERNAME', 'admin'), env('OPENSEARCH_PASSWORD', 'admin')],
        'retries' => env('OPENSEARCH_RETRYS', 2),
        'sigV4Region' => env('OPENSEARCH_REGION', 'us-east-1') ,
        'sigV4Service' => env('OPENSEARCH_SERVICE', 'es') ,
        'sigV4CredentialProvider' => [
            'key' => env('OPENSEARCH_IAM_KEY'),
            'secret' => env('OPENSEARCH_IAM_SECRET'),
        ],
    ],
];
```

### Debug and logging

[](#debug-and-logging)

```
return [
    // ...
    'opensearch' => [
        'hosts' => [env('OPENSEARCH_HOST', 'localhost:9200')],
        'basicAuthentication' => [env('OPENSEARCH_USERNAME', 'admin'), env('OPENSEARCH_PASSWORD', 'admin')],
        'retries' => env('OPENSEARCH_RETRYS', 2),
        'logger' => (new \Monolog\Logger('opensearch'))->pushHandler(new \Monolog\Handler\RotatingFileHandler('opensearch.log')),
        'tracer' => (new \Monolog\Logger('opensearch'))->pushHandler(new \Monolog\Handler\RotatingFileHandler('opensearch.log')),
    ],
];
```

License
-------

[](#license)

Laravel Scout OpenSearch is an open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

59

—

FairBetter than 99% of packages

Maintenance88

Actively maintained with recent releases

Popularity49

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 59.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~73 days

Recently: every ~102 days

Total

24

Last Release

52d ago

Major Versions

0.1.0 → 1.0.02021-08-16

1.x-dev → 2.0.02022-12-09

2.x-dev → 3.0.02023-06-01

PHP version history (2 changes)0.0.1PHP ^7.2 || ^8.0

2.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/5fafa5bffa28dcd722432b244bf3f0bfe773406df29fea295847e2397b95d50b?d=identicon)[zingimmick](/maintainers/zingimmick)

---

Top Contributors

[![zingimmick](https://avatars.githubusercontent.com/u/26657141?v=4)](https://github.com/zingimmick "zingimmick (102 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (63 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")

---

Tags

laravelopensearchscoutsearchlaravelopensearchscout

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

### Embed Badge

![Health badge](/badges/zing-laravel-scout-opensearch/health.svg)

```
[![Health](https://phpackages.com/badges/zing-laravel-scout-opensearch/health.svg)](https://phpackages.com/packages/zing-laravel-scout-opensearch)
```

###  Alternatives

[teamtnt/laravel-scout-tntsearch-driver

Driver for Laravel Scout search package based on https://github.com/teamtnt/tntsearch

1.1k2.5M28](/packages/teamtnt-laravel-scout-tntsearch-driver)[algolia/scout-extended

Scout Extended extends Laravel Scout adding algolia-specific features

4186.3M6](/packages/algolia-scout-extended)[jeroen-g/explorer

Next-gen Elasticsearch driver for Laravel Scout.

397612.3k](/packages/jeroen-g-explorer)[cloudmediasolutions/laravel-scout-opensearch

OpenSearch engine for Laravel Scout

1824.4k](/packages/cloudmediasolutions-laravel-scout-opensearch)[romangrinev/laravel-opensearch-engine

Custom Laravel Scout OpenSearch Engine

1319.8k](/packages/romangrinev-laravel-opensearch-engine)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
