thiagoprz/vegvisir

Vegvisir - Laravel Search Indexer

Maintainers

Details

github.com/thiagoprz/vegvisir

Source

Issues

Installs: 2

Dependents: 1

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 0

Open Issues: 0

dev-main 2022-05-05 19:02 UTC

Requires

Requires (Dev)

MIT cd54c100a25a9f36545e3f24548f06bde42a69d6

This package is auto-updated.

Last update: 2024-11-06 00:11:02 UTC

README

PHPUnit

Table of contents

Installation

Install it using composer on your application: composer require thiagoprz/vegvisir

Configuration

Install chosen AdapterServiceProvider (see adapters for more information) service provider to config/app.php:

..
'providers' => [
...
    \Thiagoprz\Vegvisir\VegvisirElasticSearchServiceProvider::class,
],
...

Publish configuration by running php artisan vendor:publish and typing the number for your desired adapter (if using multiple adapters there's no need for running more than once, just choose one of them).

This will add the vegvisir.php file to the config directory. Bear in mind that this configuration contains directives for all adapters inside your application, those you don't need multiple configurations files for each adapter you use in case your application will be using more than one.

Available Adapters

This package comes with built-in Adapters that can be easily use without any customization depending on your needs, of course you can and are encouraged to build your own Adapter to fill any specification or if you are using a different platform that the ones listed here.

Elasticsearch

This adapter connects to Elasticsearch host(s) and will insert/update/delete everytime changes happen to your model.

Follow the instructions in the adapter repository.

MongoDB

Status: Under Development

This adapter connects to MongoDB and will insert/update/delete everytime changes happen to your model.

Follow the instructions in the adapter repository.

Create You Own Adapter

The main idea behind this project is to allow enhancing Laravel applications by using different databases from the main one (usually MySQL) as the entry point for search requests, those providing a better preformance and avoiding performance issues for large operations on the database. Based on this idea this repository will be useful for anyone who wants to implement their own search tool inside laravel application, it's really straight forward to create an adapter by following this steps.

Adapter Package Structure

  • src/
    • Adapters/
      • CustomAdapter.php
    • config/
      • vegvisir.php
    • Repositories/
      • CustomRepository.php
    • CustomServiceProvider.php

Roadmap

  • Implement as mush sustainable as possible the most diverse numbers of adapters for enhancing Laravel Application

ยน Engine version means the version of the software used to build the package, there is a possibility that depending on the changes (specially breaking changes) made on the Third Party this package may not be stable or not work as expected.

Contributing

Testing

vendor/phpunit/phpunit/phpunit --configuration phpunit.xml tests

Support

Issues

Please feel free to create issues on this package, it will help a lot. I will address it as soon as possible.

License

This package is licensed under the MIT license.