https://github.com/hectorqin/elasticsearch-xpack
elasticsearch-xpack
https://github.com/hectorqin/elasticsearch-xpack
Last synced: about 2 months ago
JSON representation
elasticsearch-xpack
- Host: GitHub
- URL: https://github.com/hectorqin/elasticsearch-xpack
- Owner: hectorqin
- License: other
- Created: 2019-11-09T02:58:47.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-11-09T03:43:10.000Z (over 5 years ago)
- Last Synced: 2025-02-09T07:26:25.607Z (4 months ago)
- Language: PHP
- Size: 47.9 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
elasticsearch-x-pack-php
=================
This repository contains the official X-Pack namespace module for Elasticsearch-PHP. It is an optional module which
adds new APIs to the client if you are using X-Pack (Watcher, Monitoring, Graph, License, Security).
Version Matrix
--------------
| Elasticsearch-php Version | Elasticsearch-X-Pack-PHP Branch |
| --------------------- | ------------------------ |
| 5.0 | 5.0 |
Installation
------------
This module is a set of additional API endpoints that can be accessed by the Elasticsearch-PHP client. It is not a
standalone client, so make sure you have the `elasticsearch/elasticsearch` client in your `composer.json`. Then simply
add the xpack module:
```json
{
"require": {
"elasticsearch/elasticsearch": "~5.0",
"elasticsearch/xpack" : "~5.0"
}
}
```
Then update your installation:
```bash
php composer.phar update
```
Using XPack
-----
Now that the XPack namspace is installed, we can inject individual XPack plugins that you are interested in using.
For example, we can inject just the Watcher namespace:
```php
use Elasticsearch\ClientBuilder;
use XPack\XPack;
$client = ClientBuilder::create()
->registerNamespace(XPack::Watcher()) // Inject the Watcher namespace
->build();
```
If you want to use multiple XPack plugins, chain together more `registerNamespace()` calls:
```php
use Elasticsearch\ClientBuilder;
use XPack\XPack;
$client = ClientBuilder::create()
->registerNamespace(XPack::Watcher()) // Inject the Watcher namespace
->registerNamespace(XPack::Security()) // Inject the Security namespace
->registerNamespace(XPack::Monitoring()) // Inject the Monitoring namespace
->build();
```
After the client has been initialized, you can invoke the registered namespaces via their name. For example,
here we use the `watcher()` namespace (just like any other namespace that ships with the ES-PHP client):
```php
// Get watcher information
$watcherInfo = $client->watcher()->info();
// Get watcher stats
$watcherStats = $client->watcher()->stats();
// Add a new watch
$body = '{
"trigger": {
"schedule": {
"hourly": {
"minute": [ 0, 5 ]
}
}
},
"input": {
"simple": {
"payload": {
"send": "yes"
}
}
},
"condition": {
"always": {}
},
"actions": {
"test_index": {
"index": {
"index": "test",
"doc_type": "test2"
}
}
}
}'
$params = [
'id' => 'my_watch_id',
'body' => $body
];
$response = $client->watcher()->putWatch($params);
```
Available Namespaces
------------
This module contains the following namespaces:
- Graph
- License
- Monitoring
- Security
- Watcher
Available Licenses
-------
Elasticsearch-X-Pack-PHP is available under two licenses: Apache v2.0 and LGPL v2.1.
The user may choose which license they wish to use. Since there is no discriminating executable or distribution bundle
to differentiate licensing, the user should document their license choice externally, in case the library is re-distributed.
If no explicit choice is made, assumption is that redistribution obeys rules of both licenses.
### Contributions
All contributions to the library are to be so that they can be licensed under both licenses.
Apache v2.0 License:
>Copyright 2013-2016 Elasticsearch
>
>Licensed under the Apache License, Version 2.0 (the "License");
>you may not use this file except in compliance with the License.
>You may obtain a copy of the License at
>
> http://www.apache.org/licenses/LICENSE-2.0
>
>Unless required by applicable law or agreed to in writing, software
>distributed under the License is distributed on an "AS IS" BASIS,
>WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
>See the License for the specific language governing permissions and
>limitations under the License.
LGPL v2.1 Notice:
>Copyright (C) 2013-2016 Elasticsearch
>
>This library is free software; you can redistribute it and/or
>modify it under the terms of the GNU Lesser General Public
>License as published by the Free Software Foundation; either
>version 2.1 of the License, or (at your option) any later version.
>
>This library is distributed in the hope that it will be useful,
>but WITHOUT ANY WARRANTY; without even the implied warranty of
>MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
>Lesser General Public License for more details.
>
>You should have received a copy of the GNU Lesser General Public
>License along with this library; if not, write to the Free Software
>Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA