PHPackages                             ashkan-jafarzadeh/elastic-migrations - 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 & Filtering](/categories/search)
4. /
5. ashkan-jafarzadeh/elastic-migrations

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

ashkan-jafarzadeh/elastic-migrations
====================================

Elasticsearch migrations for Laravel

v1.0.0(3y ago)03601MITPHP ^7.3 || ^8.0

Since Jul 28Pushed 3y agoCompare

[ Source](https://github.com/ashkan-jafarzadeh/elastic-migrations)[ Packagist](https://packagist.org/packages/ashkan-jafarzadeh/elastic-migrations)[ Fund](https://ko-fi.com/ivanbabenko)[ Fund](https://paypal.me/babenkoi)[ RSS](/packages/ashkan-jafarzadeh-elastic-migrations/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

Elastic Migrations
==================

[](#elastic-migrations)

[![Latest Stable Version](https://camo.githubusercontent.com/bbc5665c2dbb4ac1ca14df69f932c564af70de6c351ca4e53b49e7c775481ff5/68747470733a2f2f706f7365722e707567782e6f72672f626162656e6b6f6976616e2f656c61737469632d6d6967726174696f6e732f762f737461626c65)](https://packagist.org/packages/babenkoivan/elastic-migrations)[![Total Downloads](https://camo.githubusercontent.com/d4bdd5059ee37ff0fcbfefbf9e0ef164212ed28a75f637f94e641ca7dea5250a/68747470733a2f2f706f7365722e707567782e6f72672f626162656e6b6f6976616e2f656c61737469632d6d6967726174696f6e732f646f776e6c6f616473)](https://packagist.org/packages/babenkoivan/elastic-migrations)[![License](https://camo.githubusercontent.com/53a3fc344d478a37bc06195bb3f2377cc6633ba8280b246e9ae20c1130a90dfa/68747470733a2f2f706f7365722e707567782e6f72672f626162656e6b6f6976616e2f656c61737469632d6d6967726174696f6e732f6c6963656e7365)](https://packagist.org/packages/babenkoivan/elastic-migrations)[![Tests](https://github.com/babenkoivan/elastic-migrations/workflows/Tests/badge.svg)](https://github.com/babenkoivan/elastic-migrations/actions?query=workflow%3ATests)[![Code style](https://github.com/babenkoivan/elastic-migrations/workflows/Code%20style/badge.svg)](https://github.com/babenkoivan/elastic-migrations/actions?query=workflow%3A%22Code+style%22)[![Static analysis](https://github.com/babenkoivan/elastic-migrations/workflows/Static%20analysis/badge.svg)](https://github.com/babenkoivan/elastic-migrations/actions?query=workflow%3A%22Static+analysis%22)[![Donate PayPal](https://camo.githubusercontent.com/0b8a275d67dfb2aa74ac299fa07b7fce95217f6620448d88cf05ff9e3653e9bf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d70617970616c2d626c7565)](https://paypal.me/babenkoi)

 [![Support the project!](https://camo.githubusercontent.com/201ef269611db7eb6b5d08e9f756ab8980df3014b64492770bdf13a6ed924641/68747470733a2f2f6b6f2d66692e636f6d2f696d672f676974687562627574746f6e5f736d2e737667)](https://ko-fi.com/ivanbabenko)

---

Elastic Migrations for Laravel allow you to easily modify and share indices schema across the application's environments.

Contents
--------

[](#contents)

- [Compatibility](#compatibility)
- [Installation](#installation)
- [Configuration](#configuration)
- [Writing Migrations](#writing-migrations)
- [Running Migrations](#running-migrations)
- [Reverting Migrations](#reverting-migrations)
- [Starting Over](#starting-over)
- [Migration Status](#migration-status)
- [Zero Downtime Migration](#zero-downtime-migration)
- [Troubleshooting](#migration-status)

Compatibility
-------------

[](#compatibility)

The current version of Elastic Migrations has been tested with the following configuration:

- PHP 7.3-8.0
- Elasticsearch 7.x
- Laravel 6.x-8.x

Installation
------------

[](#installation)

The library can be installed via Composer:

```
composer require babenkoivan/elastic-migrations
```

If you want to use Elastic Migrations with [Lumen framework](https://lumen.laravel.com/) check [this guide](https://github.com/babenkoivan/elastic-migrations/wiki/Lumen-Installation).

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

[](#configuration)

Elastic Migrations uses [babenkoivan/elastic-client](https://github.com/babenkoivan/elastic-client) as a dependency. If you want to change the default client settings (and I'm pretty sure you do), then you need to create the configuration file first:

```
php artisan vendor:publish --provider="ElasticClient\ServiceProvider"
```

You can change Elasticsearch host and other client settings in the `config/elastic.client.php` file. Please refer to [babenkoivan/elastic-client](https://github.com/babenkoivan/elastic-client) for more details.

You can also publish Elastic Migrations settings:

```
php artisan vendor:publish --provider="ElasticMigrations\ServiceProvider"
```

This will create the `config/elastic.migrations.php` file, which allows you to configure the following options:

- `table` - the migration table name
- `connection` - the database connection
- `storage_directory` - the migrations directory
- `index_name_prefix` - the indices prefix
- `alias_name_prefix` - the aliases prefix

Finally, don't forget to run Laravel database migrations to create Elastic Migrations table:

```
php artisan migrate
```

Writing Migrations
------------------

[](#writing-migrations)

You can effortlessly create a new migration file using an Artisan console command:

```
php artisan elastic:make:migration create_my_index
```

This command creates a migration class in the `elastic/migrations` directory.

Every migration includes two methods: `up` and `down`. `up` is used to alternate the index schema and `down` is used to revert that action.

You can use `ElasticMigrations\Facades\Index` facade to perform basic operations over Elasticsearch indices:

#### Create Index

[](#create-index)

You can create an index with the default settings:

```
Index::create('my-index');
```

You can use a modifier to configure mapping and settings:

```
Index::create('my-index', function (Mapping $mapping, Settings $settings) {
    // to add a new field to the mapping use method name as a field type (in Camel Case),
    // first argument as a field name and optional second argument for additional field parameters
    $mapping->text('title', ['boost' => 2]);
    $mapping->float('price');

    // you can define a dynamic template as follows
    $mapping->dynamicTemplate('my_template_name', [
        'match_mapping_type' => 'long',
        'mapping' => [
            'type' => 'integer',
        ],
    ]);

    // you can also change the index settings and the analysis configuration
    $settings->index([
         'number_of_replicas' => 2,
         'refresh_interval' => -1
    ]);

    $settings->analysis([
        'analyzer' => [
            'title' => [
                'type' => 'custom',
                'tokenizer' => 'whitespace'
            ]
        ]
    ]);
});
```

There is also the `createRaw` method in your disposal:

```
$mapping = [
    'properties' => [
        'title' => [
            'type' => 'text'
        ]
    ]
];

$settings = [
    'number_of_replicas' => 2
];

Index::createRaw('my-index', $mapping, $settings);
```

Finally, it is possible to create an index only if it doesn't exist:

```
// you can use a modifier as shown above
Index::createIfNotExists('my-index', $modifier);
// or you can use raw mapping and settings
Index::createIfNotExistsRaw('my-index', $mapping, $settings);
```

#### Update Mapping

[](#update-mapping)

You can use a modifier to adjust the mapping:

```
Index::putMapping('my-index', function (Mapping $mapping) {
    $mapping->text('title', ['boost' => 2]);
    $mapping->float('price');
});
```

Alternatively, you can use the `putMappingRaw` method as follows:

```
Index::putMappingRaw('my-index', [
    'properties' => [
        'title' => [
            'type' => 'text',
            'boost' => 2
        ],
        'price' => [
            'price' => 'float'
        ]
    ]
]);
```

#### Update Settings

[](#update-settings)

You can use a modifier to change an index configuration:

```
Index::putSettings('my-index', function (Settings $settings) {
    $settings->index([
         'number_of_replicas' => 2,
         'refresh_interval' => -1
    ]);
});
```

The same result can be achieved with the `putSettingsRaw` method:

```
Index::putSettingsRaw('my-index', [
    'index' => [
        'number_of_replicas' => 2,
        'refresh_interval' => -1
    ]
]);
```

It is possible to update analysis settings only on closed indices. The `pushSettings` method closes the index, updates the configuration and opens the index again:

```
Index::pushSettings('my-index', function (Settings $settings) {
    $settings->analysis([
        'analyzer' => [
            'title' => [
                'type' => 'custom',
                'tokenizer' => 'whitespace'
            ]
        ]
    ]);
});
```

The same can be done with the `pushSettingsRaw` method:

```
Index::pushSettingsRaw('my-index', [
    'analysis' => [
        'analyzer' => [
            'title' => [
                'type' => 'custom',
                'tokenizer' => 'whitespace'
            ]
        ]
    ]
]);
```

#### Drop Index

[](#drop-index)

You can unconditionally delete the index:

```
Index::drop('my-index');
```

or delete it only if it exists:

```
Index::dropIfExists('my-index');
```

#### Create Alias

[](#create-alias)

You can create an alias with optional filter query:

```
Index::putAlias('my-index', 'my-alias', ['term' => ['user_id' => 1]]);
```

#### Delete Alias

[](#delete-alias)

You can delete an alias by its name:

```
Index::deleteAlias('my-index', 'my-alias');
```

#### More

[](#more)

Finally, you are free to inject `Elasticsearch\Client` in the migration constructor and execute any supported by client actions.

Running Migrations
------------------

[](#running-migrations)

You can either run all migrations:

```
php artisan elastic:migrate
```

or run a specific one:

```
php artisan elastic:migrate 2018_12_01_081000_create_my_index
```

Use the `--force` option if you want to execute migrations on production environment:

```
php artisan elastic:migrate --force
```

Reverting Migrations
--------------------

[](#reverting-migrations)

You can either revert the last executed migrations:

```
php artisan elastic:migrate:rollback
```

or rollback a specific one:

```
php artisan elastic:migrate:rollback 2018_12_01_081000_create_my_index
```

Use the `elastic:migrate:reset` command if you want to revert all previously migrated files:

```
php artisan elastic:migrate:reset
```

Starting Over
-------------

[](#starting-over)

Sometimes you just want to start over, rollback all the changes and apply them again:

```
php artisan elastic:migrate:refresh
```

Alternatively you can also drop all existing indices and rerun the migrations:

```
php artisan elastic:migrate:fresh
```

Migration Status
----------------

[](#migration-status)

You can always check which files have been already migrated and what can be reverted by the `elastic:migrate:rollback` command (the last batch):

```
php artisan elastic:migrate:status
```

Zero Downtime Migration
-----------------------

[](#zero-downtime-migration)

Changing an index mapping with zero downtime is not a trivial process and might vary from one project to another. Elastic Migrations library doesn't include such feature out of the box, but you can implement it in your project by [following this guide](https://github.com/babenkoivan/elastic-migrations/wiki/Changing-Mapping-with-Zero-Downtime).

Troubleshooting
---------------

[](#troubleshooting)

If you see one of the messages below, follow the instructions:

- `Migration table is not yet created` - run the `php artisan migrate` command
- `Migration directory is not yet created` - create a migration file using the `elastic:make:migration` command or create `migrations` directory manually

In case one of the commands doesn't work as expected, try to publish configuration:

```
php artisan vendor:publish --provider="ElasticMigrations\ServiceProvider"
```

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.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

Unknown

Total

1

Last Release

1254d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/76c4f069fc97b778767fe42c4e47ae1abcd4f44014ee9d0a058bd12f1c3538ed?d=identicon)[ashkan.jafarzade](/maintainers/ashkan.jafarzade)

---

Top Contributors

[![babenkoivan](https://avatars.githubusercontent.com/u/25812954?v=4)](https://github.com/babenkoivan "babenkoivan (83 commits)")[![stevebauman](https://avatars.githubusercontent.com/u/6421846?v=4)](https://github.com/stevebauman "stevebauman (17 commits)")[![ashkan-shakewell](https://avatars.githubusercontent.com/u/153510576?v=4)](https://github.com/ashkan-shakewell "ashkan-shakewell (1 commits)")

---

Tags

phplaravelelasticsearchmigrationselastic

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ashkan-jafarzadeh-elastic-migrations/health.svg)

```
[![Health](https://phpackages.com/badges/ashkan-jafarzadeh-elastic-migrations/health.svg)](https://phpackages.com/packages/ashkan-jafarzadeh-elastic-migrations)
```

###  Alternatives

[babenkoivan/elastic-migrations

Elasticsearch migrations for Laravel

1962.5M6](/packages/babenkoivan-elastic-migrations)[babenkoivan/elastic-scout-driver

Elasticsearch driver for Laravel Scout

2773.8M5](/packages/babenkoivan-elastic-scout-driver)[babenkoivan/elastic-scout-driver-plus

Extension for Elastic Scout Driver

2862.8M1](/packages/babenkoivan-elastic-scout-driver-plus)[babenkoivan/elastic-client

The official PHP Elasticsearch client integrated with Laravel

544.0M6](/packages/babenkoivan-elastic-client)[babenkoivan/elastic-adapter

Adapter for official PHP Elasticsearch client

404.0M9](/packages/babenkoivan-elastic-adapter)

PHPackages © 2026

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