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(5mo ago)36482.1k↓31.1%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 2w ago

READMEChangelog (10)Dependencies (16)Versions (28)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

58

—

FairBetter than 98% of packages

Maintenance82

Actively maintained with recent releases

Popularity50

Moderate usage in the ecosystem

Community15

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 58.2% 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 ~77 days

Recently: every ~128 days

Total

24

Last Release

41d 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 (103 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (67 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")[![gdebrauwer](https://avatars.githubusercontent.com/u/22586858?v=4)](https://github.com/gdebrauwer "gdebrauwer (1 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

[jeroen-g/explorer

Next-gen Elasticsearch driver for Laravel Scout.

399693.0k](/packages/jeroen-g-explorer)[teamtnt/laravel-scout-tntsearch-driver

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

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

Scout Extended extends Laravel Scout adding algolia-specific features

4186.9M6](/packages/algolia-scout-extended)[matchish/laravel-scout-elasticsearch

Search among multiple models with ElasticSearch and Laravel Scout

7431.7M3](/packages/matchish-laravel-scout-elasticsearch)[cloudmediasolutions/laravel-scout-opensearch

OpenSearch engine for Laravel Scout

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

Custom Laravel Scout OpenSearch Engine

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

PHPackages © 2026

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