sspat/es-query-sanitizer

Simple helper class to sanitize ElasticSearch reserved characters from query strings

Simple helper class to sanitize ElasticSearch reserved characters from query strings

Inspired by node-elasticsearch-sanitize, _(*1)

, _(*2)

Features

Accepts an arbitrary string as input and escapes the ElasticSearch reserved characters:, _(*3)

+ - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ / AND OR NOT space, _(*4)

Returns a sanitized string which can be safely used in an ElasticSearch query_string query., _(*5)

Installation

The preferred way to install this extension is through composer., _(*6)

Either run, _(*7)

composer require sspat/es-query-sanitizer

or add, _(*8)

"sspat/es-query-sanitizer": "~1.0"

to the require section of your composer.json file., _(*9)

Usage

To use pass in a string:, _(*10)

$unescapedQueryString = 'AND there! are? (lots of) char*cters 2 ^escape!'
$escapedQueryString = \sspat\ESQuerySanitizer\Sanitizer::escape($unescapedQueryString);

echo $escapedQueryString; // \A\N\D\ there\!\ are\?\ \(lots\ of\)\ char\*cters\ 2\ \^escape\!

You can also pass an array as the second argument, if you want to prevent some characters from being escaped:, _(*11)

$unescapedQueryString = 'AND there! are? (lots of) char*cters 2 ^escape!'
$excludeCharacters = ['!', '^'];
$escapedQueryString = \sspat\ESQuerySanitizer\Sanitizer::escape($unescapedQueryString, $excludeCharacters);

echo $escapedQueryString; // \A\N\D\ there!\ are\?\ \(lots\ of\)\ char\*cters\ 2\ ^escape!