pandawa/scout-algolia

Custom Algolia engine for Laravel Scout with configurable proxy URL. Supports both algolia/algoliasearch-client-php v3 (scout-extended) and v4.

dev-master / 1.x-dev 2026-03-25 07:59 UTC

Requires

• php: ^8.0 || ^8.1
• algolia/algoliasearch-client-php: ^3.3 || ^4.0
• illuminate/support: ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0
• laravel/scout: ^9.0 || ^10.0 || ^11.0

Suggests

• algolia/scout-extended: For advanced Algolia features (aggregators, settings sync, zero-downtime reimport)

MIT

README

Custom Algolia engine for Laravel Scout with configurable base URL.

Installation

composer require pandawa/scout-algolia

The package uses Laravel's auto-discovery, no manual provider registration needed.

Configuration

Add url to the algolia array in config/scout.php:

'algolia' => [
    'id' => env('ALGOLIA_APP_ID', ''),
    'secret' => env('ALGOLIA_SECRET', ''),
    'url' => env('ALGOLIA_URL'),
],

Then set the environment variable:

ALGOLIA_URL=http://your-host:9501

When ALGOLIA_URL is not set, Scout's default Algolia behavior is used unchanged.

Requirements

• PHP >= 8.2
• Laravel >= 11.0
• Laravel Scout >= 10.0
• Algolia PHP client >= 4.0