cbMeilisearch

An API wrapper for Meilisearch written in CFML for the ColdBox platform.

Installation

1. Install via CommandBox - box install cbmeilisearch
2. Start a Meilisearch instance
3. Configure cbMeilisearch
   1. via environment variables
   2. via Coldbox.cfc's ModuleSettings
4. Get the Client model: getInstance( "Client@cbmeilisearch" )
5. Make API calls: msClient.createIndex( "movies" )

Starting Meilisearch

From the Meilisearch Quickstart guide:

# Fetch the latest version of Meilisearch image from DockerHub
docker pull getmeili/meilisearch:v0.28

# Launch Meilisearch in development mode with a master key
docker run --detach --rm \
    -p 7700:7700 \
    -e MEILI_MASTER_KEY='mySecretKey'\
    -v $(pwd)/meili_data:/meili_data \
    getmeili/meilisearch:v0.28 \
    meilisearch \
    --env="development"

Configuration via Environment Variables

CBMeilisearch will try to pull Meilisearch connection settings from the environment variables by default. You can take advantage of this by creating a .env file in the root of your ColdBox app and using commandbox-dotenv or a similar tool to load the .env file into your application on startup.

# .env
MEILISEARCH_HOST=http://127.0.0.1
MEILISEARCH_PORT=7700
MEILISEARCH_MASTER_KEY=mySecretKey

Configuration via Coldbox's ModuleSettings

Use the following example configuration to get started configuring cbMeilisearch.

For obvious reasons, the host/port must point to a running Meilisearch instance, and the MEILISEARCH_MASTER_KEY must be the configured master key you set when starting Meilisearch.

// config/Coldbox.cfc
component{
  function configure(){
    moduleSettings = {
      "cbmeilisearch" : {
        "MEILISEARCH_HOST" : "localhost",
        "MEILISEARCH_PORT" : 7700,
        "MEILISEARCH_MASTER_KEY" : "mySecretKey"
      }
    }
  }
}

Usage

This library follows the Meilisearch API reference as closely as possible.

🤖 Meilisearch Version Compatibility

This package only guarantees compatibility with version v0.28.0 of Meilisearch.

TODO

• ✅ Drop additional params as first-class arguments - too much work. Accept a struct and pass it through to the JSON body or URL.
• ✅ Refactor API to match PHP SDK
• ✅ Return HyperResponse object, don't try to parse it without asking.
• Finalize API documentation
  • Add Getting Started section to README
  • Add argument docs for each API method
• Add Multitenancy support
  • Add Tenant Token generation utility
• Move to coldbox-modules organization
• Add callback support for asynchronous task completion

License

Apache License, Version 2.0.

The ColdBox Websites, logo and content have a separate license and they are a separate entity.

The Good News

For all have sinned, and come short of the glory of God (Romans 3:23)

But God commendeth his love toward us, in that, while we were yet sinners, Christ died for us. (Romans 5:8)

That if thou shalt confess with thy mouth the Lord Jesus, and shalt believe in thine heart that God hath raised him from the dead, thou shalt be saved. (Romans 10:9)

Repository

Copyright 2022 (and on) - Ortus Solutions

• Homepage
• Issue Tracker
• New BSD License